JavaServer Pages (JSP) 和 JSP規(guī)范標(biāo)準(zhǔn)標(biāo)記庫 (JSTL) 為 Web 開發(fā)人員提供了許多有用的標(biāo)記（也稱作操作）。此外，JSP 2.0 還提供兩個 API，即標(biāo)準(zhǔn)標(biāo)記 API 和簡單標(biāo)記 API，用于構(gòu)建定制標(biāo)記/操作。前一個 API 繼承自 JSP 1.x，并由于歷史原因而由 JSTL 使用。（由于 JSTL 1.0 的開發(fā)在 JSP 2.0 之前，因此新 API 不包含 JSTL 1.1。）此外，JSTL 也不使用 JSP 片段和動態(tài)屬性等 JSP 新特性。本文使用 JSP 2.0 的新 API 和特性構(gòu)建定制標(biāo)記擴(kuò)展 JSTL。本文提供 API 概述并演示如何開發(fā)
◆導(dǎo)出變量的標(biāo)記
◆條件標(biāo)記
◆迭代標(biāo)記
◆具有動態(tài)屬性的標(biāo)記
◆協(xié)調(diào)標(biāo)記

簡單標(biāo)記API 概述

在 JSP 頁面中使用定制標(biāo)記時，應(yīng)用服務(wù)器的 JSP容器將 ... 轉(zhuǎn)換為調(diào)用稱為標(biāo)記處理類的方法的 Java 代碼。因此，如果要開發(fā)定制標(biāo)記，必須提供一個標(biāo)記處理類，此類必須使用 JSP 1.x 標(biāo)準(zhǔn)標(biāo)記 API 或 JSP 2.0 簡單標(biāo)記 API。比較一下這兩個 API，就會發(fā)現(xiàn)新 API 更易于使用。簡單標(biāo)記 API 只有一個接口 (javax.servlet.jsp.tagext.SimpleTag)，它定義了處理定制標(biāo)記的方法。通常從 JSP容器從 JSP 頁面中自動生成的 Java Servlet 中調(diào)用這些方法。

javax.servlet.jsp.tagext.SimpleTagSupport 類實(shí)現(xiàn)了 SimpleTag 接口，因此當(dāng)標(biāo)記處理類擴(kuò)展 SimpleTagSupport 時只須編寫 doTag() 方法即可。以下步驟介紹了如何開發(fā)一個簡單的標(biāo)記處理類：

第 1 步：設(shè)計定制標(biāo)記
首先，必須為標(biāo)記選擇一個名稱并設(shè)置它的屬性。然后，創(chuàng)建一個標(biāo)記庫描述符 (TLD) 文件（采用由 JSP規(guī)范定義的 XML 格式），以告知 JSP容器如何處理和驗(yàn)證定制標(biāo)記。文本提供了一個名為 util.tld 的示例 TLD 文件。

第 2 步：創(chuàng)建標(biāo)記處理類
必須提供一個用于實(shí)現(xiàn) SimpleTag 接口的 Java 類。最簡單的方法是擴(kuò)展 SimpleTagSupport 或它的某個子類。本文中的 VarTagSupport、IfTag 和 WhileTag 類用于擴(kuò)展 SimpleTagSupport。其他標(biāo)記處理類示例擴(kuò)展 VarTagSupport。

如果要使用未在 TLD 文件中指定的屬性，則標(biāo)記處理類必須實(shí)現(xiàn) javax.servlet.jsp.tagext.DynamicAttributes 接口（如“具有動態(tài)屬性的標(biāo)記”部分中介紹的 MapTag 示例所示）。

第 3 步：初始化標(biāo)記處理類實(shí)例
每個標(biāo)記處理類都必須包含一個不帶參數(shù)的公共構(gòu)造函數(shù)，用于放置初始化代碼。本文中的某些標(biāo)記處理類（EvalTag、ListTag 和 MapTag）包含一個無參數(shù)的公共構(gòu)造函數(shù)，它使用默認(rèn)值初始化實(shí)例變量。其他類（IfTag、WhileTag 和 ItemTag）沒有構(gòu)造函數(shù)。請注意，Java 編譯器在類不包含任何構(gòu)造函數(shù)的情況下自動生成一個無參數(shù)的公共構(gòu)造函數(shù)，該函數(shù)不執(zhí)行任何操作。

第 4 步：提供屬性設(shè)置方法
JSP 頁面中的標(biāo)記屬性值通過 setAttribute() 方法傳遞給標(biāo)記處理類。例如，本文中的 標(biāo)記包含四個屬性：var、scope、expr 和 type。EvalTag 處理類實(shí)現(xiàn) setExpr() 和 setType() 方法，并從 VarTagSupport 繼承 setVar() 和 setScope()。

動態(tài)屬性通過 DynamicAttributes 接口定義的 setDynamicAttribute() 方法傳遞。

