8.1 自定义标签应用形式
8.1.1.1 空标签
<tag:example/>
8.1.1.2 带体的标签
1、 内容为普通文本
<tag:example>tagcontent</tag:example>
2、 内容为JSP脚本片段
<tag:example>
<%String s= "content";out.print(s);%>
</tag:example>
3、 内容为JSP脚本表达式
<tag:example><%=value%></tag:example>
4、 内容为EL表达式
<tag:example>$(value)</tag:example>
8.1.1.3 嵌套标签
<tag:example><tag:example2>tagcontent</tag:example2></tag:example>
8.1.1.4 带属性标签
<tag:example attribute1="" attribute2="">
body</tag:example>
8.2 自定义标签简单应用
public class ViewIPTag extends TagSupport {
public int doStartTag() throws JspException {
String ip = pageContext.getRequest().getRemoteAddr();
try {
pageContext.getOut().write(ip);
} catch (Exception e) {
e.printStackTrace();
}
return super.doStartTag();
}}
创建XXX.tld标签文件
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> <taglib> <jsp-version>1.0</jsp-version> <tlib-version>1.0</tlib-version> <short-name>wangtongtaglib</short-name> <uri>/wangtongtaglib</uri> <tag> <name>viewip</name> <tag-class>tag.ViewIPTag</tag-class> <body-content>empty</body-content> </tag> </taglib>
JSP文件中标签的使用:
<wangtong:viewip />
JSP引擎调用标签处理器的基本原理
1、 Web容器执行自定义标签开始标记时,会调用标签处理器的doStartTag()。可以通过该方法返回的不同的值来控制后续的行为:
是否执行标签体中的内容。
是直接输出标签体的执行结果,还是将标签体的执行结果输出到一个缓冲区对象中,从而可以让后续的时间方法对标签体的执行结果进行修改和控制其输出。
2、 Web容器执行完开始标记后,执行标签体,标签体执行完成后调用doAfterBody()方法。该方法用于标签体执行完后的行为,这个方法可以返回不同的值来控制是否再次重复执行标签体。
3、 Web容器执行完自定义标签体后,会执行自定义标签的结束标记,此时会执行doEndTag()方法。用于处理遇到结束标记这个事件,通过不同的值来控制Web容器是否执行JSP页面中位于结束标记后面的内容。
8.3 自定义标签API
8.3.1 JspTag接口
是所有自定义标签的父接口,Tag接口和SimpeTag是其直接子接口。
8.3.2 Tag接口
Tag接口是传统标签的父接口,定义了两个重要方法
doStartTag()、doEndTag()
;四个常量(EVAL_BODY_INCLUDE、SKIP_BODY、EVAL_PAGE、SKIP_PAGE )。
1、 调用doStartTag()方法执行后向Web容器返回常EVAL_BODY_INCLUDE、SKIP_BODY。返回EVAL_BODY_INCLUDE则执行自定义标签的标签体;返回SKIP_BODY则忽略自定义标签的标签体,直接解释执行自定义标签的结果标记。
2、 调用doEndTag()方法、执行后向Web容器返回常量EVAL_PAGE、SKIP_PAGE。返回EVAL_PAGE则执行JSP页面位于结束标记后面的JSP代码、返回SKIP_PAGE则忽略JSP页面中位于结束标记后面的所有内容,例如<jsp:forward>标签。
8.3.3 IterationTag接口
IterationTag继承Tag接口,并增加了doAfterBody()方法和EVAL_BODY_AGAIN常量。能通知Web容器是否重复执行标签体内容。当调用doAfterBody()方法返回EVAL_BODY_AGAIN时,会重复执行标签,知道返回SKIP_BODY,Web容器才会处理标签的结束标记和调用doEndTag()。
8.3.4 BodyTag接口
BodyTag接口继承自IterationTag接口,增加2个方法setBodyContent()、doInitBody()方法和EVAL_BODY_BUFFERED常量。当doStartTag()方法返回EVAL_BODY_BUFFERED常量时,Web容器会创建专门用于捕获标签体运行结果的BodyContent对象,然后调用标签处理器的setBodyContent()将BodyContent对象传入标签处理器,Web容器将标签体的执行结果写入BodyContent对象中。在标签处理器的后续事件方法中,可以通过保存的BodyContent的对象的引用来获取标签体的执行结果,然后调用BodyContent对象特有的方法对BodyContent对象的内容进行修改和控制。
注:JSP API提供BodyTag接口的实现类BodyTagSupport。BodyTagSupport类实现的BodyTagSupport类的doStartTag方法的返回值为EVAL_BODY_BUFFERED。doAfterBody()返回值为SKIP_BODY,doEndTag()返回值为EVAL_PAGE。
8.3.5 SimpleTag接口
SimpleTag接口为JSP2.0新增标签接口,在SimpleTag中之定义了一个用于处理标签逻辑的doTag()方法,该方法在Web容器执行自定义标签时调用,而且只调用一次即完成传统标签的是否执行标签体、迭代标签等功能。
SimpleTagSupport类是SimpleTag接口的实现类。