1. EVAL_BODY_BUFFERED常量
如果标签处理器类实现了BodyTag接口,它的doStartTag()方法除了可以返回SKIP_BODY和EVAL_BODY_INCLUDE常量之外,还可以返回EVAL_BODY_BUFFERED常量。当doStartTag()方法返回EVAL_BODY_BUFFERED常量时,JSP容器将会创建个javax.servlet.jsp.tagext.BodyContent工具,利用该工具来实行标签体。关于BodyContent类的用法,将不才面进行详细的讲解。
2. setBodyContent(BodyContent b)方法
当且仅当doStartTag()方法返回EVAL_BODY_BUFFERED常量时,JSP容器才会调用setBodyContent()方法,通过该方法将BodyContent工具通报给标签处理器类利用。
3. dolnitBody()方法
JSP容器在调用setBodyContent()方法后会调用doInitBody()方法来完成些初始化事情,该方法的调用在标签体实行之前。
个中,最主要的是setBodyContent()方法。为了帮助大家更好地理解BodyTag接口处理标签内容的办法,有必要对BodyContent类进行详细讲解。
BodyContent类是JspWriter类的子类,它在JspWriter的根本上增加了一个用于存储数据的缓冲区(确切地说缓冲区是在BodyContent的子类org.apache.jasper.runtime.BodyContentImple中定义的),当调用BodyContent工具的方法写数据时,数据将被写人到BodyContent内部的缓冲区中。
明白了BodyContent类的这个特点,就不难明得JSP容器是如何利用BodyContent工具来处理标签体内容了。当标签处理器类的doStartTag()方法返回EVAL_BODY_BUFFERED常量时,JSP容器会创建一个BodyContent工具,然后调用该工具的write()方法将标签体的内容写人BodyContent工具的缓冲区中,开拓者只要能够访问BodyContent缓冲区的内容,就能对标签体的内容进行处理。在BodyContent类中定义了一些用于访问缓冲区内容的方法,详细如下表所示。
BodyContent类的常用方法
方法声明
功能描述
String getString()
以字符串的形式返回BodyContent工具缓冲区中保存的数据
Reader getReader()
返回一个关联BodyContent工具缓冲区中数据的Reader工具,通过Reader工具可以读取缓冲区中的数据
void clearBody()
用于清空BodyContent工具缓冲区中的内容
JspWriter getEnclosingWriter()
用于返回BodyContent工具中关联的JspWriter工具。当JSP容器创建BodyContent工具后,PageContext工具中的"out"属性不再指向JSP的隐式工具,而是指向新创建的BodyContent工具。同时,在BodyContent工具中会用一个JspWriter类型的成员变量enclosingWriter记住原来的隐式工具,getEnclosingWriter()方 法返回的便是原始的JSP隐式工具
writerOut(Writer out)
用于将BodyContent工具中的内容写人到指定的输出流
在上表列举的所有方法中,个中getEnclosingWriter()方法最难明得,但是,只须要记住该方法的返回值为out即可。
除了BodyContent类外,在BodyTag接口还会涉及很多常量和方法,为了让大家更好地节制标签处理器的实行流程,接下来通过一张图来描述,详细如下图所示。
标签处理器的实行流程
上图中清楚地描述了JSP容器实行标签处理器的过程。个中,release()方法之以是利用用虚线,是由于这个方法不会在标签处理器每次实行都被JSP容器调用,只有当标签处理器工具作为垃圾被回收之前它才会被调用。传统标签的处理器是单例的,只会被创建和销毁一次。
接下来,通过实现自定义标签,学习如何利用BodyTag接口将标签体中的小写英笔墨母转换为大写,详细步骤如下。
(1)编写标签处理器类ToUpperCase.java。
JSP规范中定义了一个类BodyTagSupport实现了BodyTag接口,为了简化程序的编写,标签处理器类ToUpperCase.java只须要继续BodyTagSupport类即可。ToUpperCase.java类的实当代码如下例所示。
package cn.itcast.chapter09.classisctag;import java.io.IOException;import javax.servlet.jsp.JspException;import javax.servlet.jsp.tagext.BodyTagSupport;public class ToUpperCase extends BodyTagSupport { //定义doEndTag()方法 public int doEndTag() throws JspException { //获取级冲区中数据 String content = getBodyContent().getString(); //将数据转为大写 content = content.toUpperCase(); try{ //输出数据内容(两种办法均可) //pageContext.getout().write(content); bodyContent.getEnclosingWriter().write(content); } catch(IOException e){ e.printStackTrace(); return super.doEndTag(); }}
由于BodyTagSupport类中的doStartTag()方法默认返回EVAL_BODY_BUFFERED常量,JSP容器会在实行标签体之前创建BodyContent工具,然后将标签体内容通过setBodyContent()方法设置给BodyContent工具。因此在上面案例中的doEndTag()方法中可以直策应用getBodyContent()方法的getString()方法得到写人到BodyContent缓冲区中的内容,然后将其转换为大写,通过调用getEnclosingWriter()方法获取到out工具,将内容输出到浏览器中。
把稳:不能直策应用doStartTag()方法的缘故原由是,实行doStartTag()方法时,BodyContent工具中还没有缓存标签体的内容,因此通过getBodyContent()方法还无法得到标签的内容。
(2)注册标签处理器类。
在mytag.tld文件中增加一个Tag元素,对标签处理器类进行注册,注册信息如下所示。
<tag> <name>toUpperCase</name> <tag-class> cn.itcast.chapter09.classisctag.ToUpperCase</tag-class> <body-content>JSP</body-content></tag>
(3)编写JSP页面toUpperCase.jsp
在JSP页面中利用标签,在标签体中写人26个小写的英笔墨母,如下例所示。
<%@page language="java" pageEncoding="GBK"%><%@taglib uri= "http://www.itcast.cn" prefix="itcast"%><html> <head> <title>HelloWorld Tag</title></head><body> <itcast: toUpperCase> abcde fghij klmnopqrstuvwxyz </itcast:toUpperCase></body></html>
(4)启动Tomcat做事器,在浏览器地址栏中输人URL地址“http://localhost:8080/chapter09/toUpperCase.jsp”访问toUpperCase.jsp页面,从运行结果可以看出,自定义标签成功地将标签体中的小写英笔墨母转换为大写。