Java-JSTL（JSP標準標籤庫）

 

前言

從JSP　1.1規範開始，JSP就支援在JSP中使用自訂標籤了，自訂標籤的廣泛使用造成了程式員重複定義，這樣就促成了JSTL（JavaServer Pages Standard Tag Library）的誕生。
因為工作中需要用到JSTL，但網上卻苦於找不到有關JSTL的中文資料，所以就有了這篇文章。

JSTL簡介

JSTL是一個不斷完善的開放原始碼的JSP標籤庫，是由apache的jakarta小組來維護的。JSTL只能運行在支援JSP1.2和Servlet2.3規範的容器上，如tomcat 4.x。但是在即將推出的JSP 2.0中是作為標準支援的。
JSTL目前的最新版本為1.02，最終發布版為1.0。JSTL包含兩個部分：標籤庫和EL（Expression Language運算式語言）語言。標籤庫目前支援四種標籤： 標籤 URI 首碼 樣本
Core http://java.sun.com/jstl/core c <c:tagname ...>
XML processing http://java.sun.com/jstl/xml x <x:tagname ...>
I18N capable formatting http://java.sun.com/jstl/fmt fmt <fmt:tagname ...>
Database access (SQL) http://java.sun.com/jstl/sql sql <sql:tagname ...>

Core支援JSP中的一些基本的操作；
XML processing支援XML文檔的處理；
I18N capable formatting支援對JSP頁面的國際化；
Database access (SQL)支援JSP對資料庫的操作。

由於本人水平有限，本文僅介紹Core標籤，如有興趣，可一起探討其它三種標籤的使用與擴充。

EL語言介紹

EL語言是JSTL輸出（輸入）一個JAVA運算式的表示形式。
在JSTL中，EL語言只能在屬性值中使用。EL語言只能通過建立運算式${exp1}來進行調用。在屬性值中使用運算式有三種方式。

1、 value屬性包含一個運算式
<some:tag value="${expr}"/>
在這種情況下，運算式值被計算出來並根據類型轉換規則賦值給value屬性。比如：<c:out value="${username}" />中的${username}就是一個EL，它相當於JSP語句<%=request.getAttribute(“username”)%>或<%=session.getAttribute(“username”)%>

2、 value屬性包含一個或多個屬性，這些屬性被文本分割或圍繞
<some:tag value="some${expr}${expr}text${expr}"/>
在這種情況下，運算式從左至右進行計算，並將結果轉換為字串型（根據類型轉換規則），並將結果賦值給value屬性

3、 value屬性僅僅包含文本
<some:tag value="sometext"/>
在這種情況下，字串型屬性value將根據類型轉換規則轉換為標籤所希望的類型。

EL語言的操作符
取得某個對象或集合中的屬性值
為了獲得集合中的屬性，EL支援以下兩種操作
1． 使用.操作符來獲得有名字的屬性。例如運算式${user.username}表明對象user的username屬性
2． 使用[]操作符來獲得有名字或按數字排列的屬性。
運算式${user["username"]}和運算式${user. username }含義相同
運算式${row[0]} 表明row集合的第一個條目。
在這裡user是一個類的對象，它的屬性username必須符合標準JavaBean的規範，即必須為username屬性定義相應的getter、setter方法。

Empty操作符(空值檢查)

使用empty操作符來決定對象、集合或字串變數是否為空白或null。例如：
${empty param.username}
如果request的參數列表中的username值為null，則運算式的值為true。 EL也可以直接使用比較操作符與null進行比較。如${param.firstname == null}。
比較操作符 操作符 描述
==或eq 相等檢查
!=或ne 不等檢查
<或lt 小於檢查
>或gt 大於檢查
<=或le 小於等於檢查
>=或ge 大於等於檢查

數字運算子與邏輯運算子均與JAVA語言相同，不再列表。

Core標籤庫

1、 通用標籤

<c:out>
<c:out>標籤用於在JSP中顯示資料，它有如下屬性 屬 性 描 述 是否必須 預設值
value 輸出的資訊，可以是EL運算式或常量 是 無
default value為空白時顯示資訊 否 無
escapeXml 為true則避開特殊的xml字元集 否 true

例子: 您的使用者名稱是: <c:out value=”${user.username}” default=”guest”/>

