jstl标簽庫

前言

=========================================================================

JSTL标簽庫，是日常開發經常使用的，也是衆多标簽中性能最好的。把常用的内容，放在這裡備份一份，随用随查。盡量做到不用查，就可以随手就可以寫出來。這算是Java程式員的基本功吧，一定要紮實。

JSTL全名為JavaServer Pages Standard Tag Library，目前最新的版本為1.1版。JSTL是由JCP(Java Community Process)所制定的标準規範，它主要提供給Java Web開發人員一個标準通用的标簽函數庫。

Web程式員能夠利用JSTL和EL來開發Web程式，取代傳統直接在頁面上嵌入Java程式(Scripting)的做法，以提高程式的閱讀性、維護性和友善性。

JSTL 1.1必須在支援Servlet 2.4且JSP 2.0以上版本的Container才可使用

<%@ taglib %>引入标簽庫

1、以classPath中，加入jar包： standard-1.1.2.jar ， jstl-1.1.2.jar

2、在相目\WEB-INF\tld\檔案夾中放入常用的tld檔案：c.tld，fmt.tld

3、在jsp檔案的頂部加入以下内容：

Java代碼

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>

<c:> 核心标簽庫

==========================================================================

JSTL 核心标簽庫(C标簽)标簽共有13個，功能上分為4類：

1.表達式控制标簽：out、set、remove、catch

2.流程控制标簽：if、choose、when、otherwise

3.循環标簽：forEach、forTokens

4.URL操作标簽：import、url、redirect

<c:forEach> 标簽

-------------------------------------------------------------------

為循環控制，它可以将集合(Collection)中的成員循序浏覽一遍。

<c:forEach> 标簽的文法說明：

文法1：疊代一集合對象之所有成員

Html代碼

<c:forEach [var="varName"] items="collection" [varStatus="varStatusName"] [begin="begin"] [end="end"] [step="step"]>
本體内容
</c:forEach>

文法2：疊代指定的次數

<c:forEach [var="varName"] [varStatus="varStatusName"] begin="begin" end="end" [step="step"]>

<c:forEach> 标簽的屬性說明：

<c:forEach> 标簽的屬性： varStatus屬性：它的提供另外四個屬性:index,count,fist和last，它們個自的意義如下:

屬性類型意義
index number 現在指到成員的索引
count number 總共指到成員的總和
first boolean 現在指到成員是否為第一個
last boolean 現在指到成員是否為最後一個

<c:forEach> 周遊 List清單：

對于一個基本類型的數組，目前元素将作為相應包裝類（Integer、Float等等）的一個執行個體提供。

<c:forEach items="${domainList }" var="item">
<tr>
<td align="center" valign="middle">${item["domain"]==null?" ":item["domain"]}</td>
<td align="center" valign="middle"><fmt:formatDate value="${item['bind_date']}" pattern="yyyy-MM-dd HH:mm:ss"/></td>
<td align="center" valign="middle">
<c:if test="${item['domain']!=null}">
<a href="javascript:;" id="${item['domain']}" class="del"> </a>
</c:if>
</td>
</tr>

<c:forEach> 周遊Map:

對于一個java.util.Map，目前元素則作為一個java.util.Map.Entry提供。

<c:if test="${!empty permissionMap}">
<c:forEach items="${permissionMap}" var="item">
<td>${item.value.id}</td>
<td>${item.value.urlOnClass}</td>
<td>${item.value.urlOnMethod}</td>
</tr>
</c:if>

<c:forTokens> 标簽

用來浏覽一字元串中所有的成員，其成員是由定義符号(delimiters)所分隔的。

<c:forTokens> 标簽的文法說明：

<c:forTokens items="stringOfTokens" delims="delimiters" [var="varName"]
[varStatus="varStatusName"] [begin="begin"] [end="end"] [step="step"]>
</c:forTokens>

<c:forTokens> 标簽的屬性說明：

<c:out> 标簽

主要用來顯示資料的内容

<c:out> 标簽的文法說明：

文法1：沒有本體(body)内容

