a) 建立通用標籤庫

若要安裝標籤庫，您需要執行下列步驟

1. 將標籤類別組合在 jar 檔案中。請務必包含位於 /WEB-INF 目錄中的標籤庫 {library}.tld 檔案
2. 將標籤 {library}.jar 檔案新增至 CLASSPATH
3. 將 {library}.jar 檔案複製至 /WEB-INF/lib 目錄
4. 在 /WEB-INF/web.xml 檔案中定義標籤庫元素。例如

     <taglib>
       <taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri>
       <taglib-location>/WEB-INF/{library}.tld</taglib-location>
     </taglib>
       

5. 在 jsp 頁面中定義標籤擴充。 <taglib-uri> 和 uri 指令必須相符。 prefix 識別 jsp 頁面中標籤庫中的標籤。例如

  <%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
    

b) 新增 Jakarta-Taglibs 庫

若要將標籤庫子專案新增至 Jakarta-Taglibs，您需要執行下列動作

1. 建立專案的頂層目錄。
2. 從現有子專案中複製下列頂層檔案
   • build.sh
   • build.bat
   • build.xml
3. 將 taglib.name 屬性變更為新的自訂標籤庫子專案名稱
4. 複製現有子專案的目錄結構
5. 修改頂層 Jakarta-Taglibs build.xml 檔案以納入新的庫

c) 部署標籤庫

使用 jakarta-taglibs 專案中的建置指令碼建立 war 檔案。建置 war 檔案後，您可以將該檔案放置在 $TOMCAT_HOME/webapps 目錄中。Tomcat 會載入您的類別並建立新的內容。

war 檔案應具有下列結構

  META-INF/
  META-INF/MANIFEST.MF
  WEB-INF/
  WEB-INF/classes/
  WEB-INF/lib/
  WEB-INF/lib/{tagLibrary}.jar
  WEB-INF/web.xml
  WEB-INF/{tagLibrary}.tld

如果您不想使用 jar 檔案，您可以將所有類別檔案放置在 /WEB-INF/classes 目錄中。

請參閱 Java Servlet 規範，v2.2 以取得有關 war 檔案的更多資訊。

Hello World 標籤處理常式

您可以在 /WEB-INF/classes/basic 目錄中找到 Hello World 標籤的標籤處理常式，因為它是 basic 套件的一部分

  package basic;

匯入 jsp 和標籤類別

  import javax.servlet.jsp.*;
  import javax.servlet.jsp.tagext.*;

Hello World 標籤處理常式實作 doStartTag() 方法，在遇到開始標籤時會呼叫該方法。

    public int doStartTag() throws JspException {
        try {
            pageContext.getOut().print("Hello World");
        } catch (Exception ex) {
            throw new JspException("IO problems");
        }
        return SKIP_BODY;
    }

JSP 容器設定 pageContext，且標籤處理常式可以使用。 SKIP_BODY 值可確保不會評估標籤主體。

Hello World 標籤庫描述符

  <?xml version="1.0" encoding="ISO-8859-1" ?>

描述部署描述符 DOCTYPE 的 XML 標頭。部署描述符包含 Web 應用程式的元素和組態資訊。

  <!DOCTYPE taglib
            PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" 
            "http://java.sun.com/j2ee/dtds/web-jsptaglib_1_1.dtd">

初始標籤庫描述

  <taglib>
    <!-- The version number of this tag library -->
    <tlibversion>1.0</tlibversion>

    <!-- The JSP specification version required to function -->
    <jspversion>1.1</jspversion>

    <!-- The short name of this tag library -->
    <shortname>utility</shortname>

    <!-- Public URI that uniquely identifies this version of the tag library -->
    <uri>http://jakarta.apache.org/taglibs/utilitytags</uri>

    <!-- General information about this tag library -->
    <info>
          A simple tag library for the examples
    </info>

Hello World 標籤描述。

• tagclass 元素將 Hello World 標籤處理常式與 Hello World 標籤關聯
• bodycontent 標籤告訴我們該標籤不會包含任何主體

  <!-- Hello tag -->
    <tag>
      <name>Hello</name>
      <tagclass>basic.Hello</tagclass>
      <bodycontent>empty</bodycontent>
      <info>
        Print Hello World
      </info>
    </tag>

web.xml 檔案

web.xml 檔案描述標籤庫描述符的標籤 uri 和位置之間的對應。

