关于JSP自定义标签

1、 JavaEE基础教程 第18章 JSP自定义标签18.1 JSP自定义标签简介18.2 开发自定义JSP标签18.3 编程示例：网上书店返回18.1 JSP自定义标签简介从JSP1.1规范开始，JSP支持在JSP文件中使用自定义标签（JSP CUSTOME TAG LIBRARY）。用户可以把可重用的复杂的逻辑运算和事务或者特定的数据表示方式定义到自定义JSP标签中，提高代码的简洁性和可重用性。自定义标签在功能逻辑上与JavaBean类似，都是对Java代码的封装。自定义标签是可重用的组件代码，而JavaBean也是可重用的组件。自定义标签易于使用，且与XML样式标签类似，允许开发人员为复杂

2、的操作提供逻辑名称。开发自定义JSP标签的基本步骤如下：2022/8/112Java EE基础教程（1）标签处理程序类：这是自定义标签的核心。 （2）标签库的描述文件（tld文件）（3）Web应用的web.xml文件（4）自定义标签的使用18.1 JSP自定义标签简介2022/8/113Java EE基础教程18.2.1 创建标签处理类18.2.2 创建标签库描述文件TLD18.2.3 JSP中使用自定义标签18.2 开发自定义JSP标签返回2022/8/114Java EE基础教程首先要制作一个Java类，用来告诉JSP程序遇到这个标签后应该做什么。这个类必须实现javax.servlet.

3、jsp.tagext.Tag接口。Tagext包中有两个类，即TagSupport和BodyTagSupport。这两个类提供了Tag接口的默认实现。在实际开发中，标签处理类通过继承javax.servlet.jsp.tagext.TagSupport或javax.servlet.jsp.tagext.BodyTagSupport这两个类，只需重新自定义那些需要自定义的行为的方法，从而简化了标签处理程序的开发。 18.2.1 创建标签处理类2022/8/115Java EE基础教程TagSupport与BodyTagSupport的区别主要是标签处理类是否需要对标签体处理，如果不需要处理标签体

4、就用TagSupport，否则就用BodyTagSupport。对标签体处理就是标签处理类要读取标签体的内容和改变标签体返回的内容。用TagSupport实现的标签，都可以用BodyTagSupport来实现，因为BodyTagSupport继承了TagSupport。 18.2.1 创建标签处理类2022/8/116Java EE基础教程TagSupport类：实现了Tag和InterationTag接口。这个类支持简单标签和带主体迭代的标签。TagSupport类的方法如下：doStartTag()：JSP页面遇到开始标签时执行。如果用户希望在处理主体内容和结束标签之前进行其他处理，则可以

5、重写该方法。doStartTag()的原型为：int doStartTag() throws JspExceptiondoEndTag()：JSP页面遇到结束标签且在执行doStartTag()之后执行。其语法为：int doEndTag() throws JspExceptiondoAfterBody()：允许用户有条件地重新处理标签的主体。在处理完标签的主体之后调用。如果标签没有主体，则不会调用doAffterBody方法。其语法为：int doAfterBody() throws JspException18.2.1 创建标签处理类2022/8/117Java EE基础教程BodyTag

6、Support类：实现BodyTag接口，扩展TagSupport类。BodyTagSupport在TagSupport类的基础上又增加了以下两个方法：setBodyContent()：设置标签体的内容。在执行doInitBody()方法之前执行此方法。其语法为：void setBodyContent(BodyContent bc)doInitBody()：用于准备处理页面主体。在setBodyContent()方法之后被调用。其语法为：void doInitBody() throws JspException18.2.1 创建标签处理类2022/8/118Java EE基础教程初始化doSt

7、artTag()doEndTag()Release()结束返回值setBodyContent()doInitBody()doAfterBody()返回值EVAL_BODY_BUFFEREDEVAL_BODY_INCLUDE SKIP_BODYEVAL_BODY_AGAINSKIP_BODYEVAL_PAGE SKIP_PAGE18.2.1 创建标签处理类 BodyTagSupport类的方法执行过程流程图 2022/8/119Java EE基础教程从流程图可以看出，是否对标签体进行处理是由doStartTag()方法返回值决定的。如果doStartTag()方法返回EVAL_BODY_BUFF

8、ERED则处理标签体，否则执行doEndTag()方法。下面以生成一个随机验证码的标签为例，说明如何创建自定义标签。例18-1创建一个自定义标签，此标签产生随机验证码。程序清单：自定义标签处理类ch18IdentifyingTag.java18.2.1 创建标签处理类2022/8/1110Java EE基础教程这个标签处理类继承自BodyTagSupport类，由于此标签功能较简单，只是重写了doStartTag()方法，而没有对标签体内容的处理。在doStartTag()方法中调用Random类的实例生成一个4位数的随机数，并通过pageContext对象获得输出流，将随机数输出到页面上 1

9、8.2.1 创建标签处理类2022/8/1111Java EE基础教程TLD文件是一个XML文件，为JSP引擎提供有关自定义标签及其实现位置的元信息。TLD文件必须以扩展名.tld为后缀，文件保存在WEB-INF目录或它的子目录中。TLD文件可以有多个元素，其中主要的有3大类：taglib：标签库元素，是TLD文件的根元素；tag：标签元素，用于定义标签库中某个具体的标签；attribute：属性元素，指定某个标签的属性。例18-2 随机验证码的TLD文件identifying.tld。程序清单：WEB-INFidentifying.tld18.2.2 创建标签库描述文件TLD2022/8/1

10、112Java EE基础教程已经定义好了标签处理类和标签库描述文件以后，就可以在JSP文件中使用自定义标签了。例 18-3 在JSP页面中调用自定义标签显示验证码。程序清单：ch18tagExample.jsp18.2.3 JSP中使用自定义标签2022/8/1113Java EE基础教程18.3.1 分页标签处理类18.3.2 分页标签库描述文件18.3.3 使用分页标签18.3 编程示例：网上书店返回2022/8/1114Java EE基础教程创建标签处理类之前需要一个辅助的JavaBean，用这个JavaBean存放有关分页每一页的相关信息，如一共有多少条记录、一共有多少页、当前是第几页

11、、每页有多少条记录等信息。程序清单：ch18PageResult.java18.3.1 分页标签处理类2022/8/1115Java EE基础教程程序清单：ch18PaginationTag.javaPaginationTag签处理类继承了TagSupport，而pageContext属性是在TagSupport中定义的，所以在类中可以直接使用这个对象。pageResult=(PageResult) pageContext.getRequest().getAttribute(pageResult);pageContext是上文对象，通过这个对象可以获取封装在请求对象中的信息pageResult对象。这个pageResult对象是在下面的ToViewBook这个Servlet中保存在request对象中的。只要得到pageResult对象，就可以获得有关分页的所有信息。 18.3.1 分页标签处理类2022/8/1116Java EE基础教程在使用这个标签类时要注意，标签一定要放在一个表单form中。因为在点击“上一页”或“下一页”的链接时实际上是提交一个请求，这个请求提交给了所在form的action所指向的服务器处理程序。 18.3.1 分页标签处理类2022/8/1117Java EE基础教程标签库描述文件对标签处理类和标签之间建立映射关系，这样在JSP页面中