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)方法

jsps标签Java教程BodyTag接口用法具体介绍 Angular

当且仅当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页面,从运行结果可以看出,自定义标签成功地将标签体中的小写英笔墨母转换为大写。