<c:out value="value" [escapeXml="{true|false}"] [default="defaultValue"] />

文法2：有本體内容

<c:out value="value" [escapeXml="{true|false}"]>
default value
</c:out>

<c:forEach> 标簽的屬性說明：略

一般來說，<c:out>預設會将<、>、’、” 和 & 轉換為 <、>、'、" 和&。假若不想轉換時，隻需要設定<c:out>的escapeXml屬性為fasle就可以了。

<c:set> 标簽

主要用來将變量儲存至JSP範圍中或是JavaBean的屬性中。

<c:set> 标簽的文法說明：

文法1：将value的值儲存至範圍為scope的 varName 變量之中

<c:set value="value" var="varName" [scope="{ page|request|session|application }"]/>

文法2：将本體内容的資料儲存至範圍為scope的 varName 變量之中

<c:set var="varName" [scope="{ page|request|session|application }"]>
… 本體内容
</c:set>

文法3：将 value的值儲存至 target 對象的屬性中

<c:set value="value" target="target" property="propertyName" />

文法4：将本體内容的資料儲存至target 對象的屬性中

<c:set target="target" property="propertyName">

<c:set> 标簽的屬性說明：

<c:remove> 标簽

主要用來移除變量。

<c:remove> 标簽的文法說明：

<c:remove var="varName" [scope="{ age|request|session|application }"] />

<c:catch> 标簽

主要用來處理産生錯誤的異常狀況，并且将錯誤資訊儲存起來。

<c:catch> 标簽的文法說明：

<c:catch [var="varName"] >
… 欲抓取錯誤的部分
</c:catch>

<c:if> 标簽

的用途就和我們一般在程式中用的if一樣。

<c:if> 标簽的文法說明：

文法1：沒有本體内容(body)

<c:if test="testCondition" var="varName" [scope="{page|request|session|application}"]/>

<c:if test="testCondition" [var="varName"] [scope="{page|request|session|application}"]>
</c:if>

示例：

<c:if test="${not empty item.publish_time}">
内容
<c:if test="${item['domain']!=null}">
<c:if test="${!empty permissionMap}">

c:choose> <c:when> <c:otherwise> 标簽

<c:choose when otherwise> 标簽的文法說明：

<c:set var="score">85</c:set>
<c:choose>
<c:when test="${score>=90}">
你的成績為優秀！
</c:when>
<c:when test="${score>=70&&score<90}">
您的成績為良好!
<c:when test="${score>60&&score<70}">
您的成績為及格
<c:otherwise>
對不起，您沒有通過考試！
</c:otherwise>
</c:choose>

<fmt:> 格式化标簽庫

一：JSTL格式化标簽又稱為I18N标簽庫，主要用來編寫國際化的WEB應用，使用此功能可以對一個特定的語言請求做出合适的處理。

例如：中國内地使用者将顯示簡體中文，台灣地區則顯示繁體中文，使用I18N格式化标簽庫還可以格式化數字和日期，例如同一數字或日趨，在不同國家可能有不同的格式，使用I18N格式标簽庫可以将數字和日期格式為當地的格式。

在JSP頁面中要使用到格式化标簽，需要引入下面的語句：

<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"% >

二：概覽

格式化标簽

<fmt:fromatNumber>

<fmt:formatDate>

<fmt:parseDate>

<fmt:parseNumber>

<fmt:setTimeZone>

<fmt:timeZone>

國際化标簽

<fmt:setLocale>

<fmt:requestEncoding>

<fmt:bundle>

<fmt:message>

<fmt:param>

<fmt:setBundle>

三：<fmt:formatNumber>

此标簽會根據區域定制的方式将數字格式化成數字，貨币，百分比。

此标簽的屬性：

value:要格式化的數字

type：按照什麼類型格式化

pattern：自定義格式化樣式

currencyCode:ISO-4721貨币代碼，隻适用于按照貨币格式化的數字

currencySymbol：貨币符号,如￥,隻适用于按照貨币格式化的數字

groupingUsed：是否包含分隔符

maxIntegerDigits：整數部分最多顯示多少位

