一、基本概念

1、標簽(Tag)

標簽是一種XML元素，通過標簽可以使JSP網頁變得簡潔并且易于維護，還可以方便地實現同一個JSP文件支持多種語言版本。由于標簽是XML元素，所以它的名稱和屬性都是大小寫敏感的。

2、標簽庫(Tag library)

由一系列功能相似、邏輯上互相聯系的標簽構成的集合稱為標簽庫。

3、標簽庫描述文件(Tag Library Descriptor)

標簽庫描述文件是一個XML文件，這個文件提供了標簽庫中類和JSP中對標簽引用的映射關系。它是一個配置文件，和web.xml是類似的。

4、標簽處理類(Tag Handle Class)

標簽處理類是一個Java類，這個類繼承了TagSupport或者擴展了SimpleTag接口，通過這個類可以實現自定義JSP標簽的具體功能。

二、自定義JSP標簽的格式

1、為了使到JSP容器能夠使用標簽庫中的自定義行為，必須滿足以下兩個條件：

<% @ taglib prefix=”someprefix”　uri=”/sometaglib” %>

1)從一個指定的標簽庫中識別出代表這種自定義行為的標簽；
2)找到實現這些自定義行為的具體類。

第一個必需條件－找出一個自定義行為屬于那個標簽庫－是由標簽指令的前綴(Taglib Directive's Prefix)屬性完成，所以在同一個頁面中使用相同前綴的元素都屬于這個標簽庫。每個標簽庫都定義了一個默認的前綴，用在標簽庫的文檔中或者頁面中插入自定義標簽。所以，你可以使用除了諸如jsp,jspx,java,servlet,sun,sunw(它們都是在JSP白皮書中指定的保留字)之類的前綴。 　

uri屬性滿足了以上的第二個要求。為每個自定義行為找到對應的類。這個uri包含了一個字符串，容器用它來定位TLD文件。在TLD文件中可以找到標簽庫中所有標簽處理類的名稱。

2、當web應用程序啟動時，容器從WEB-INF文件夾的目錄結構的META-INF搜索所有以.tld結尾的文件。也就是說它們會定位所有的TLD文件。對于每個TLD文件，容器會先獲取標簽庫的URI，然后為每個TLD文件和對應的URI創建映射關系。

在JSP頁面中，我們僅需通過使用帶有URI屬性值的標簽庫指令來和具體的標簽庫匹配。

三、自定義JSP標簽的處理過程

1、在JSP中引入標簽庫

<% @ taglib prefix=”taglibprefix” uri=”tagliburi” %>

2、在JSP中使用標簽庫標簽

3、Web容器根據第二個步驟中的prefix，獲得第一個步驟中聲明的taglib的uri屬性值

4、Web容器根據uri屬性在web.xml找到對應的元素

5．從元素中獲得對應的元素的值 

6．Web容器根據元素的值從WEB-INF/目錄下找到對應的.tld文件

7．從.tld文件中找到與tagname對應的元素 

8．湊元素中獲得對應的元素的值 

9．Web容器根據元素的值創建相應的tag handle class的實例 

10. Web容器調用這個實例的doStartTag/doEndTag方法完成相應的處理。

四、創建和使用一個Tag Library的基本步驟

1、創建標簽的處理類(Tag Handler Class)

2、創建標簽庫描述文件(Tag Library Descrptor File)

3、在web.xml文件中配置元素 4.在JSP文件中引人標簽庫

五、TagSupport類簡介

1、處理標簽的類必須擴展javax.servlet.jsp.TagSupport。

2、TagSupport類的主要屬性：

A.parent屬性：代表嵌套了當前標簽的上層標簽的處理類；

B.pageContex屬性：代表Web應用中的javax.servlet.jsp.PageContext對象；

3、JSP容器在調用doStartTag或者doEndTag方法前，會先調用setPageContext和setParent方法，設置pageContext和parent。因此在標簽處理類中可以直接訪問pageContext變量；

4、在TagSupport的構造方法中不能訪問pageContext成員變量，因為此時JSP容器還沒有調用setPageContext方法對pageContext進行初始化。

六、TagSupport處理標簽的方法

1、TagSupport類提供了兩個處理標簽的方法：

public int doStartTag() throws JspException
public int doEndTag() throws JspException

2、doStartTag：但JSP容器遇到自定義標簽的起始標志，就會調用doStartTag()方法。

doStartTag()方法返回一個整數值，用來決定程序的后續流程。

A.Tag.SKIP_BODY：表示?>…之間的內容被忽略；

B.Tag.EVAL_BODY_INCLUDE：表示標簽之間的內容被正常執行。

3、doEndTag：但JSP容器遇到自定義標簽的結束標志，就會調用doEndTag()方法。doEndTag()方法也返回一個整數值，用來決定程序后續流程。

A.Tag.SKIP_PAGE：表示立刻停止執行網頁，網頁上未處理的靜態內容和JSP程序均被忽略任何已有的輸出內容立刻返回到客戶的瀏覽器上。

B.Tag_EVAL_PAGE：表示按照正常的流程繼續執行JSP網頁。

下面來看一個實例：

1、修改web.xml文件，增加自定義標簽支持。

   <jsp-config>  

     <taglib>  

         <taglib-uri>/tld/helloworld</taglib-uri>  

         <taglib-location>/WEB-INF/tlds/helloworld.tld</taglib-location>  

     </taglib>  

   </jsp-config>   

2、創建標簽庫TLD文件 tlds\helloworld.tld 。

 <?xml version="1.0" encoding="UTF-8"?>  

 <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"  

 "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">     

 <taglib>  

    <tlib-version>1.0</tlib-version><!-- 標簽庫的版本 -->  

   <jsp-version>1.2</jsp-version><!-- 這個標簽庫要求的JSP規范版本 -->  

   <short-name>mytag</short-name><!-- JSP頁面編寫工具可以用來創建助記名的可選名字 -->  

    <tag>  

       <name>helloworld</name><!-- 唯一標簽名 -->  

    <tag-class>com.yd.mytag.HelloWorldTag</tag-class><!-- 標簽HelloWorldTag類的完全限定名 -->  

      <body-content>empty</body-content><!-- 正文內容類型 -->  

    </tag>  

 </taglib>  

這里注意：web.xml和xxx.tld這兩個XML文件的頭信息的版本匹配很重要，否則會導致頁面報錯找不到標簽 。

3、創建標簽處理程序類 HelloWorldTag（重寫doStartTag和doEndTag方法）。

 package com.yd.mytag;  
   

 import java.io.IOException;  

 import javax.servlet.jsp.JspException;  

 import javax.servlet.jsp.JspTagException;  

 import javax.servlet.jsp.tagext.TagSupport;  

 /** 

  * TagSupport與BodyTagSupport的區別: 

  * 主要看標簽處理類是否要讀取標簽體的內容和改變標簽體返回的內容，如果不需要就用TagSupport，否則就用BodyTagSupport 

  * 用TagSupport實現的標簽，都可以用BodyTagSupport來實現，因為BodyTagSupport繼承了TagSupport  
  */  

 public class HelloWorldTag extends TagSupport {  

     private static final long serialVersionUID = 3174234039143531070L;  

     @Override  

     public int doStartTag() throws JspException {//這個方法不用所以直接返回值  

         return EVAL_BODY_INCLUDE;  

     }  

     @Override  

     public int doEndTag() throws JspException {//重點在這個方法上  

        try {  

             pageContext.getOut().write("Hello World!");//標簽的返回值    

         } catch (IOException ex) {  

            throw new JspTagException("錯誤");  

         }  

         return EVAL_PAGE;  

     }  

 }  

補充： 

doStartTag()方法是遇到標簽開始時會呼叫的方法，其合法的返回值是EVAL_BODY_INCLUDE與SKIP_BODY,前者表示將顯示標簽間的文字，后者表示不顯示標簽間的文字。

doEndTag()方法是在遇到標簽結束時呼叫的方法，其合法的返回值是EVAL_PAGE與SKIP_PAGE，前者表示處理完標簽后繼續執行以下的JSP網頁，后者是表示不處理接下來的JSP網頁。

doAfterBody(),這個方法是在顯示完標簽間文字之后呼叫的，其返回值有EVAL_BODY_AGAIN與SKIP_BODY，前者會再顯示一次標簽間的文字，后者則繼續執行標簽處理的下一步。

EVAL_BODY_INCLUDE：把Body讀入存在的輸出流中，doStartTag()函數可用。

EVAL_PAGE：繼續處理頁面，doEndTag()函數可用。

SKIP_BODY：忽略對Body的處理，doStartTag()和doAfterBody()函數可用。

SKIP_PAGE：忽略對余下頁面的處理，doEndTag()函數可用。

EVAL_BODY_BUFFERED：申請緩沖區，由setBodyContent()函數得到的BodyContent對象來處理tag的body，如果類實現了BodyTag，那么doStartTag()可用，否則非法。