標籤庫

請看以下的清單A。

清單A：執行XML/XSL 轉換的示例標籤及其所在的HTML頁面

<%@ taglib uri="http://www.jspinsider.com/jspkit/JAXP" prefix="JAXP"%>

以上的示例使用了簡單的標籤來訪問處在幕後的更強大代碼，標籤部分的語句首先裝載了一個XML文件，然後應用了一個XSL文件來將XML文件中的內容轉換成某個表現格式，併發送給客戶端，這一切僅僅只是用了一個很簡單的標籤。定製標籤使得JSP項目中很容易創建重用的開放源代碼模塊，而你所需要的只是標籤庫和它的文檔說明。

易於安裝在多個項目上

標籤很容易從一個JSP項目遷移到其他項目。一旦建立了一個標籤庫，則只需要將所有的東西打包為一個JAR文件，你就可以在任何的JSP項目中重新使用。因為標籤可以重新使用，標籤庫可以輕鬆地用於你自己的項目，所以標籤庫越來越通行。目前，最好的標籤資源可以在JSPTags.com這個站點找到。

可以無限制地擴展和增加JSP的功能

擴展JSP 標籤庫可以具備JSP規範(JSP 1.2)中的任何特性和功能，你可以無限制地擴展和增加JSP的功能，而無需要等待下一版本JSP的出現。例如，你對JSP的include調用不太滿意。你可以建立自己的include標籤，該標籤執行的是你自己的規範。

容易維護

標籤庫使得JSP的web應用程序非常易於維護，原因有：

（1）標籤應用簡單，對任何人而言都很容易使用、易於理解。

（2）所有的程序邏輯代碼都集中放在的標籤處理器和JavaBeans中。這意味著你在升級代碼時，無需要對每個使用該代碼的頁面進行修改，你只需要修改集中的代碼文件便可。

（3）如果需要加入新的功能，你也無需修改任何已經存在的頁面，可以在標籤中加入額外的屬性，從而引進新的行為，而其它舊的屬性不變，這樣所有舊的頁面還可以正常工作。例如你有一個讓所有文本變藍的標籤：

但在後來項目中，你又想讓藍色變暗。你可以保留原有的標籤，只要為其增加一個新的屬性：shade ，如下所示：

所有舊的標籤仍然可以產生藍色的文本，但現在你可以使用同一標籤來產生變暗的藍色文本了。

（4）標籤提升了代碼的重用性。那些經過多次測試和使用的代碼肯定具有更少的bug。所以，使用定製標籤的JSP頁面也同樣具有更少的缺陷，維護起來自然方便多了。

快速的開發時間

標籤庫提供一個簡單的方式來重用代碼。在伺服器端的語言中，其中一個標準的重用代碼方式是使用模板。相對於使用模板庫，標籤庫是一個更好的解決辦法。使用模板庫，你必須為每個項目修改模板或者且建立嚴格的界面，而標籤庫則沒有這些限制，並且擁有所有面向對象的好處，可以做到靈活和更有擴展性，而且，通過重用代碼，你可以花費更少的時間來做開發，更多的時間可以用在設計你的web應用上。標籤庫的介面也很簡單，非常容易做插入、使用和調試。

標籤的組成結構

雖然標籤庫非常易於使用，不過要建立一個標籤庫的內部實現機制還是頗複雜的，起碼要比建立一個簡單的JavaBean複雜。這個複雜是來自於標籤庫是由幾部分構成的。不過，你只需要掌握了Java和JSP的知識就夠了。

一個簡單的標籤由下面的元素構成：

1．JavaBean：為了得到Java與生具來的面向對象的好處，可重用的代碼應該放到一個獨立的代碼容器中，也就是JavaBean。這些JavaBeans並不是標籤庫必不可少的一部分，但它們是標籤庫用來執行所分配任務的基礎代碼模塊。

2．標籤處理器：標籤處理器是標籤庫的真正核心。一個標籤處理器（tag handler）引用它所需要的任何外部資源（JavaBean）並且負責訪問JSP頁面的信息（PageContext對象）。而JSP頁面則把頁面上設置的標籤屬性和標籤體中的內容都傳遞給標籤處理器，當標籤處理器完成其處理過程后，它就會把處理后的輸出結果回送給JSP頁面做進一步處理。