mixIntegerDigits：整數部分最少顯示多少位

maxFractionDigits：小數部分最多顯示多位位

minFractionDigits：小數部分最少顯示多位位

var:存儲格式化後的結果

scope: 存儲的範圍

示例1：

Java代碼

<%@ page language="java" pageEncoding="utf-8"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>

<title>chapter4.jsp</title>

</head>

<body>

<div>

<fmt:setLocale value="fr_fr"/>

<fmt:formatNumber value="123456789.012"/>

<fmt:setLocale value="zh_cn"/>

<fmt:setLocale value="de_de"/>

</div>

</body>

</html>

<%@ page language="java" pageEncoding="utf-8"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>

<title>chapter4.jsp</title>

</head>

<body>

<div>

<fmt:setLocale value="fr_fr"/>

<fmt:formatNumber value="123456789.012"/>

<fmt:setLocale value="zh_cn"/>

<fmt:setLocale value="de_de"/>

</div>

</body>

</html> 注意:如果要實作國際化,那麼編碼格式要設定為utf-8.

從程式運作效果可以看出,設定的區域不同,格式化數字的顯示也會不同.

四：type屬性：可以是數字(number),貨币(currency),百分比(percent)

示例2：

<fmt:formatNumber value="0.3" type="number"/>

<fmt:formatNumber value="0.3" type="currency"/>

<fmt:formatNumber value="0.3" type="percent"/>

<fmt:formatNumber value="0.3" type="number"/>

<fmt:formatNumber value="0.3" type="currency"/>

<fmt:formatNumber value="0.3" type="percent"/>

</html> currencyCode為貨币代碼,例如美元為USD,人民币為CNY等

currencySymbol為貨币符号例如,人民币為￥,美元為$。

如果不指定區域,則會根據語言區域自動選擇currencySymbol

示例3：

<fmt:setLocale value="en_Us"/>

<fmt:formatNumber value="0.3" type="currency"/>

<fmt:setLocale value="en_Us"/>

<fmt:formatNumber value="0.3" type="currency"/>

</html>

currencySymbol屬性還可以自定義要顯示的頭辨別,但是一定得type="currency"才會生效,例如:

<fmt:formatNumber value="0.3" type="currency" currencySymbol="#"/>

</html>

自定義數字樣式

<fmt:formatNumber value="12.31" pattern=".0000"/>

<fmt:formatNumber value="1234" pattern="###.##E0"/>

會顯示:

12.3100

1.234E3

會四舍五入

var:定義一個變量,存儲格式化後的結果,scope指定變量存儲的範圍.用法和前面講的标簽一緻.

五：<fmt:parseNumber>

此标簽用來将字元串類型的數字,貨币或百分比轉換成數字類型,和<fmt:formatNumber>标簽的作用正好相反.

value: 要轉換的字元串

type: 指定要轉換的字元串為什麼類型,可取值:number,percent,currency

pattern: 自定義格式化樣式

parseLocale: 指定區域來轉換字元串

IntegerOnly: 轉換後的數字是否隻顯示整數部分

var: 存儲轉換後的結果

scope: 存儲的範圍

示例1:

<fmt:parseNumber value="500,800,200"/>

顯示: 500800200

示例2:

<fmt:parseNumber value="52%" type="percent" />

顯示: 0.52 (52%在這裡是一個字元串, type指定這個字元串是什麼類型的值)

示例3:

<fmt:parseNumber value="￥123" type="currency" />

顯示123, ￥123在這裡是一個字元串, type指定這個字元串是什麼類型的值

示例4:

<fmt:parseNumber value="123.333" type="number" />

<fmt:parseNumber value="123.333" type="number" integerOnly="true"/>

顯示:

123.333

123

integerOnly确定是否隻顯示整數部分.

示例5:

<fmt:parseNumber value="￥123.333" type="currency" parseLocale="zh_CN"/>

<fmt:parseNumber value="$123.333" type="currency" parseLocale="en_US"/>

parseLocale="en_US"主要是配合當type="currency"時用的,

