jsp自定义标签

最新推荐文章于 2020-08-24 17:15:26 发布

whcself

最新推荐文章于 2020-08-24 17:15:26 发布

阅读量691

点赞数

分类专栏： jsp标签 java web jsp

本文链接：https://blog.youkuaiyun.com/weixin_40775755/article/details/81673905

版权

java 同时被 3 个专栏收录

16 篇文章

订阅专栏

web

11 篇文章

订阅专栏

jsp

4 篇文章

订阅专栏

自定义标签继承树:

自定义标签类----->继承SimpleTagSupport------>实现SimpleTag接口

自定义标签开发步骤

1）编写一个普通的java类，继承SimpleTagSupport类，叫标签处理器类

/**
 * 标签处理器类
 * @author APPle
 * 1）继承SimpleTagSupport
 *
 */
public class ShowIpTag extends SimpleTagSupport{
	private JspContext context;
	
	/**
	 * 传入pageContext,在jsp中的_jspService中自动调用
	 */
	@Override
	public void setJspContext(JspContext pc) {
		this.context = pc;}
/**
	 * 2）覆盖doTag方法,同样是自动调用
	 */
	@Override
	public void doTag() throws JspException, IOException {
		//向浏览器输出客户的ip地址
		PageContext pageContext = (PageContext)context;
		
		HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();
	}
}

2)在web项目的WEB-INF目录下建立itcast.tld文件，这个tld叫标签库的声明文件。（参考核心标签库的tld文件）

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
    version="2.1">
  <!-- 标签库的版本 -->
  <tlib-version>1.1</tlib-version>
  <!-- 标签库前缀,在jsp的taglib指令中需要引入 -->
  <short-name>itcast</short-name>
  <!-- tld文件的唯一标记,在jsp的taglib指令中需要引入 -->
  <uri>http://gz.itcast.cn</uri>

  <!-- 一个标签的声明 -->
  <tag>
    <!-- 标签名称 -->
    <name>showIp</name>
    <!-- 标签处理器类的全名 -->
    <tag-class>gz.itcast.a_tag.ShowIpTag</tag-class>
    <!-- 输出标签体内容格式(暂时写上scriptless) -->
    <body-content>scriptless</body-content>
  <attribute>
<name>attributeName</name>

<required>true</required>//该参数是否是必须的

<retexprvalue> false</retexprvalue>//该参数是否支持el表达式
</attribute>

  </tag>

</taglib>

3）在jsp页面的头部导入自定义标签库

<%@taglib uri="http://gz.itcast.cn" prefix="itcast"%>

4）在jsp中使用自定义标签

<itcast:showIp></itcast:showIp>

2 自定义标签的执行过程

问题： http://localhost:8080/tagdemo/01.hellotag.jsp 如何访问到自定义标签？

前提： tomcat服务器启动时，加载到每个web应用，加载每个web应用的WEB-INF目录下的所有文件,例如:web.xml, tld文件

1）访问01.hellotag.jsp资源

2）tomcat服务器把jsp文件翻译成java源文件->编译class->构造类对象->调用_jspService（）方法

3）检查jsp文件的taglib指令，是否存在一个名为http://gz.itcast.cn的tld文件。如果没有，则报错

4）上一步已经读到itcast.tld文件

5）读到<itcast:showIp> 到itcast.tld文件中查询是否存在<name>为showIp的<tag>标签

6）找到对应的<tag>标签，则读到<tag-class>内容

7）得到 gz.itcast.a_tag.ShowIpTag

构造ShowIpTag对象，然后调用ShowIpTag里面的方法(一定会调用setJspContext方法和doTag方法)

如何调用方法?:_jspServic函数中创建一个自定义标签对象,然后这个对象调用函数

