解析JSP中标签库_JSP教程

编辑Tag赚U币
教程Tag:暂无Tag,欢迎添加,赚取U币!

推荐:J2EE基础--为什么jsp不能取代servlet
JSP动态Web内容可能是动态Web内容的一项伟大的技术,并可将内容和表示presentation相分离, 有些人仍然觉得奇怪,为什么servlets仍然有必要和JSP同时实施。 其实servlets的实用性并

标签库Taglib

标签被定义和分布在一个称为标签库的结构中,一个标签库是由元信息和类组成的集合:
1.标签处理器:实现定制标签功能的Java类。
2.标签附加信息(TEI):向JSP容器提供边辑以确认标签属性和创建变量的类。
3.标签库描述器(TLD):描述单个标签和整个标签库属性的XML文档。

标签处理器和标签附加信息需要定位在JSP容器类载入器可以找到的地方。标签库描述器可在URL指定的符意位置。JSP1.1规范要求JSP容器接受一个打包成因定结构的JAR文件的标签库。TLD必须是/META-INF目录中名为taglib.tld的文件,JAR文件则复制到/WEB-INF/lib目录下。

一、标签实现

1.开发步骤
a.定义标签的名字、属性、声明的变量和标签体的内容。
b.编写标签库描述器TLD。
c.编写标签处理器。
d.在JSP页面中使用标签。

2.JSP页面在JSP容器中的转换步骤:
JSP页面存在三种形式:jsp文件、java文件和class文件。
a.指令元素

3.标签处理器的生命期
a.生成servlet需要创建标签处理器类的一个实例。实现方式通常是调用JSP容器的工厂类的一个方法,工厂类包含一个标签处理器实例池以使其可重用不再处于激活状态的对象。
b.初始化标签处理器,使servlet获知其存在性。servlet通过调用标签处理器的两个方法实现此过程:setPageContext(PageContext ctx)和setParent(Tag parent)。
c.如果标签具有属性,属性的取值通过处理器提供setter方法传入到对象。属性setter方法是一个标签支持属性所需的唯一方法。
d.页面的上下文和父标签已被调置,并已具备属性。此时调用标签处理器的doStartTag()方法,该方法可以读取这些变量并执行实现标答功能所需的计算和操作。doStartTag()方法必须返回一个整型数。返回EVAL_BODY_INCLUDE则正常处理标签体,返回SKIP_BODY则从初始JSP页面中直到此标签结束标记处的内容均被忽略。
e.标签体被评估或忽视后调用标签处理器的doEndTag()方法,返回EVAL_PAGE则页面的其余部分被评估,返回SKIP_PAGE则servlet代码立即从_jspService()中返回。

4.体标签处理器的接口与实现
javax.servlet.jsp.tagext.BodyTag是Tag的子接口。
javax.servlet.jsp.tagext.BodyTagSupport是实现BodyTag类。
BodyContent是javax.servlet.jsp.JspWriter的子类,但与其父类有所区别。
BodyContent对象的内容不自动写了入servlet的输出流,而是积累在一字符串缓存中。当标签体完成后其对象仍可在doEndTag()方法中可以应用,由getString()或getReader()方法操作。并在必要时修改及写入恢复的JspWriter输出流。
BodyContent类的方法
public void flush()throws IOException 复写JspWrite.flush()方法以便它总是产生溢出。刷新写入已失效,因为它没有连接到将被写入的实际输出流中。
public void clearBody() 重置BodyContent缓存为空。
public Reader getReader() 返回Reader读取体内容。
public String getString() 返回包含体内容的一个字符串。
public void writeOut(Write w) 将体内容写入指定输出。
public JspWrite getEnclosing Write() 返回栈中下一个更高的写入者对象(可能是另一个BodyContent对象)。
BodyTag接口定义了一个新的整型常量
EVAL_BODY_TAG 当doStartTag()返回时,使得新的BodyContent对象被创建并与此标签处理器相关联。当doAfterBody()返回时,使得JSP servlet在修改完此标签控制的任意变量后再次评估体。
BodyTag接口的方法
public void setBodyContern (BodyContent out) 在当前JspWriter已被写入,一个新的BodyContent在被创建后由Jsp servlet调用,它发生在doStartTag()之后。
public void doInitBody() throws JspException setBodyContent()之后,体被评估前调用的生命期方法。如果多次评估体,此方法只调用一次。
public init doAfterBody() throws JspException 体被评估后,BodyContent写入者仍处于激活状态时调用的生命期方法。此方法必须返回EVAL_BODY_TAG或SKIP_BODY,若返回EVAL_BODY_TAG时体再次被评估。
BodyTagSupport类的方法
public int doStartTag() throws JspException 复写TagSupport中的doStartTag()方法。
public int doEndTag() throws JspException 调用TagSupport中的doEndTag()方法,返回结果。
public void setBodyContent (BodyContent out) 在一保护成员变量bodyContent中保存新的体内容对象,子类可直接访问此对象。
public void doInitBody() throws JspException 缺省什么都不做。被需要执行初始化的子类所复写。
public int doAfterBody() throws JspException 每次体被评估后由JSP servlet调用,体同容对象仍处于激活状态。返回SKEP_BODY或EVAL_BODY_TAG则体再次被评估
public void release() 设置bodyContent对象为null,然后调用super.release()。
public BodyContent getBodyContent() 返回bodyContent变量。子类已经可以访问保护变量,但此方法允许无关的标签处理类对此体内容发送输出。
public JspWriter getPreviousOut() 在bodyContent变量上调用getEnclosingWriter()并返回结果的简便方法。