如果要轉換貨币的字元串類型為value="￥123.333",不設定語言環境的話,會取目前浏覽器的預設設定,否則就要加上parseLocale="zh_CN",指定環境為中文環境

如果要轉換貨币的字元串類型為value="$123.333",不設定語言環境的話,會取目前浏覽器的預設設定,如果預設為zh_cn的話,程式會報錯的,否則就要加上parseLocale="en_US",指定環境為英文美國環境

六：<fmt:formatDate />

此标簽可以将日期格式化.

屬性介紹:

value 用來格式化的時間或日期

type 指定格式化的是日期還是時間,或者兩者都是取值範圍:date,time,both

pattern 自定義格式化樣式

dateStyle 日期的格式化樣式

timeStyle 時間的格式化樣式

timeZone 指定使用的時區

var 存儲格式化後的結果

scope 指定存儲的範圍

自定義格式:

--------------------------

<fmt:setLocale value="zh_cn" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yyyy/MM/dd hh:mm:ss" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yyyy-MM-dd HH:mm:ss" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yyyy年MM月dd日 hh小時mm分鐘ss秒" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yy/MM/dd hh:mm:ss" />

<fmt:setLocale value="zh_cn" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yyyy/MM/dd hh:mm:ss" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yyyy-MM-dd HH:mm:ss" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yyyy年MM月dd日 hh小時mm分鐘ss秒" />

<fmt:formatDate value="<%=new Date()%>" type="both" pattern="yy/MM/dd hh:mm:ss" />

注意這裡小時 hh表示12小時制, HH代表24小時制

示例1：

<fmt:formatDate value="<%=new Date()%>" />

<fmt:setLocale value="zh_tw" />

<fmt:formatDate value="<%=new Date()%>" />

<fmt:setLocale value="zh_tw" />

<fmt:formatDate value="<%=new Date()%>" />

大家可以看到大陸和台灣顯示日期的格式是有差別的.

顯示結果:

2009-12-7

2009/12/7

<fmt:formatDate value="<%=new Date()%>" type="time"/>

顯示結果:

14:59:28

下午 02:59:28

type可取值及意義:

date 格式化日期

time格式化時間

both格式化日期時間

示例3：

<fmt:formatDate value="<%=new Date()%>" type="both" />

輸出結果:

2009-12-7 21:24:26

2009/12/7 下午 09:24:26

dateStyle用來設定日期顯示的樣式,其值可以是default, short, medium, long, full,請看示例:

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="default" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="short" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="medium" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="long" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="full" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="default" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="short" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="medium" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="long" />

<fmt:formatDate value="<%=new Date()%>" type="both" dateStyle="full" />

顯示結果如下:

2009-12-7 21:30:49

09-12-7 21:30:49

2009年12月7日 21:30:49

2009年12月7日星期一 21:30:49

可以看到dateStyle屬性隻對日期部分起作用,時間部分沒有作用.

timeStyle用來顯示時間部分的樣式,取值範圍同上

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="default" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="short" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="medium" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="long" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="full" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="default" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="short" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="medium" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="long" />

<fmt:formatDate value="<%=new Date()%>" type="both" timeStyle="full" />

輸出:

2009-12-7 21:35:52

2009-12-7 下午9:35

2009-12-7 下午09時35分52秒

2009-12-7 下午09時35分52秒 CST

timeZone用來設定時區,時區的意思類似于酒店裡大堂放的幾個時鐘,比如現在時間會有中原標準時間,東京時間,紐約時間,倫墩時間,

取值範圍為:EST, CST, MST, PST

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="EST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="CST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="MST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="PST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="EST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="CST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="MST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" timeZone="PST" />

輸出結果:

下午09時41分37秒 CST

上午08時41分37秒 EST

上午07時41分37秒 CST

上午06時41分37秒 MST

上午05時41分37秒 PST

七：<fmt:parseDate>

将字元串類型的時間轉換為日期類型.

value 用來格式化的時間或日期的字元串

type 指定格式化的是日期還是時間,或者兩者都是取值範圍:date,time,both

pattern 自定義格式化樣式

