jstl自定义标签接口介绍

1. JspTag接口

JspTag接口是全部自定义标签的父接口，它是JSP2.0中新定义的一个标记接口，没有任何属性和方法。JspTag接口有Tag和SimpleTag两个直接子接口，JSP2.0之前的版本中只有Tag接口，因此把实现Tag接口的自定义标签也叫作传统标签，把实现SimpleTag接口的自定义标签叫作简单标签。本书中若是没有特别说明，自定义标签泛指传统标签。

2. Tag接口

图6.5中的Tag接口是全部传统标签的父接口，其中定义了两个重要方法（doStartTag、doEndTag）方法和四个常量（EVAL_BODY_INCLUDE、SKIP_BODY、EVAL_PAGE、SKIP_PAGE），这两个方法和四个常量的做用以下：

（1）WEB容器在解释执行JSP页面的过程当中，遇到自定义标签的开始标记就会去调用标签处理器的doStartTag方法，doStartTag方法执行完后能够向WEB容器返回常量EVAL_BODY_INCLUDE或SKIP_BODY。若是doStartTag方法返回EVAL_BODY_INCLUDE，WEB容器就会接着执行自定义标签的标签体；若是doStartTag方法返回SKIP_BODY，WEB容器就会忽略自定义标签的标签体，直接解释执行自定义标签的结束标记。

（2）WEB容器解释执行到自定义标签的结束标记时，就会调用标签处理器的doEndTag方法，doEndTag方法执行完后能够向WEB容器返回常量EVAL_PAGE或SKIP_PAGE。若是doEndTag方法返回常量EVAL_PAGE，WEB容器就会接着执行JSP页面中位于结束标记后面的JSP代码；若是doEndTag方法返回SKIP_PAGE，WEB容器就会忽略JSP页面中位于结束标记后面的全部内容。

从doStartTag和doEndTag方法的做用和返回值的做用能够看出，开发自定义标签时能够在doStartTag方法和doEndTag方法体内编写合适的Java程序代码来实现具体的功能，经过控制doStartTag方法和doEndTag方法的返回值，还能够告诉WEB容器是否执行自定义标签中的标签体内容和JSP页面中位于自定义标签的结束标记后面的内容。

2. IterationTag接口

IterationTag接口继承了Tag接口，并在Tag接口的基础上增长了一个doAfterBody方法和一个EVAL_BODY_AGAIN常量。实现IterationTag接口的标签除了能够完成Tag接口所能完成的功能外，还能够通知WEB容器是否重复执行标签体内容。对于实现了IterationTag接口的自定义标签，WEB容器在执行完自定义标签的标签体后，将调用标签处理器的doAfterBody方法，doAfterBody方法能够向WEB容器返回常量EVAL_BODY_AGAIN或SKIP_BODY。若是doAfterBody方法返回EVAL_BODY_AGAIN，WEB容器就会把标签体内容再重复执行一次，执行完后接着再调用doAfterBody方法，如此往复，直到doAfterBody方法返回常量SKIP_BODY，WEB容器才会开始处理标签的结束标记和调用doEndTag方法。

可见，开发自定义标签时，能够经过控制doAfterBody方法的返回值来告诉WEB容器是否重复执行标签体内容，从而达到循环处理标签体内容的效果。例如，能够经过一个实现IterationTag接口的标签来迭代输出一个集合中的全部元素，在标签体部分指定元素的输出格式。

在JSP API中也提供了IterationTag接口的默认实现类TagSupport，读者在编写自定义标签的标签处理器类时，能够继承和扩展TagSupport类，这相比实现IterationTag接口将简化开发工做。

3. BodyTag接口

BodyTag接口继承了IterationTag接口，并在IterationTag接口的基础上增长了两个方法（setBodyContent、doInitBody）和一个EVAL_BODY_BUFFERED常量。实现BodyTag接口的标签除了能够完成IterationTag接口所能完成的功能，还能够对标签体内容进行修改。对于实现了BodyTag接口的自定义标签，标签处理器的doStartTag方法不只能够返回前面讲解的常量EVAL_BODY_INCLUDE或SKIP_BODY，还能够返回常量EVAL_BODY_BUFFERED。若是doStartTag方法返回EVAL_BODY_BUFFERED，WEB容器就会建立一个专用于捕获标签体运行结果的BodyContent对象，而后调用标签处理器的setBodyContent方法将BodyContent对象的引用传递给标签处理器，WEB容器接着将标签体的执行结果写入到BodyContent对象中。在标签处理器的后续事件方法中，能够经过先前保存的BodyContent对象的引用来获取标签体的执行结果，而后调用BodyContent对象特有的方法对BodyContent对象中的内容（即标签体的执行结果）进行修改和控制其输出。

在JSP API中也提供了BodyTag接口的实现类BodyTagSupport，读者在编写可以修改标签体内容的自定义标签的标签处理器类时，能够继承和扩展BodyTagSupport类，这相比实现BodyTag接口将简化开发工做。

4. SimpleTag接口

SimpleTag接口是JSP2.0中新增的一个标签接口。因为传统标签使用三个标签接口来完成不一样的功能，显得过于繁琐，不利于标签技术的推广，所以，SUN公司为下降标签技术的学习难度，在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口。SimpleTag接口与传统标签接口最大的区别在于，SimpleTag接口只定义了一个用于处理标签逻辑的doTag方法，该方法在WEB容器执行自定义标签时调用，而且只被调用一次。那些使用传统标签接口所完成的功能，例如是否执行标签体、迭代标签体、对标签体内容进行修改等功能均可以在doTag方法中完成。关于SimpleTag接口的详细介绍本书将在第7章详细讲解。

在JSP API中也提供了SimpleTag接口的实现类SimpleTagSupport，读者在编写简单标签时，能够继承和扩展SimpleTagSupport类，这相比实现SimpleTag接口将简化开发工做。

 

为方便读者往后查询传统标签接口中的各个方法能够返回的返回值，笔者在表6.1列举了Tag接口、IterationTag接口和BodyTag接口中的主要方法及它们分别能够返回的返回值的说明。

表6.1