顯示使用者的使用者名稱，如為空白則顯示guest
<c:out value="${sessionScope.username}"/>

指定從session中擷取username的值顯示；
<c:out value="${username}" />

顯示username的值，預設是從request(page)中取，如果request中沒有名為username的對象則從session中取，session中沒有則從application(servletContext)中取，如果沒有取到任何值則不顯示。

<c:set>
<c:set>標籤用於儲存資料，它有如下屬性 屬 性 描 述 是否必須 預設值
value 要儲存的資訊，可以是EL運算式或常量 否
target 需要修改屬性的變數名，一般為javabean的執行個體 否 無
property 需要修改的javabean屬性 否 無
var 需要儲存資訊的變數 否 無
scope 儲存資訊的變數的範圍 否 page

如果指定了target屬性, 那麼property屬性也必須指定。
例子： <c:set value="${test.testinfo}" var="test2" scope=”session” />

將test.testinfo的值儲存到session的test2中，其中test是一個javabean的執行個體，testinfo是test對象的屬性。
<c:set target="${cust.address}" property="city" value="${city}"/>

將對象cust.address的city屬性值儲存到變數city中

<c:remove>
<c:remove>標籤用於刪除資料，它有如下屬性 屬 性 描 述 是否必須 預設值
var 要刪除的變數 是 無
scope 被刪除變數的範圍 否 所有範圍，包括page、request、session、application等

例子: <c:remove var="test2" scope="session"/>

從session中刪除test2變數。

2、 流量控制標籤

<c:if>

<c:if>標籤有如下屬性 屬 性 描 述 是否必須 預設值
test 需要評價的條件，相當於if (...){}語句中的條件 是 無
var 要求儲存條件結果的變數名 否 無
scope 儲存條件結果的變數範圍 否 page

<c:choose>
這個標籤不接受任何屬性

<c:when>
<c:when>標籤有以下屬性 屬 性 描 述 是否必須 預設值
test 需要評價的條件 是 無

<c:otherwise>
這個標籤同樣不接受任何屬性

例子： <c:if test="${user.wealthy}">
user.wealthy is true.
</c:if>

如果user.wealthy值true，則顯示user.wealthy is true.

<c:choose>
<c:when test="${user.generous}">
user.generous　is true.
</c:when>
<c:when test="${user.stingy}">
user.stingy is true.
</c:when>
<c:otherwise>
user.generous and user.stingy are false.
</c:otherwise>
</c:choose>

只有當條件user.generous傳回值是true時，才顯示user.generous　is true.
只有當條件user.stingy傳回值是true時，才顯示user.stingy　is true.
其它所有的情況（即user.generous和user.stingy的值都不為true）全部顯示user.generous and user.stingy are false.

由於JSTL沒有形如if (){…} else {…}的條件陳述式，所以這種形式的語句只能用<c:choose>、<c:when>和<c:otherwise>標籤共同來完成了。

3、 迴圈控制標籤

<c:forEach>
<c:forEach>標籤用於通用資料，它有以下屬性 屬 性 描 述 是否必須 預設值
items 進行迴圈的項目 否 無
begin 開始條件 否 0
end 結束條件 否 集合中的最後一個項目
step 步長 否 1
var 代表當前項目的變數名 否 無
varStatus 顯示迴圈狀態的變數 否 無

例子： <c:forEach items="${vectors}" var="vector">
<c:out value="${vector}"/>
</c:forEach>

相當於java語句 for (int i=0;i<vectors.size();i++) {
out.println(vectors.get(i));
}

在這裡vectors是一個java.util.Vector對象，裡面存放的是String資料，vector是當前迴圈條件下String對象。實際上這裡的vectors可以是任何實現了java.util. Collection介面的對象。
<c:forEach begin="0" end="100" var="i" step="1">
count=<c:out value="${i}"/><br>
</c:forEach>

輸出:
count=0
...
count=100

<c:forTokens>
<c:forTokens>標籤有以下屬性 屬 性 描 述 是否必須 預設值
items 進行迴圈的項目 是 無
delims 分割符 是 無
begin 開始條件 否 0
end 結束條件 否 集合中的最後一個項目
step 步長 否 1
var 代表當前項目的變數名 否 無
varStatus 顯示迴圈狀態的變數 否 無

