TagSupport的学习

TagSupport的学习

标签库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.指令元素、和向JSP容器提供转换时信息。

b.HTML行在_jspService()方法中依顺序转换到out.print()语名中。

c.脚本元素的声明被原封不动地复制到_jspService()方法外的源码中。

d.脚本元素的表达式在_jspService()方法中依顺序转换到out.print()语名中。

e.脚本元素的scriptlet被原封不动地复制到_jspService()方法中。

f.行为元素被转换为执行其功能的运行时逻辑代码。

g.定制标签被扩展到调用其相应标签处理器中方法的Java语句中。

3.标签在JSP容器中的转换步骤：

a.JSP容器使用taglib指令元素定位标签库描述器，将页面中用到的定制标签和TLD相匹配。

b.读取标签库描述器的标签列表和每一标签相关的类名字。

c.在页面中遇到一个标签时，查找与具有指定名字的标签前缀相关的一个标签库。

d.容器使用在TLD中找到的标签结构信息生成一系列完成标签功能的Java语句。

二、标签库描述器（TLD）

标签库描述器是一个描述整个标签库标记信息和库中每个标签处理器及其属性的XML文档。

标签库描述器的DTD由一个简单的元素组成，此元素包含下列一些子元素。

整个标签库标记信息

tlibversion标签库版本号。是一个点式十进制数，最多为4组小数点分隔的数字组成。

jspversion标签库所需的JSP规范最低版本。例如JSP1.1

shortname标签库的缩写名。JSP可以使用该名字作为库中标签的缺省前缀。

uri标签库唯一URI的元素。典型URL位置来自可下载taglib的位置。

info标签库描述信息。

每个标签处理器及其属性

tag在TLD中加入标签，描述组成库的每个标签。

name与标签库的名字前缀一起使用的标签的名字，是JSP容器唯一的标签标识。

tagclass实现标签的标签处理器类的全名。

teiclass标签附加信息（TEI）类的全名。TEI类给出关于标签处理器创建变量及对标签司性执行的任意有效性验证的信息。

bodycontent描述标签处理器如何使用标签体的内容。有三种取值：

empty：表示标签体必须为空；

JSP:表示脚本元素和模板及其它标签一样被评估。

tagdependent：体内容被原封不动写入BodyContent，其它脚本元素以源码形式出现，而不被JSP容器解释。

info标签的人工可读描述性信息。

attribute使用标签时被编码的属性信息。用于定义标签的属性。

属性名：属性的名字。

true|false：属性在标签用到的位置是否要被编码。

true|false：属性值能否用表达式指定。

三、标签处理器

标签处理器是通过实现JSP容器调用的一系列预定义方法执行定制标签行为的一个Java类。

标签处理器实现了标签的行为，标签处理器是Java类。

1.标签处理器的工作方式

a.导入javax.servlet.jsp和javax.servlet.jsp.tagext包。

包的位置:/tomcat/common/lib/jsp-api.jar(servlet:servlet-api.jar)

b.实现javax.servlet.jsp.tagext包中的Tag接口或BodyTag接口。BodyTag是Tag的子接口。

c.继承TagSupport类或BodyTagSuppoert类。它们是上述接口的缺省实现。

d.重载publicintdoStartTag()throwsJspException方法。

2.标签处理器的接口与实现

javax.servlet.jsp.tagext.Tag是实现标签的最基本的接口。

javax.servlet.jsp.tagext.TagSupport是实现Tag接口的具体类。

通常情况下继承tagSupport类而不直接实现Tag接口通常是有益的。除了对所有必需方法提供了缺省实现外、还保存了pageContext对象及对嵌套标签的支持。

Tag接口包含4个常量，表示doStartTag()和doEndTag()方法可能的返回码。

EVAL_BODY_INCLUDE当doStartTag()返回时，指明servlet应对标签体进行评估。

SKIP_BODY当doStartTag()返回时，指明servlet应忽视标签体。

EVAL_PAGE当doEndTag()返回时，指明页面其余部分应被评估。

SKIP_PAGE当doEndTag()返回时，指明页面其余部分就被跳过。

Tag接口的方法

publicvoidsetPageContext(PageContextctx)生成的servlet在请求处理器执行其它任务前首先调用此方法，实现类应保存上下文对象以便它可以在标签生命期中使用。从页面上下文中标签处理器可以访问所有JSP隐含对象。