這裡的唯一 taglib-uri "http://jakarta.apache.org/taglibs/utilitytags" 與 /WEB-INF/tld/utilitytags.tld 中的標籤庫描述符關聯。

  <web-app>
    <taglib>
       <taglib-uri>
         http://jakarta.apache.org/taglibs/utilitytags
       </taglib-uri>
       <taglib-location>
         /WEB-INF/tld/utilitytags.tld
       </taglib-location>
    </taglib>
  </web-app>

Hello World jsp

以下指令告訴 JSP 容器使用在 web.xml 中定義的 "http://jakarta.apache.org/taglibs/utilitytags" uri。"jLib" 被定義為標籤的前置詞值。

  <%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="jLib" %>

Hello World 標籤被呼叫。標籤名稱 "Hello" 在標籤庫描述符中定義。

  <jLib:Hello/>

If 標籤處理常式

BodyTagSupport 類別實作 BodyTag 介面，並有 bodyContent 屬性的 getter 方法。

  public class IfTag extends BodyTagSupport {

doStartTag() 方法會在遇到開始標籤時呼叫，並呼叫本地的 getPredicate() 方法。如果傳回值為 true，則會評估標籤主體的其餘部分，否則會略過。

  public int doStartTag() {
    if (getPredicate()) return EVAL_BODY_TAG;
    else return SKIP_BODY;
  }

doAfterBody() 會在評估某些主體之後呼叫。它不會在空標籤或在 doStartTag() 中傳回 SKIP_BODY 的標籤中呼叫。

  public int doAfterBody() throws JspException {
    try {
      bodyContent.writeOut(bodyContent.getEnclosingWriter());
      return SKIP_BODY;
    } catch (IOException ex) {
      throw new JspTagException(ex.toString());
    }
  }

If 標籤庫描述符

  <!-- IF tag -->
    <tag>
      <name>If</name>
      <tagclass>lang.IfTag</tagclass>

If 標籤有一個必要的屬性。由於 rtexprvalue 設為 true，因此屬性可以有指令碼表達式作為值。該值可以在請求時動態計算。

      <attribute>
        <name>predicate</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <info>
        Conditional Tag.
      </info>
    </tag>  

web.xml 檔案

web.xml 檔案描述標籤庫描述符的標籤 uri 和位置之間的對應。

這裡的唯一 taglib-uri "http://jakarta.apache.org/taglibs/utilitytags" 與 /WEB-INF/tld/utilitytags.tld 中的標籤庫描述符關聯。

If JSP

If 標籤需要一個屬性。predicate 屬性包含一個指令碼，它會在執行階段評估。根據 predicate 屬性的值，jLib:Hello 標籤會被評估或略過。

  <jlib:if predicate="<%= x==5 %>">
    <jLib:Hello/>   
  </jlib:if>

1. 簡介

utilitytags 自訂標籤庫包含一些基本標籤的範例。它說明了幾個直接的自訂標籤庫程式碼技巧。

2. 先決軟體

這個自訂標籤庫不需要任何軟體，只要支援 JavaServer Pages 規格版本 1.1 的 servlet 容器即可。

3. 組態資訊

請遵循下列步驟，使用這個標籤庫組態您的網路應用程式

• 將標籤庫描述符檔案 (utilitytags/utilitytags.tld) 複製到網路應用程式的 /WEB-INF 子目錄。
• 將標籤庫 JAR 檔案 (utilitytags/utilitytags.jar) 複製到網路應用程式的 /WEB-INF/lib 子目錄。
• 在 /WEB-INF/web.xml 中，將 <taglib> 元素新增到網路應用程式部署描述符，如下所示

      <taglib>
          <taglib-uri>http://jakarta.apache.org/taglibs/utilitytags</taglib-uri>
          <taglib-location>/WEB-INF/utilitytags.tld</taglib-location>
      </taglib>
      

若要在 JSP 頁面中使用這個庫中的標籤，請在每個頁面的頂端新增以下指令

    <%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="x" %>

4. 標籤文件

utilitytags 標籤庫包含下列標籤

Hello 標籤

Hello 標籤會列印出文字「Hello World」。它沒有任何屬性。

複製標籤

MacroCopy 標籤會將屬性文字複製到 Writer。

貼上標籤

MacroPaste 標籤會貼上 Writer 指定的文字。

顯示來源標籤

ShowSource 標籤會取得 jspFile 並將內容複製到 Writer。

包含標籤

Include 標籤會包含指定 URL 的輸出。

如果標籤

If 標籤是基本條件標籤。

迴圈標籤

For 標籤是基本迴圈標籤。

useBean 標籤

useBean 標籤會將 Java 物件實例與指定的 ID 相關聯。

驗證標籤

Validate 標籤會產生 Javascript 來驗證 HTML 表單。