例子
<c:forTokens items="a:b:c:d" delims=":" var="token">
<c:out value="${token}"/>
</c:forTokens>

這個標籤的使用相當於java.util.StringTokenizer類。在這裡將字串a:b:c:d以：分開迴圈四次，token是迴圈到當前分割到的字串。

4.匯入檔案和URL

JSTL核心標籤庫支援使用<c:import>來包含檔案，使用<c:url>來列印和格式化URL,使用<c:redirect>來重新導向URL。

<c:import>
<c:import>標籤包含另外一個頁面代碼到當前頁，它有以下屬性 屬 性 描 述 是否必須 預設值
url 需要匯入頁面的url 是 無
context /後跟本地web應用程式的名字 否 當前應用程式
charEncoding 用於匯入資料的字元集 否 ISO-8859-1
var 接受匯入文本的變數名 否 page
scope 接受匯入文本的變數的變數範圍 否 1
varReader 用於接受匯入文本的java.io.Reader變數名 否 無
varStatus 顯示迴圈狀態的變數 否 無

<c:url>
<c:url>標籤輸出一個url地址，它有以下屬性 屬 性 描 述 是否必須 預設值
url url地址 是 無
context /後跟本地web應用程式的名字 否 當前應用程式
charEncoding 用於匯入資料的字元集 否 ISO-8859-1
var 接受處理過的url變數名，該變數儲存url 否 輸出到頁
scope 儲存url的變數名的變數範圍 否 page

例子：
<c:import url="http://www.url.com/edit.js" var="newsfeed"/>

將url http://www.url.com/edit.js包含到當前頁的當前位置，並將url儲存到newsfeed變數中
<a href="<c:url url="/index.jsp"/>"/>

在當前頁的當前位置輸出<a href="http://www.yourname.com/index.jsp"/>，http://www.yourname.com是當前頁的所在的位置。

<c:redirect>
<c:redirect>標籤將請求重新定向到另外一個頁面，它有以下屬性 屬 性 描 述 是否必須 預設值
url url地址 是 無
context /後跟本地web應用程式的名字 否 當前應用程式

例子：
<c:redirect url="http://www.yourname.com/login.jsp"/>

將請求重新定向到http://www.yourname.com/login.jsp頁，相當於response.setRedirect("http://www.yourname.com/login.jsp");

<c:param>
<c:param>標籤用來傳遞參數給一個重新導向或包含頁面，它有以下屬性 屬 性 描 述 是否必須 預設值
name 在request參數中設定的變數名 是 無
value 在request參數中設定的變數值 否 無

例子：
<c:redirect url="login.jsp">
<c:param name="id" value="888"/>
</c:redirect>

將參數888以id為名字傳遞到login.jsp頁面，相當於login.jsp?id=888

JSTL的優點
1、 在應用程式伺服器之間提供了一致的介面，最大程式地提高了WEB應用在各應用伺服器之間的移植。
2、 簡化了JSP和WEB應用程式的開發。
3、 以一種統一的方式減少了JSP中的scriptlet代碼數量，可以達到沒有任何scriptlet代碼的程式。在我們公司的項目中是不允許有任何的scriptlet代碼出現在JSP中。
4、 允許JSP設計工具與WEB應用程式開發的進一步整合。相信不久就會有支援JSTL的IDE開發工具出現。

總結
上面介紹的僅僅是JSTL的一部分，如果有時間我會繼續把其它部分寫出來分享給大家。如果要使用JSTL，則必須將jstl.jar和standard.jar檔案放到classpath中，如果你還需要使用XML processing及Database access (SQL)標籤，還要將相關JAR檔案放到classpath中，這些JAR檔案全部存在於下載回來的zip檔案中。這個zip檔案可以從http://jakarta.apache.org/builds/jakarta-taglibs/releases/standard/jakarta-taglibs-standard-1.0.zip下載。

參考資料
1、 http://java.sun.com/products/jsp/jstl/
sun公司的JSTL網站
2、 http://jakarta.apache.org/taglibs/doc/standard-doc/intro.html
jakarta小組的JSTL網站
3、 http://www.manning.com/bayern/appendixA.pdf
JSTL的參考文檔，本文很多內容都是從這個PDF檔案裡翻譯的。
4、 ＜＜J2EE編程指南（1.3版）＞＞
介紹了JSTL的雛形，wrox的書都是精品。