publicvoidsetParent(Tagp)使用一个标答可以找到操作栈中它上面的标签。在setPageContext后立即调用。

publicTaggetParent()返回父标签。

publicintdoStartTag()throwsJsp在设置了页面上下文、父标签和开始标记中编码的属性后调用。返回码表明JSP实现servlet是否就评估标签体。

publicintdoEndTag()throwsJspException当遇到结否标记时调用。返回码表明JSP是否就继纽页面的其余部份。

publicvoidrelease()确保在页面退出前被调用。释放资源并重置标签处理器状态。

TagSupport类的方法

publicstaticTagfinAncestorWithClass(TagthisTag,Classcls)为所需的父标签处理器查找运行时标签栈。一个标签处理器可以提供其范围内子标签调用的方法。

publicvoidsetId(Stringid)保存和检索在id属性中指定的名字。

publicvoidsetValue(Stringname,Objecto)在本地哈希表中设置指定名字的值。

publicObjectgetValue(Stringname)从本地哈希表中获取指定名称的值。

publicvoidremoveValue(Stringname)从本地哈希表中删除指定名称的值。

publicEnumerationgetValues()返回哈希表中关键字的一个枚举。

3.标签处理器的生命期

a.生成servlet需要创建标签处理器类的一个实例。实现方式通常是调用JSP容器的工厂类的一个方法，工厂类包含一个标签处理器实例池以使其可重用不再处于激活状态的对象。

b.初始化标签处理器，使servlet获知其存在性。servlet通过调用标签处理器的两个方法实现此过程：setPageContext(PageContextctx)和setParent(Tagparent)。

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类的方法

publicvoidflush()throwsIOException复写JspWrite.flush()方法以便它总是产生溢出。刷新写入已失效，因为它没有连接到将被写入的实际输出流中。

publicvoidclearBody()重置BodyContent缓存为空。

publicReadergetReader()返回Reader读取体内容。

publicStringgetString()返回包含体内容的一个字符串。

publicvoidwriteOut(Writew)将体内容写入指定输出。

publicJspWritegetEnclosingWrite()返回栈中下一个更高的写入者对象（可能是另一个BodyContent对象）。

 

四，标签的实现

1 TagSupport与BodyTagSupport的区别

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,则执行顺序是

    doStartTag()->显示文字->doAfterBodyTag()->doEndTag()->执行下面的网页

下面這個程式簡單的示範如何使用自訂標籤來對網頁內容作一些保護：

• GuardTag.java
  

package onlyfun.caterpillar; 

 

import java.io.*; 

import javax.servlet.jsp.*; 

import javax.servlet.jsp.tagext.*; 

 

public class GuardTag extends TagSupport { 

     public int doStartTag() throws JspException { 

         String valid = 

             pageContext.getRequest().getParameter("valid"); 

 

         // 如果flag設定為key，就顯示本體文字內容 

         if(valid.equals("valid_user")) { 

             return EVAL_BODY_INCLUDE; 

         } 

 

         return SKIP_BODY; 

     } 

} 

同樣的，程式編譯完之後，放置在WEB-INF/classes/之下，然後編譯.tld檔案，如下：

• guardtag.tld

 

 


     xmlns:xsi="" 

     xsi:schemaLocation="

                         web-jsptaglibrary_2_0.xsd" 

     version="2.0"> 

    

     Tag Demo 

     1.0 

     2.0 

     TagDemo 

     /TagDemo 



      

         Cuard BodyText 

         guard 

         onlyfun.caterpillar.GuardTag 

         JSP 

      



 

在中設定的是JSP，這表示如果本體中包括JSP網頁的內容，將會被編譯執行，接下來您可以在web.xml中定義uri與.tld的名稱對應關係，方法與前一個主題相同，這邊就不重複說明了，然後撰寫一個測試的JSP網頁：

• test.jsp

<%@taglib prefix="caterpillar" 

            uri=""%> 

 

 

     這個網頁包括受保護的內容OOOXXXX。。。。。。
 

      

         ${ param.user }, 您好，幸運密碼是 oooxxx ！ 

      


 

 

為了要能看到幸運密碼，您必須在請求中包括guard參數，假設請求是：

這樣就可以看到幸運密碼了：

     這個網頁包括受包護的內容OOOXXXX。。。。。。

   

         Justin, 您好，幸運密碼是： oooxxx ！