dateStyle 日期的格式化樣式

timeStyle 時間的格式化樣式

timeZone 指定使用的時區

var 存儲格式化後的結果

scope 指定存儲的範圍

示例:

<fmt:setLocale value="zh_cn" />

<fmt:parseDate type="date" value="2008-4-5"/>

輸出: Sat Apr 05 00:00:00 CST 2008,

這裡已經将字元串” 2008-4-5”轉換為了日期對象了.轉換一定得注意,類似于2008-4-5這樣的字元串,type必須為date,類似于12:34:56的字元串,type必須為time類似于2008-4-5 12:34:56這樣的字元串,type必須為both還要注意浏覽器的語言環境的設定,如果為zh_tw,那麼字元串就必須得符合當地的标準,如為2009/12/7 下午 09:24:26就正确轉換為日期對象,否則就會報錯.

八：<fmt:setTimeZone>

value 設定時區

var 存儲設定的時區

scope 存儲的範圍

value用來設定時區,可以是EST,CST,MST,PST等,如果有var屬性,則将結果存儲在所設定的範圍之内.在屬性範圍内的頁面都會使用該時區為預設時區.

<fmt:setTimeZone value="EST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" />

<fmt:setTimeZone value="EST" />

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" />

上午09時25分12秒 EST

此時區在該頁面内都有效

九：<fmt:timeZone>

用來暫時設定時區.

<fmt:timeZone value="EST">

</fmt:timeZone>

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" />

<fmt:timeZone value="EST">

</fmt:timeZone>

<fmt:formatDate value="<%=new Date()%>" type="time" timeStyle="full" />

此标簽的時區隻是部分,在标簽開始至标簽結束内有效,其它地方無效,其它地方還是會使用預設時區

<fn:> Function标簽庫

JSTL Functions 标簽庫中提供了一組常用的 EL 函數，主要用于處理字元串，在 JSP 中可以直接使用這些函數。

在 JSP 檔案中使用 Functions 标簽庫，要先通過 taglib 指令引入該标簽庫：

<%@taglib uri=”http://java.sun.com/jsp/jstl/functions” prefix=”fn” %.

18.1fn:contains 函數

fn:contains 函數用于判斷在源字元串中是否包含目标字元串，其文法為：

fn:contains(String source,String target) -------boolean;

以上 source 參數指定源字元串， target 參數指定目标字元串，傳回類型為 boolean 。

例如對于以下 EL 表達式：

${fn:contains(“Tomcat”,”cat”)}

${fn:contains(“Tomcat”,”CAT”)}

第一個 EL 表達式的值為 true ，第二個 EL 表達式的值為 false 。

18.2fn:containsIgnoreCase 函數

fn:containsIgnoreCase 函數用于判斷在源字元串中是否包含目标字元串，并且在判斷時忽略大小寫，其文法為：

fn: containsIgnoreCase (String source,String target) -------boolean;

${fn: containsIgnoreCase (“Tomcat”,”CAT”)}

${fn: containsIgnoreCase (“Tomcat”,”Mike”)}

18.3 fn:startsWith 函數

fn:startsWith 函數用于判斷源字元串是否以指定的目标字元串開頭，其文法為：

fn:startsWith(String source,String target) ----boolean

${fn: startsWith (“Tomcat”,”Tom”)}

${fn: startsWith (“Tomcat”,”cat”)}

18.4 fn:endsWith 函數

fn: endsWith 函數用于判斷源字元串是否以指定的目标字元串結尾，其文法為：

fn: endsWith (String source,String target) ----boolean

${fn: endsWith (“Tomcat”,”cat”)}

${fn: endsWith (“Tomcat”,”Tom”)}

18.5 fn:indexOf 函數

fn:indexOf 函數用于在源字元串中查找目标字元串，并傳回源字元串中最先與目标字元串比對的第一個字元的索引，如果在源字元串中不包含目标字元串，就傳回 -1 ，源字元串中的第一個字元的索引為 0 。 fn:indexOf 函數的文法為：

fn: indexOf (String source,String target) ----int