3．標籤庫描述符（TLD文件）：這是一個簡單的XML文件，它記錄著標籤處理器的屬性、信息和位置等信息。JSP容器通過這個文件來得知從哪裡及如何調用一個標籤庫。

4．Web站點的web.xml文件：這是Web站點的初始化文件，在這個文件中，需要定義了Web站點中用到的自定義標籤，以及用來描述每個自定義標籤的tld文件。

5．發布文件（WAR或JAR文件）：如果你想重用自定義標籤的話，你需要一個方法來將它由一個項目遷移到其他項目中去。將標籤庫打包為一個JAR文件是一個簡單而且有效的方式。

6．JSP頁面上的標籤庫聲明：要在JSP頁面中的使用某個自定義標籤的話，需要使用標籤庫標示符在頁面上進行聲明。

看來要做的工作很多，剛開始用的時候當然會有點棘手，不過其實並不是很難。它的要點並不在於編碼，而是在於如何將各部分正確地組織起來。這種層次性的結構是很重要的，它令標籤的使用靈活和更容易轉移。更重要的事，這些層次可以讓整個建立標籤庫的過程都能通過JSP IDE（JSP的集成開發環境）自動完成。JSP IDE更可以自動完成創建定製標籤的大部分工作，而你自己則只需要負責建立代碼和標籤處理器。

（注意：一個標籤處理器僅定義一個自定義標籤；一個標籤庫是幾個處理相同任務的標籤處理器的集合）

以下將一步一步地教你如何建立自定義的標籤，具體的例子是擴展JSP，令它擁有自己的HTML編碼功能。這個功能將所有的<和>字元用 HTML代碼來代替。它可以很容易地擴展為做其它的編碼處理。為了簡化，這個例子只解釋了建立自定義標籤的基本要素。

創建JavaBean

代碼中的任何可重用部分都應該放到一個JavaBean中。這一點是很重要的。這樣你就可以在其他項目中重用這些代碼了。由於任何放置在標籤處理器內的代碼在標籤外都是不可以重用的，因此將可重用的代碼部分獨立開來是很重要的。在這個例子中，為HTML編碼的邏輯是常用的，因此放到JavaBean中，請參看清單B

清單B：HTML編碼JavaBean

public class HTML_Format extends Object implements java.io.Serializable {

public HTML_Format() {}

public String HTML_Encode(String as_data)

{

int li_len = as_data.length();

StringBuffer lsb_encode = new StringBuffer(li_len + (li_len/10));

for( int li_count = 0 ; li_count < li_len ; li_count++)

{ String ls_next = String.valueOf(as_data.charAt(li_count));

if (ls_next.equals("<")) ls_next = "<";

if (ls_next.equals(">")) ls_next = ">";

lsb_encode.append( ls_next );

}

return( lsb_encode.toString() );

}

}

創建標籤處理器

標籤處理器的代碼請參看清單C：

清單C：HTML編碼標籤處理器

import java.io.IOException;

import javax.servlet.jsp.*;

import javax.servlet.jsp.tagext.*;

public class HTML_FormatTag extends BodyTagSupport

{

public int doEndTag() throws JspTagException

{

try

{

BodyContent l_tagbody = getBodyContent();

String ls_output = "";

if(l_tagbody != null)

{

HTML_Format l_format = new HTML_Format();

String ls_html_text = l_tagbody.getString();

ls_output = l_format.HTML_Encode(ls_html_text);

}

pageContext.getOut().write(ls_output.trim());

}

catch (IOException e)

{ throw new JspTagException("Tag Error:" + e.toString());

}

return EVAL_PAGE;

}

}

這個處理很簡單，它包括有：

1．讀入位於開始和結束標籤間的文本

2．調用html編碼函數

3．將結果返回到JSP頁面。

創建標籤描述符

我們需要描述自定義標籤以讓系統知道如何處理。該描述文件的後綴為.tld，TLD文件通常就以標籤處理器命名，並存放在“/WEB-INF/”目錄之下。請參看清單D。

清單D：HTML編碼標籤描述器