1.自定义标签简介
自定义标签主要用于移除Jsp页面中的java代码
使用自定义标签移除jsp页面中的java代码,只需要完成以下
两个步骤:
1.编写一个实现Tag接口的Java类(标签处理器类)
2.在WEB-INF中编写标签库描述符(tld)文件,在tld文件中对标签处理器类描述成一个标签
(参考
tomcat
中的
examples
项目中
jsp
部分)
2.自定义标签的执行流程的分析
JSP引擎将遇到自定义标签时,首先创建标签处理器类的实例对象,然后按照JSP规范定义的通信规则依次调用它的方法。
1、public void setPageContext(PageContext pc),JSP引擎实例化标签处理器后,将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器,标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。
2、public void setParent(Tag t),setPageContext方法执行完后,WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器,如果当前标签没有父标签,则传递给setParent方法的参数值为null。
3、public int doStartTag(),调用了setPageContext方法和setParent方法之后,WEB容器执行到自定义标签的开始标记时,就会调用标签处理器的doStartTag方法。
4、public int doEndTag(),WEB容器执行完自定义标签的标签体后,就会接着去执行自定义标签的结束标记,此时,WEB容器会去调用标签处理器的doEndTag方法。
5、public void release(),通常WEB容器执行完自定义标签后,标签处理器会驻留在内存中,为其它请求服务器,直至停止web应用时,web容器才会调用release方法。
3.自定义标签体可以实现的功能
开发人员在编写Jsp页面时,经常还需要在页面中引入一些逻辑,例如:
控制jsp页面某一部分内容是否执行。
控制整个jsp页面是否执行。
控制jsp页面内容重复执行。
修改jsp页面内容输出。
自定义标签除了可以移除jsp页面java代码外,它也可以实现以上功能。
4.tld文件中的四种标签体类型
EMPTY
表示标签没有标签体
JSP
表示标签体可以包含JSP代码
scriptless
表示标签体可以包含EL表达式和JSP的动作元素,但不能包含脚本表达式
tagdepentend
表示标签体由标签本身去解析处理。若指定tagdependent,那么在标签体中所写的代码将作为纯文本原封不动地传给标签处理类, 而不是将执行结果传给标签处理类
5.案例示例
(1)控制标签体内容是否执行
doStartTag
EVAL_BODY_INCLUDE 执行标签内容
SKIP_BODY 跳过标签内容
Tld配置
<tag>
<name>demo1</name>
<tag-class>mytag.MyTag1</tag-class>
<body-content>JSP</body-content>
</tag>
public class Demo1 extends TagSupport {
// 如何控制是否执行
// EVAL_BODY_INCLUDE 想执行标签体
// SKIP_BODY 不想执行标签体
@Override
public int doStartTag() throws JspException {
// TODO Auto-generated method stub
return SKIP_BODY;
}
(2)控制标签后的jsp页面是否执行
doEndTag
EVAL_PAGE 执行标签后的页面内容
SKIP_PAGE 跳过标签后的页面内容
Tld配置
<tag>
<name>demo2</name>
<tag-class>mytag.MyTag2</tag-class>
<body-content>empty</body-content>