以上 source 參數指定源字元串， target 參數指定目标字元串，傳回類型為 int 。

1 ${fn: indexOf (“Tomcat”,”cat”)}

2 ${fn: indexOf (“2211221”,”21”)}

3 ${fn: indexOf (“Tomcat”,”Mike”)}

其輸出結果為：

1 3

2 1

3 -1

18.6 fn:replace 函數

fn:replace 函數用于把源字元串中的一部分替換為另外的字元串，并傳回替換後的字元串。 fn:replace 函數的文法為：

fn: replace (String source,String before,String after) ----String

以上 source 參數指定源字元串， before 參數指定源字元串中被替換的子字元串， after 參數指定用于替換的子字元串，傳回類型為 String 。

1 ${ fn: replace(“TomcAt”,”cAt”,”cat”)}

2 ${ fn: replace(“2008/1/9”,”/”,”-”)}

1 Tomcat

2 2008-1-9

18.7 fn:substring 函數

fn:substring 函數用于擷取源字元串中的特定子字元串，它的文法為：

fn:substring(String source,int beginIndex,int endIndex) ------String

以上 source 參數指定源字元串， beginIndex 參數表示子字元串中的第一個字元在源字元串中的索引，endIndex 參數表示子字元串的最後一個字元在源字元串中的索引加 1 ，傳回類型為 String ，源字元串中的第一個字元的索引為 0 。

1 ${ fn: substring (“Tomcat”,0,3)}

2 ${ fn: substring (“Tomcat”,3,”6”)}

1 Tom

2 cat

18.8 fn:substringBefore 函數

fn:substringBefore 函數用于擷取源字元串中指定子字元串之前的子字元串，其文法為：

fn:substringBefore(String source,String target) ----String

以上 source 參數指定源字元串， target 參數指定子字元串，傳回類型為 String 。如果在源字元串中不包含特定子字元串，就傳回空字元串。

1 ${ fn: substringBefore (“Tomcat”,”cat”)}

2 ${ fn: substringBefore (“mydata.txt”,”.txt”)}

2 mydata

18.9 fn:substringAfter 函數

fn: substringAfter 函數用于擷取源字元串中指定子字元串之後的子字元串，其文法為：

fn: substringAfter (String source,String target) ----String

1 ${ fn: substringAfter (“Tomcat”,”Tom”)}

2 ${ fn: substringAfter (“mydata.txt”,” mydata.”)}

1 cat

2 txt

18.10 fn:split 函數

fn:split 函數用于将源字元串拆分為一個字元串數組，其文法為：

fn: split (String source,String delimiter) ----String[]

以上 source 參數指定源字元串， delimiter 參數指定用于拆分源字元串的分隔符，傳回類型為 String[] 。如果在源字元串中不包含 delimiter 參數指定的分隔符，或者 delimiter 參數為 null ，那麼在傳回的字元串數組中隻有一個元素，為源字元串。

<c:set value=’${ fn: split (“www.mywebsite.org”,”.”)}’ var=”strs”/>

<c:forEach var=”token” item=”${strs}”>

${token}

</c:forEach>

其輸出結果為：

www

mywebsite

org

再例如對于以下代碼：

<c:set value=’${ fn: split (“www.mywebsite.org”,”-”)}’ var=”strs”/>

${strs[0]}

www.mywebsite.org

18.11 fn:join 函數

fn:join 函數用于将源字元串數組中的所有字元串連接配接為一個字元串，其文法為：

fn:join(String source[],String separator) ----String

以上 source 參數指定源字元串數組， separator 參數指定用于連接配接源字元串數組中的各個字元串的分隔符，傳回類型為 String 。

例如對于以下代碼：

String strs[] = {“www”,”mywebsite”,”org”};

<c:set value=”<%=strs%>” var=”strs”/>

${fn:join(strs,”.”)}

www. mywebsite. org

18.12 fn:toLowerCase 函數

fn:toLowerCase 函數用于将源字元串中的所有字元改為小寫，其文法為：

fn:toLowerCase(String source) -----String

