jstl fn函数总结

来源：互联网发布：js求log以10为底编辑：程序博客网时间：2024/06/05 16:31

URI: http://java.sun.com/jsp/jstl/functions

前缀 : fn

　　称呼 Functions 标签库为标签库，倒不如称呼其为函数库来得更容易理解些。因为 Functions 标签库并没有提供传统的标签来为 JSP 页面的工作服务，而是被用于 EL 表达式语句中。在 JSP2.0 规范下出现的 Functions 标签库为 EL 表达式语句提供了许多更为有用的功能。 Functions 标签库分为两大类，共 16 个函数。

　　字符串处理函数： fn:contains 、 fn:containsIgnoreCase 、 fn:endsWith 、 fn:escapeXml 、 fn:indexOf 、 fn:join 、 fn:replace 、 fn:split 、 fn:startsWith 、 fn:substring 、 fn:substringAfter 、 fn:substringBefore 、 fn:toLowerCase 、 fn:toUpperCase 、 fn:trim

以下是各个函数的用途和属性以及简单示例。

长度函数 fn:length 函数

　　长度函数 fn:length 的出现有重要的意义。在 JSTL1.0 中，有一个功能被忽略了，那就是对集合的长度取值。虽然 java.util.Collection 接口定义了 size 方法，但是该方法不是一个标准的 JavaBean 属性方法（没有 get,set 方法），因此，无法通过 EL 表达式“ ${collection.size} ”来轻松取得。

　　fn:length 函数正是为了解决这个问题而被设计出来的。它的参数为 input ，将计算通过该属性传入的对象长度。该对象应该为集合类型或 String 类型。其返回结果是一个 int 类型的值。下面看一个示例。

<%ArrayList arrayList1 = new ArrayList();

arrayList1.add("aa");

arrayList1.add("bb");

arrayList1.add("cc");

<%request.getSession().setAttribute("arrayList1", arrayList1);%>

${fn:length(sessionScope.arrayList1)}

假设一个 ArrayList 类型的实例“ arrayList1 ”，并为其添加三个字符串对象，使用 fn:length 函数后就可以取得返回结果为“ 3 ”。

判断函数 fn:contains 函数

　　fn:contains 函数用来判断源字符串是否包含子字符串。它包括 string 和 substring 两个参数，它们都是 String 类型，分布表示源字符串和子字符串。其返回结果为一个 boolean 类型的值。下面看一个示例。

${fn:contains("ABC", "a")}

${fn:contains("ABC", "A")}

前者返回“ false ”，后者返回“ true ”。

fn:containsIgnoreCase 函数

　　fn:containsIgnoreCase 函数与 fn:contains 函数的功能差不多，唯一的区别是 fn:containsIgnoreCase 函数对于子字符串的包含比较将忽略大小写。它与 fn:contains 函数相同，包括 string 和 substring 两个参数，并返回一个 boolean 类型的值。下面看一个示例。

${fn:containsIgnoreCase("ABC", "a")}

${fn:containsIgnoreCase("ABC", "A")}

前者和后者都会返回“ true ”。

词头判断函数 fn:startsWith 函数

　　fn:startsWith 函数用来判断源字符串是否符合一连串的特定词头。它除了包含一个 string 参数外，还包含一个 subffx 参数，表示词头字符串，同样是 String 类型。该函数返回一个 boolean 类型的值。下面看一个示例。

${fn:startsWith ("ABC", "ab")}

${fn:startsWith ("ABC", "AB")}

前者返回“ false ”，后者返回“ true ”。

词尾判断函数 fn:endsWith 函数

　　fn:endsWith 函数用来判断源字符串是否符合一连串的特定词尾。它与 fn:startsWith 函数相同，包括 string 和 subffx 两个参数，并返回一个 boolean 类型的值。下面看一个示例。

${fn:endsWith("ABC", "bc")}

${fn:endsWith("ABC", "BC")}

前者返回“ false ”，后者返回“ true ”。

字符实体转换函数 fn:escapeXml 函数

　　fn:escapeXml 函数用于将所有特殊字符转化为字符实体码。它只包含一个 string 参数，返回一个 String 类型的值。

字符匹配函数 fn:indexOf 函数

　　fn:indexOf 函数用于取得子字符串与源字符串匹配的开始位置，若子字符串与源字符串中的内容没有匹配成功将返回“ -1 ”。它包括 string 和 substring 两个参数，返回结果为 int 类型。下面看一个示例。

${fn:indexOf("ABCD","aBC")}

${fn:indexOf("ABCD","BC")}

前者由于没有匹配成功，所以返回 -1 ，后者匹配成功将返回位置的下标，为 1 。

分隔符函数 fn:join 函数

fn:join 函数允许为一个字符串数组中的每一个字符串加上分隔符，并连接起来。它的参数、返回结果：
array
字符串数组。其类型必须为 String[] 类型

separator
分隔符。其类型必须为 String 类型

返回结果
返回一个 String 类型的值

下面看一个示例。

<% String[] stringArray = {"a","b","c"}; %>

<%request.getSession().setAttribute("stringArray", stringArray);%>

${fn:join(sessionScope.stringArray,";")}

定义数组并放置到 Session 中，然后通过 Session 得到该字符串数组，使用 fn:join 函数并传入分隔符“ ; ”，得到的结果为“ a;b;c ”。

替换函数 fn:replace 函数

fn:replace(inputString,beforeString,afterString) 函数允许为源字符串做替换的工作。它的参数、返回结果：

inputString   源字符串。其类型必须为 String 类型

beforeSubstring   指定被替换字符串。其类型必须为 String 类型

afterSubstring   指定替换字符串。其类型必须为 String 类型

返回一个 String 类型的值

