標籤庫

JSP標籤庫，也稱自定義標籤庫，可看成是一種通過JavaBean生成基於XML的腳本的方法。從概念上講，標籤就是很簡單而且可重用的代碼結構。比方說，在最新發布的JSPKit（在JSP Insider內）中，使用XML標籤實現了對XML文檔的輕鬆訪問。

基本信息

請看以下的清單A。

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

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

<JAXP:TransformerTag>

<JAXP:XMLFile>c:/xml/example.xml</JAXP:XMLFile>

<JAXP:XSLFile>c:/xml/example.xsl</JAXP:XSLFile>

</JAXP:TransformerTag>

以上的示例使用了簡單的標籤來訪問處在幕後的更強大代碼，標籤部分的語句首先裝載了一個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）如果需要加入新的功能，你也無需修改任何已經存在的頁面，可以在標籤中加入額外的屬性，從而引進新的行為，而其它舊的屬性不變，這樣所有舊的頁面還可以正常工作。 例如你有一個讓所有文本變藍的標籤：

<BlueText>My Text</BlueText>

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

<BlueText shade="teal">My Text</BlueText>

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

（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

/* HTML_Format.java */

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

/** 創建新的HTML_Format */

public HTML_Format() {}

/** 將一個字元串中所有的 < 和 > 字元用相應的HTML編碼代替 */

public String HTML_Encode(String as_data)

{

int li_len = as_data.length();

/*string buffer的長度要比原來的字元串長*/

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

{

/* 1) 在標籤末將會調用這個函式 */

public int doEndTag() throws JspTagException

{

try

{

/* 2)得到標籤中的文本 */

BodyContent l_tagbody = getBodyContent();

String ls_output = "";

/* 3)如果標籤體有文本，就處理它 */

if(l_tagbody != null)

{

HTML_Format l_format = new HTML_Format();

/* 3a) 將標籤體的內容轉換為一個字元串 */

String ls_html_text = l_tagbody.getString();

ls_output = l_format.HTML_Encode(ls_html_text);

}

/* 4)將結果寫回到數據流中 */

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

}

catch (IOException e)

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

}

/* 讓JSP繼續處理以下頁面的內容 */

return EVAL_PAGE;

}

}

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

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

2．調用html編碼函式

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

創建標籤描述符

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

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

<!DOCTYPE taglib

PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"

"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">

1.0

1.1

HTML_FormatTag

HTML Encoding Tag

HTMLEncode

HTML_FormatTag

Encode HTML

更新Web XML檔案

現在可以告訴JSP容器如何使用標籤庫了。為此要修改web.xml檔案，具體說來是要在其中加入一個taglib的項目來註冊該標籤庫，並為標籤分配一個URI。URI是Web站點上唯一套用於這一特定標籤的索引。由於標籤今後還可能用在不同的Web站點上，所以你最好採用完整的URL和/或者包名字（package name）來保證這一唯一性。這個例子是簡化了，示例代碼請參看清單E。

清單E：修改web.xml檔案

<!DOCTYPE web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"

"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd">

HTMLEncode

/WEB-INF/HTML_FormatTag.tld

使用新的標籤

自定義的標籤設定好後，就可以用在你的JSP頁面上了。要做到這一點，只需要在頁面上使用taglib指示命令聲明所要採用的標籤即可。標籤通過其唯一的 URI被索引，然後被分配給一個名字空間前綴（prefix）。這一前綴並沒有什麼特別的意義，只要它不與其它的名字空間衝突便可，可以任意。請參看以下的清單F和G。

清單F：在一個JSP頁面上使用HTML編碼標籤

清單G：範例代碼的輸出

which displays as:

通過這個標籤，我就將該頁面的所有代碼編碼了。所有的自定義標籤都是在伺服器上處理的。這意味著你將不會在輸出的頁面上看到自定義的標籤。

正如你所看到的那樣，建立標籤並非難事。最麻煩的是學習標籤處理器的整個細節。這是一個很強大的功能，我們不過是觸及了皮毛。由於這一過程需要採取的步驟很多，所以剛入門的JSP程式設計師可能在建立標籤的時候會覺得很困惑。

其它

標籤庫是JSP最重要的特性之一，它還處在不斷的發展中。它的確是一個新事物，因此還沒有被廣泛採用，不過自定義標籤庫已經剝去了它的神秘面紗，越來越多的開發者也開始關注和使用它了。在2001年末，可預料標籤庫將是許多JSP項目中的一個很常見的特性。

在這篇文章中只簡要地討論了標籤庫的好處。標籤庫實際上還有許多其它強大的功能。標籤庫促使JSP開發進入了前所未有的新天地。對JSP開發人員來說這確實是一種很令人振奮的新技術，因為他們得到了一個可將JSP轉到各個套用並且建立任何類型web套用的工具。標籤庫讓JSP變成了最豐富、最具動態開發能力的、強大的Web編程環境。它的功能只受我們的想像和創造力限制。