第 5 步：實(shí)現(xiàn) doTag() 方法
該方法用于實(shí)現(xiàn)定制標(biāo)記的邏輯。doTag() 方法由 JSP容器繼所有屬性設(shè)置方法之后調(diào)用。此處可以使用 getJspContext() 獲得一個 javax.servlet.jsp.JspContext 對象來訪問 JSP 環(huán)境?？梢哉{(diào)用 getJspBody()，它返回 javax.servlet.jsp.tagext.JspFragment 的實(shí)例，該實(shí)例表示位于 和 之間的 JSP 主體。如果要開發(fā)協(xié)同工作的標(biāo)記，如 和 （本文的最后一部分將對其進(jìn)行介紹），則還可以使用 getParent() 和 findAncestorWithClass() 方法。

第 6 步：測試定制標(biāo)記
使用定制標(biāo)記的 JSP 頁面必須使用 <%@taglib%>指令導(dǎo)入該標(biāo)記的標(biāo)記庫。當(dāng)定制標(biāo)記出現(xiàn)在 JSP 頁面中時，JSP容器將生成創(chuàng)建標(biāo)記處理類實(shí)例、調(diào)用屬性設(shè)置方法和調(diào)用 doTag() 方法的代碼。因此，在使用定制標(biāo)記的 JSP 頁面的執(zhí)行過程中將調(diào)用標(biāo)記處理類方法。

限制和變通方法

為簡化標(biāo)記處理 API，JSP 2.0 采取了一個限制：如果定制標(biāo)記的處理類是基于簡單標(biāo)記 API 的，則頁面作者不得在 和 之間使用 JSP 1.x 聲明 (<%!...%>)、JSP 1.x 表達(dá)式 (<%=...%>) 和 scriptlet (<%...%>)。大多數(shù)情況下，您可以將 JSP 頁面中的 Java 代碼移動到標(biāo)記處理類中，或在 JSP 2.0 表達(dá)式 (${...})（可以在定制標(biāo)記的主體中使用）中使用 JSTL。請注意，JSP 2.0 允許您在基于標(biāo)準(zhǔn)標(biāo)記 API 的定制標(biāo)記主體中使用 scriptlet。然而，由于不使用腳本的 JSP 頁面更易于維護(hù)，因此最好避免在 Web 頁中使用 Java 代碼。

我的上一篇 Oracle 技術(shù)網(wǎng) (OTN) 文章“使用 JSP 2.0 EL API”介紹了簡單標(biāo)記 API 的另一個限制并提供了變通方法。JspContext 類未提供對 JSP 隱式對象（如application、session、request 和 response）的訪問。大多數(shù)應(yīng)用服務(wù)器（包括 Oracle Application Server Containers for J2EE (OC4J) 10g）允許將 JSP 上下文轉(zhuǎn)換為 PageContext

標(biāo)記處理類不適用于使用 println() 語句生成大量可重用的 HTML 代碼。JSP 2.0 為此工作提供了一個更好的方法。所謂的標(biāo)記文件使用 JSP 語法并由 JSP容器自動轉(zhuǎn)換為基于簡單標(biāo)記 API 的標(biāo)記處理類。我的另一篇 OTN 文章“創(chuàng)建 JSP 2.0 標(biāo)記文件”介紹了這個 JSP 新特性。

導(dǎo)出變量的標(biāo)記

許多 JSTL 標(biāo)記實(shí)現(xiàn)某個邏輯并導(dǎo)出 JSP變量以報告結(jié)果。例如， 包含一個 var 屬性，該屬性必須指定用于保存 SQL 結(jié)果集的 JSP變量的名稱。var 屬性對其他 JSTL 標(biāo)記（如 和 ）來說是可選的。如果 var 屬性不存在，則這些標(biāo)記將輸出它們的結(jié)果。所有包含 var 屬性的標(biāo)記還包含一個 scope 屬性，該屬性可用于指示以下 JSP變量的作用域：page、request、session 或 application。

VarTagSupport 類（它是為本文開發(fā)的一個示例）擴(kuò)展 SimpleTagSupport 并為 var 和 scope 屬性提供設(shè)置方法。VarTagSupport 包含用于導(dǎo)出 JSP變量、獲取主體內(nèi)容和輸出內(nèi)容的實(shí)用方法，而不是實(shí)現(xiàn) doTag() 方法。這些方法由 VarTagSupport 的子類在 doTag() 中使用。本文包含四個用于擴(kuò)展 VarTagSupport 的標(biāo)記處理類（EvalTag、MapTag、ListTag 和 ItemTag）。

請注意，JSP變量在 JSTL 規(guī)范中稱作范圍變量，而在 JSP規(guī)范中稱作具名變量或范圍屬性。這些變量通過 JspContext 類的 setAttribute() 方法創(chuàng)建/導(dǎo)出。您可以在 JSP 頁面中使用 ${varName}，以及在 Java 代碼中使用 JspContext 的 getAttribute() 或 findAttribute() 方法取得它們的值。不要混淆 JSP變量與標(biāo)記屬性。

【編輯推薦】

1. 簡單介紹JSP技術(shù)
2. 需要掌握的十個JSP標(biāo)簽庫
3. JSP技術(shù)中表單數(shù)據(jù)存儲的通用方法
4. 詳解JSP技術(shù)的方法
5. 怎樣學(xué)習(xí)JSP技術(shù)