JSP自定义标签学习心得的详细介绍

<web-appxmlns="http://java.sun.com/xml/ns/j2ee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"version="2.4"xsi:schemaLocation="http://java.sun.com/xml/ns/j2eehttp://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

Test.tld 2.0

<taglibxmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2eeweb-jsptaglibrary_2_0.xsd"
version="2.0">
<description>SimpleTag</description>
<tlib-version>1.0</tlib-version>

 

Web．Xml 1.x

<!DOCTYPEweb-appPUBLIC"-//SunMicrosystems,Inc.//DTDWebApplication2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>

Test.tld 1.x

<!DOCTYPEtaglibPUBLIC"-//SunMicrosystems,Inc.//DTDJSPTagLibrary1.1//EN""http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>html</shortname>
<uri>http://jakarta.apache.org/struts/tags-html</uri>

头信息的版本匹配很重要,本文就在此举例头信息，以下的XML文件格式大家要注意匹配版本

（以下的例子都是1。X版本）

2如何配置标签

 

配置标签是写标签中最有挑战性的事情，下面说说应该如何配置。

首先要配置web.xml

 

<taglib>
<taglib-uri>/aaa</taglib-uri>
<taglib-location>/WEB-INF/test.tld</taglib-location>
</taglib>

 

然后是test.tld

<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>ApplicationTagLibrary</shortname>
<uri>/mytag</uri>
<info>学习标签</info>

<tag>
<name>hello</name>
<tagclass>com.TestTld</tagclass>
<bodycontent>empty</bodycontent>
<info>向菜头学习</info>
<attribute>
<name>begin</name>
<required>true</required>
</attribute>
<attribute>
<name>end</name>
<required>true</required>
</attribute>

</tag>
</taglib>

TLD的根是taglib元素。表16-2中列出了taglib的子元素：

在tag元素中的TLD中指定标签。在表16-3中出了tag的子元素：

下面几节描述开发在标签类型中介绍的每一种类型的标签所需要的方法和TLD。

之后是在页面上加上声明

<%@ taglib uri="/aaa" prefix="mytag"%>

使用起来就变得非常简单了

<mytag:hello begin="aa" end="bd"/>

以上就是标签的整个配置过程。

2． class的编写

标签handler

标签handler是由Web容器调用的一个对象，用于执行带有自定义标签的JSP页面时对这个标签进行判断。标签handler必须实现Tag或者BodyTag接口。接口可以用于接受现有Java对象并使它成为标签handler。对于新创建的处理器，可以用TagSupport和BodyTagSupport类作为基类。这些类和接口包含在javax.servlet.jsp.tagext包中。

JSP页面的servlet在对标签处理的不同阶段调用由Tag和BodyTag接口定义的标签handler。遇到自定义标签的开始标签时，JSP页面的servlet调用方法以初始化相应的handler，然后调用handler的doStartTag方法。遇到自定义标签的结束标签时，调用处理器的doEndTag方法。在标签handler需要与标签的正文交互时调用其他方法，见带正文的标签。为了提供标签handler的实现，必须实现在处理标签的不同阶段调用的方法，在表16-1中汇总了这些方法。

标签handler可以使用一个能让它得以与JSP页面通信的API。到API的入口点是页面上下文对象(javax.servlet.jsp.PageContext)，通过它标签handler可以获取JSP页面能够访问的所有其他隐式对象(请求、会话和应用程序)。

隐式对象可以有与其相关联的命名属性。可以用[set|get]Attribute方法访问这种属性。

如果标签是嵌入的，标签handler还可以访问与外围标签关联的handler称为parent)。

一组相关的标签handler类(标签库)一般是打包的且作为JAR文档部署。

简单标签的handler必须实现Tag接口的doStartTag和doEndTag方法。在遇到开始标签时调用doStartTag方法。因为简单标签没有正文，所以这个方法返回SKIP_BODY。在遇到结束标签时调用doEndTag方法。如果要对页面的其他部分进行判断，则doEndTag方法需要返回EVAL_PAGE，否则，它就返回SKIP_PAGE。

每当你写的tag在Jsp页面里面要被解释的时候，服务器就自动调用你的类里面的doStartTag()函数来完成你定义的逻辑，当解析完标签后调用doEndTag()。实现Tag接口来定制自己的tag无疑是最灵活的。但是，难度也比较大，我们定义自己的tag的时候完全不必要搞得这么有内涵。

EVAL_BODY_INCLUDE：把Body读入存在的输出流中，doStartTag()函数可用


EVAL_PAGE：继续处理页面，doEndTag()函数可用

SKIP_BODY：忽略对Body的处理，doStartTag()和doAfterBody()函数可用

SKIP_PAGE：忽略对余下页面的处理，doEndTag()函数可用

EVAL_BODY_TAG：已经废止，由EVAL_BODY_BUFFERED取代

EVAL_BODY_BUFFERED：申请缓冲区，由setBodyContent()函数得到的BodyContent对象来处理tag的body，如果类实现了BodyTag，那么doStartTag()可用，否则非法

EVAL_BODY_AGAIN：请求继续处理body，返回自doAfterBody()，这个返回值在你制作循环tag的时候是很有用的。

TagSupport与BodyTagSupport的区别主要是标签处理类是否需要与标签体交互，如果不需要交互的就用TagSupport，否则如果不需要交互就用BodyTagSupport。

交互就是标签处理类是否要读取标签体的内容和改变标签体返回的内容。

用TagSupport实现的标签，都可以用BodyTagSupport来实现，因为BodyTagSupport继承了TagSupport。

2 doStartTag(),doEndTag()

doStartTag()方法是遇到标签开始时会呼叫的方法，其合法的返回值是EVAL_BODY_INCLUDE与SKIP_BODY,前者表示将显示标签间的文字，后者表示不显示标签间的文字；doEndTag()方法是在遇到标签结束时呼叫的方法，其合法的返回值是EVAL_PAGE与SKIP_PAGE，前者表示处理完标签后继续执行以下的JSP网页，后者是表示不处理接下来的JSP网页

doAfterBody(),这个方法是在显示完标签间文字之后呼叫的，其返回值有EVAL_BODY_AGAIN与SKIP_BODY，前者会再显示一次标签间的文字，后者则继续执行标签处理的下一步。

预定的处理顺序是：doStartTag()返回SKIP_BODY,doAfterBodyTag()返回SKIP_BODY,doEndTag()返回EVAL_PAGE.

如果继承了TagSupport之后，如果没有改写任何的方法，标签处理的执行顺序是：

doStartTag() ->不显示文字 ->doEndTag()->执行接下来的网页

如果您改写了doStartTag(),则必须指定返回值，如果指定了EVAL_BODY_INCLUDE,则执行顺序是