以上 source 參數指定源字元串，傳回類型為 String 。

fn:toLowerCase(“TomCat”)

tomcat

18.13 fn:toUpperCase 函數

fn: toUpperCase 函數用于将源字元串中的所有字元改為大寫，其文法為：

fn: toUpperCase (String source) -----String

fn: toUpperCase (“TomCat”)

TOMCAT

18.14 fn:trim 函數

fn:trim 函數用于将源字元串中的開頭和末尾的空格删除，其文法為：

fn:trim(String source) ----String

fn:trim(“ Tomcat ”)

以上 EL 表達式的值為“ Tomcat ”。

18.15 fn:escapeXml 函數

fn:escapeXml 函數用于将源字元串中的字元“ < ”、“ > ”、“ ” ”和“ & ”等轉換為轉義字元，本書第 1 章的 1.2 節（ HTML 簡介）介紹了轉義字元的概念。 fn:escapeXml 函數的行為與 <c:out> 标簽的 escapeXml 屬性為 true 時的轉換行為相同， fn:escapeXml 函數的文法為：

fn:escapeXml(String source) ----String

例程 18-1 的 out.jsp 示範了 fn:escapeXml 函數的用法。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn"%>

<head>

</head>

<body>

1.${fn:escapeXml(" 表示粗體字 ") }

2.<c:out value=" 表示粗體字 " escapeXml="true"></c:out>

3.${" 表示粗體字 "}

</body>

</html>

對于 out.jsp 中的以下代碼：

1.${fn:escapeXml(" 表示粗體字 ") }

1. 表示粗體字

2. 表示粗體字

3. 表示粗體字

18.16 fn:length 函數

fn:length 函數用于傳回字元串中的字元的個數，或者集合和數組的元素的個數，其文法為：

fn:length(source) ---- int

以上 source 參數可以為字元串、集合或者數組，傳回類型為 int 。

<%@ page language="java" contentType="text/html; charset=UTF-8"

pageEncoding="UTF-8"%>

<%@page import="java.util.ArrayList"%>

<title>length</title>

int[] array = {1,2,3,4};

ArrayList list = new ArrayList();

list.add("one");

list.add("two");

list.add("three");

<c:set value="<%=array%>" var="array"></c:set>

<c:set value="<%=list%>" var="list"></c:set>

數組長度： ${fn:length(array)}

集合長度： ${fn:length(list)}

字元串長度： ${fn:length("Tomcat")}

Functions 标簽庫概覽

l fn:contains 函數：用于判斷在源字元串中是否包含目标字元串。

l fn:containsIgnoreCase 函數：用于判斷在源字元串中是否包含目标字元串，并且在判斷時忽略大小寫。

l fn:startsWith 函數：用于判斷源字元串是否以指定的目标字元串開頭。

l fn: endsWith 函數：用于判斷源字元串是否以指定的目标字元串結尾。

l fn:indexOf 函數：用于在源字元串中查找目标字元串，并傳回源字元串中最先與目标字元串比對的第一個字元的索引。

l fn:replace 函數：用于把源字元串中的一部分替換為另外的字元串，并傳回替換後的字元串。

l fn:substring 函數：用于擷取源字元串中的特定子字元串。

l fn:substringBefore 函數：用于擷取源字元串中指定子字元串之前的子字元串。

l fn: substringAfter 函數：用于擷取源字元串中指定子字元串之後的子字元串

l fn:split 函數：用于将源字元串拆分為一個字元串數組。

l fn:join 函數：用于将源字元串數組中的所有字元串連接配接為一個字元串。

l fn:toLowerCase 函數：用于将源字元串中的所有字元改為小寫。

l fn: toUpperCase 函數：用于将源字元串中的所有字元改為大寫。

l fn:trim 函數：用于将源字元串中的開頭和末尾的空格删除。

l fn:escapeXml 函數：用于将源字元串中的字元“ < ”、“ > ”、“ ” ”和“ & ”等轉換為轉義字元。

l fn:length 函數：用于傳回字元串中的字元的個數，或者集合和數組的元素的個數