下面看一个示例。

${fn:replace("ABC","A","B")}

将“ ABC ”字符串替换为“ BBC ”，在“ ABC ”字符串中用“ B ”替换了“ A ”。

分隔符转换数组函数 fn:split 函数

fn:split 函数用于将一组由分隔符分隔的字符串转换成字符串数组。它的参数、返回结果：

fn:split(resString,delimiters) 函数

resString 源字符串。其类型必须为 String 类型

delimiters 指定分隔符。其类型必须为 String 类型

返回一个 String[] 类型的值

下面看一个示例。

${fn:split("A,B,C",",")}

将“ A,B,C ”字符串转换为数组 {A,B,C} 。

字符串截取函数 fn:substring 函数

fn:substring 函数用于截取字符串。它的参数、返回结果：

fn:substring(string,beginIndex,endIndex) 函数

string 源字符串。其类型必须为 String 类型

beginIndex 指定起始下标（值从 0 开始）。其类型必须为 int 类型

endIndex 指定结束下标（值从 0 开始）。其类型必须为 int 类型

返回一个 String 类型的值

下面看一个示例。

${fn:substring("ABC","1","2")}

截取结果为“ B ”。

起始到定位截取字符串函数 fn:substringBefore 函数

fn:substringBefore 函数允许截取源字符从开始到某个字符串。它的参数和 fn:substringAfter 函数相同，不同的是 substring 表示的是结束字符串。下面看一个示例。

${fn:substringBefore("ABCD","BC")}

截取的结果为“ A ”。

小写转换函数 fn:toLowerCase 函数

fn:toLowerCase 函数允许将源字符串中的字符全部转换成小写字符。它只有一个表示源字符串的参数 string ，函数返回一个 String 类型的值。下面看一个示例。

${fn:toLowerCase("ABCD")}

转换的结果为“ abcd ”。

大写转换函数 fn:toUpperCase 函数

fn:toUpperCase 函数允许将源字符串中的字符全部转换成大写字符。它与 fn:toLowerCase 函数相同，也只有一个 String 参数，并返回一个 String 类型的值。下面看一个示例。

${fn:toUpperCase("abcd")}

转换的结果为“ ABCD ”。

空格删除函数 fn:trim 函数

fn:trim 函数将删除源字符串中结尾部分的“空格”以产生一个新的字符串。它与 fn:toLowerCase 函数相同，只有一个 String 参数，并返回一个 String 类型的值。下面看一个示例。

${fn:trim("AB C ")}D

转换的结果为“ AB CD ”，注意，它将只删除词尾的空格而不是全部，因此“ B ”和“ C ”之间仍然留有一个空格。

*********************************************************************************************************************************************************

另外还有，jstl格式化日期的实例：
JSP Standard Tag Libraries
Formatting and Internationalization
Two form input parameters, 'date' and 'isoDate', are URL-encoded in the link leading to this page. 'isoDate' is formatted according to the ISO8601 standard.
Formatting of numbers and dates is based on the browser's locale setting. Formatting will change if you switch the default language setting from English to French or German, for example. (The browser needs to be restarted, too.)

Library import and parameter capturing:

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

<fmt:parseDate value="${param.date}" var="date" pattern="yyyy/MM/dd:HH:mm:ss>
<fmt:parseDate value="${param.isoDate}" var="isoDate" pattern="yyyyMMdd'T'HHmmss">

The input parameters must match the patterns, or the JSP will thrown an exception. This page does no error handling.

Input parameters:
Date: 2004/04/01:13:30:00 Java format: Thu Apr 01 13:30:00 CST 2004
isoDate: 20040531T235959 Java format: Mon May 31 23:59:59 CDT 2004

Dates
Tag Output
Attribute: value; required. Tag has no body.
<fmt:formatDate value="${date}" type="both"/>

2004-4-1 13:30:00
<fmt:formatDate value="${isoDate}" type="both"/>

2004-5-31 23:59:59
Attribute: type; optional. Indicates what to print: date, time, or both.
<fmt:formatDate value="${date}" type="date"/>

2004-4-1
<fmt:formatDate value="${isoDate}" type="time"/>

23:59:59
Attribute: dateStyle; optional. Varies the date format.
<fmt:formatDate value="${isoDate}" type="date" dateStyle="default"/>

2004-5-31
<fmt:formatDate value="${isoDate}" type="date" dateStyle="short"/>

04-5-31
<fmt:formatDate value="${isoDate}" type="date" dateStyle="medium"/>

2004-5-31
<fmt:formatDate value="${isoDate}" type="date" dateStyle="long"/>

2004年5月31日
<fmt:formatDate value="${isoDate}" type="date" dateStyle="full"/>

2004年5月31日星期一
Attribute: timeStyle; optional. Varies the time format.
<fmt:formatDate value="${isoDate}" type="time" timeStyle="default"/>

23:59:59
<fmt:formatDate value="${isoDate}" type="time" timeStyle="short"/>

下午11:59
<fmt:formatDate value="${isoDate}" type="time" timeStyle="medium"/>

23:59:59
<fmt:formatDate value="${isoDate}" type="time" timeStyle="long"/>

下午11时59分59秒
<fmt:formatDate value="${isoDate}" type="time" timeStyle="full"/>

下午11时59分59秒 CDT
Attribute: pattern; optional. Inidcates date/time custom patterns.
<fmt:formatDate value="${date}" type="both" pattern="EEEE, MMMM d, yyyy HH:mm:ss Z"/>

星期四, 四月 1, 2004 13:30:00 -0600
<fmt:formatDate value="${isoDate}" type="both" pattern="d MMM yy, h:m:s a zzzz/>

31 五月 04, 11:59:59 下午中央夏令时