5.体标签处理器的生命期

a.生成servlet需要创建标签处理器类的一个实例。实现方式通常是调用JSP容器的工厂类的一个方法,工厂类包含一个标签处理器实例池以使其可重用不再处于激活状态的对象。
b.初始化标签处理器,使servlet获知其存在性。servlet通过调用标签处理器的两个方法实现此过程:setPageContext(PageContext ctx)和setParent(Tag parent)。
c.如果标签具有属性,属性的取值通过处理器提供setter方法传入到对象。属性setter方法是一个标签支持属性所需的唯一方法。
d.页面的上下文和父标签已被调置,并已具备属性。调用标签处理器的doStartTag()方法,该方法可以读取这些变量并执行实现标答功能所需的计算和操作。
doStartTag()方法必须返回一个整型数。
返回EVAL_BODY_TAG则正常处理标签体(跳到e);
返回SKIP_BODY则从初始JSP页面中直到此标签结束标记处的内容均被忽略。(跳到f)
e.如果返回EVAL_BODY_TAG时,则正常处理标签体。
e1.在栈中保存当前的JspWriter对象,创建新的BodyContent对象,并将其置为JSP页面的out对象保存在上下文范围内名为name的属性中。并调用它的setBodyContent()方法。
e2.调用doInitBody()方法进行初始化。
e3.处理标签体。将输出写入BodyContent对象中,此过程依赖于TLD的标签元素 ,有三种可能取值。
e4.调用doAfterBody()方法,将体内体内容写入JspWriter,可如下实现:
JspWriter out=bodyContent.getEnclosingWriter();
out.println(bodyContent.getString());//bodyContent.writeOut(out);
bodyContent.clear();
e5.doAfterBody()方法返回两种可能:
返回EVAL_BODY_TAG时,再对标签体进行评估,这是数组和枚举被循环处理的典型情况。
返回SKIP_PAGE时,继续页面的其余部份。
e6.体内容完成,因此创建它的过程被反向:
调用pageContent.popBody()方法检索前面的JspWriter对象。
将写入者设置回out隐含对象。
f.标签体被评估或忽视后调用doEndTag()方法,允许标签处理器像输出流发回内容。
返回EVAL_PAGE则页面的其余部分被评估;
返回SKIP_PAGE则servlet代码立即从_jspService()中返回。
g. 此时体的内容在受保护的bodyContent对象中仍然可用。
可以将它写入servlet输出流中:
JspWriter out=pageContext.getOut();
out.println(bodyContent.getString());
或者
bodyContent.WriteOut(pageContext.getOut());

6.标签附加信息类


四、标签指令

taglib指令元素的目的是指定TLD的位置,设置在页面上与标签区分开来的一个短别名。
语法: