[JSP]JSP自定义标签学习心得

<web-app xmlns="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/j2ee   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

Test.tld 2.0

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

 

Web．Xml 1.x

 

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>

Test.tld 1.x

<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.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>Application Tag Library</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。

标签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，前者会再显示一次标签间的文字，后者则继续执行标签处理的下一步。