在jsp文件翻译成的.java文件的_jspService函数中有这样几行代码

 public void _jspService(HttpServletRequest request, HttpServletResponse response)
        throws java.io.IOException, ServletException {


    PageContext _jspx_page_context = null;

      pageContext = _jspxFactory.getPageContext(this, request, response,
      			null, true, 8192, true);
      _jspx_page_context = pageContext;
    
      if (_jspx_meth_itcast_005fshowIp_005f0(_jspx_page_context))return;

    //可以看出 _jspx_meth_itcast_005fshowIp_005f0(_jspx_page_context)是一个方法
    //而且_jspx_page_context==pageContext == _jspxFactory.getPageContext(this, request, response,null, true, 8192, true);
    //打开 _jspx_meth_itcast_005fshowIp_005f0(_jspx_page_context)方法的源代码

  private boolean _jspx_meth_itcast_005fshowIp_005f0(PageContext _jspx_page_context)
          throws Throwable {
    PageContext pageContext = _jspx_page_context;
    JspWriter out = _jspx_page_context.getOut();
    //  itcast:showIp
    gz.itcast.a_tag.ShowIpTag _jspx_th_itcast_005fshowIp_005f0 = new gz.itcast.a_tag.ShowIpTag();//创建一个自定义Tag的对象
    org.apache.jasper.runtime.AnnotationHelper.postConstruct(_jsp_annotationprocessor, _jspx_th_itcast_005fshowIp_005f0);

    _jspx_th_itcast_005fshowIp_005f0.setJspContext(_jspx_page_context);//一定调用

    _jspx_th_itcast_005fshowIp_005f0.setJspBody(new Helper( 0, _jspx_page_context, _jspx_th_itcast_005fshowIp_005f0, null));
    
_jspx_th_itcast_005fshowIp_005f0.doTag();//一定调用


    org.apache.jasper.runtime.AnnotationHelper.preDestroy(_jsp_annotationprocessor, _jspx_th_itcast_005fshowIp_005f0);
    return false;
  }

3 自定义标签处理器类的生命周期

SimpleTag接口：

void setJspContext(JspContext pc) --设置pageContext对象，传入pageContext（一定调用）

通过getJspCotext()方法得到pageContext对象

void setParent(JspTag parent) --设置父标签对象，传入父标签对象，如果没有父标签，则不调用此方法。通过getParent()方法得到父标签对象。

void setXXX(值) --设置属性值。

void setJspBody(JspFragment jspBody) --设置标签体内容。标签体内容封装到JspFragment对象中，然后传入JspFragment对象。通过getJspBody()方法得到标签体内容。如果没有标签体内容，则不会调用此方法

void doTag() --执行标签时调用的方法。（一定调用）

2.5 自定义标签的作用

1）控制标签体内容是否输出

2）控制标签余下内容是否输出

3）控制重复输出标签体内容

4）改变标签体内容

5）带属性的标签

代码示例:


		/**
		 * 1）控制标签内容是否输出
		 *    输出： 调用jspFrament.invoke();
		 *    不输出： 不调用jspFrament.invoke();
		 */
		//1.1 得到标签体内容
		JspFragment jspBody = this.getJspBody();
		
		/**
		 * 执行invoke方法： 把标签体内容输出到指定的Writer对象中
		 */
		//1.2 往浏览器输出内容，writer为null就是默认往浏览器输出
		//JspWriter out = this.getJspContext().getOut();
		//jspBody.invoke(out);
		jspBody.invoke(null);//等价于上面的代码
		
		/**
		 * 3)控制重复输出标签体内容
		 *     方法： 执行多次jspBody.invoke()方法
		 */
		/*for(int i=1;i<=num;i++){
			jspBody.invoke(null);
		}*/
		
		/**
		 * 4)改变标签体内容
		 */
		//4.1 创建StringWriter临时容器
		/*StringWriter sw = new StringWriter();
		//4.2 把标签体拷贝到临时容器
		jspBody.invoke(sw);
		//4.3 从临时容器中得到标签体内容
		String content = sw.toString();
		//4.4 改变内容
		content = content.toLowerCase();
		//System.out.println(content);
		//4.5 把改变的内容输出到浏览器
		//jspBody.invoke(null); 不能使用此方式输出，因为jsbBody没有改变过
		this.getJspContext().getOut().write(content);*/
		
		
		/**
		 * 2)控制标签余下内容是否输出
		 *   输出: 什么都不干！
		 *   不输出： 抛出SkipPageException异常
		 */
		throw new SkipPageException();

在标签处理器中添加一个成员变量和setter方法

//1.声明属性的成员变量

private Integer num;

//2.关键点：必须提供公开的setter方法，用于给属性赋值

public void setNum(Integer num) {

this.num = num;

}

[注]:例如 <web:login username="张三" password="123456">中的参数都需要在自定义标签中设置成成员变量,并且设置set方法,在_jspService函数中会调用

2.6 输出标签体内容格式( <body-content></body-content>标签)

JSP：在传统标签中使用的。可以写和执行jsp的java代码。

scriptless: 标签体不可以写jsp的java代码

empty: 必须是空标签。