jstl functions标签详细使用说明

一.长度函数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”)}<br>

${fn:contains(”ABC”,“A”)}<br>

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

三. fn:containsIgnoreCase函数

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

${fn:containsIgnoreCase(”ABC”,“a”)}<br>

${fn:containsIgnoreCase(”ABC”,“A”)}<br>

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

四.词头判断函数fn:startsWith函数

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

${fn:startsWith (”ABC”,“ab”)}<br>

${fn:startsWith (”ABC”,“AB”)}<br>

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

五.词尾判断函数fn:endsWith函数

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

${fn:endsWith(”ABC”,“bc”)}<br>

${fn:endsWith(”ABC”,“BC”)}<br>

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

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

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

七.字符匹配函数fn:indexOf函数

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

${fn:indexOf(”ABCD”,”aBC”)}<br>

${fn:indexOf(”ABCD”,”BC”)}<br>

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

八.分隔符函数fn:join函数

fn:join函数允许为一个字符串数组中的每一个字符串加上分隔符，并连接起来。它的参数、返回结果和描述如表9.25所示：

表 9.25　fn:join函数

 

参数描述array字符串数组。其类型必须为 String[]类型separator分隔符。其类型必须为 String类型返回结果返回一个 String类型的值

下面看一个示例。

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

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

${fn:join(sessionScope.stringArray,”;”)}<br>

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

 

九.替换函数fn:replace函数

fn:replace函数允许为源字符串做替换的工作。它的参数、返回结果和描述如表9.26 所示：

表 9.26　fn:replace函数

 

参数描述inputString源字符串。其类型必须为 String类型beforeSubstring指定被替换字符串。其类型必须为 String类型afterSubstring指定替换字符串。其类型必须为 String类型返回结果返回一个 String类型的值

下面看一个示例。

${fn:replace(”ABC”,”A”,”B”)}<br>

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

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

fn:split函数用于将一组由分隔符分隔的字符串转换成字符串数组。它的参数、返回结果和描述如表9.27所示：

表 9.27　fn:split 函数

 

参数描述string源字符串。其类型必须为 String类型delimiters指定分隔符。其类型必须为 String类型返回结果返回一个 String[]类型的值

下面看一个示例。

${fn:split(”A,B,C”,”,”)}<br>

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

十一.字符串截取函数fn:substring函数

fn:substring函数用于截取字符串。它的参数、返回结果和描述如表9.28 所示：

表 9.28　fn:substring 函数

 

参数描述string源字符串。其类型必须为 String类型beginIndex指定起始下标（值从 0开始）。其类型必须为int类型endIndex指定结束下标（值从 0开始）。其类型必须为int类型返回结果返回一个 String类型的值

下面看一个示例。

${fn:substring(”ABC”,”1″,”2″)}<br>

截取结果为“ B”。

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

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

${fn:substringBefore(”ABCD”,”BC”)}<br>

截取的结果为“ A”。

十三.小写转换函数fn:toLowerCase函数

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

${fn:toLowerCase(”ABCD”)}<br>

转换的结果为“ abcd”。

十四.大写转换函数fn:toUpperCase函数

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

${fn:toUpperCase(”abcd”)}<br>

转换的结果为“ ABCD”。

十五.空格删除函数fn:trim函数

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

${fn:trim(”AB C“)}D<br>

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

函数名函数说明使用举例fn:contains判断字符串是否包含另外一个字符串<c:if test="${fn:contains(name, searchString)}">fn:containsIgnoreCase判断字符串是否包含另外一个字符串(大小写无关)<c:if test="${fn:containsIgnoreCase(name, searchString)}">fn:endsWith判断字符串是否以另外字符串结束<c:if test="${fn:endsWith(filename, ".txt")}">fn:escapeXml把一些字符转成XML表示，例如<字符应该转为&lt;${fn:escapeXml(param:info)}fn:indexOf子字符串在母字符串中出现的位置${fn:indexOf(name, "-")}fn:join将数组中的数据联合成一个新字符串，并使用指定字符格开${fn:join(array, ";")}fn:length获取字符串的长度，或者数组的大小${fn:length(shoppingCart.products)}fn:replace替换字符串中指定的字符${fn:replace(text, "-", "&#149;")}fn:split把字符串按照指定字符切分${fn:split(customerNames, ";")}fn:startsWith判断字符串是否以某个子串开始<c:if test="${fn:startsWith(product.id, "100-")}">fn:substring获取子串${fn:substring(zip, 6, -1)}fn:substringAfter

获取从某个字符所在位置开始的子串

${fn:substringAfter(zip, "-")}fn:substringBefore获取从开始到某个字符所在位置的子串${fn:substringBefore(zip, "-")}fn:toLowerCase转为小写${fn.toLowerCase(product.name)}fn:toUpperCase转为大写字符${fn.UpperCase(product.name)}fn:trim去除字符串前后的空格${fn.trim(name)}
 

函数

描述

fn:contains(string, substring)

如果参数string中包含参数substring，返回true

fn:containsIgnoreCase(string, substring)

如果参数string中包含参数substring（忽略大小写），返回true

fn:endsWith(string, suffix)

如果参数 string 以参数suffix结尾，返回true

fn:escapeXml(string)

将有特殊意义的XML (和HTML)转换为对应的XML character entity code，并返回

fn:indexOf(string, substring)

返回参数substring在参数string中第一次出现的位置

fn:join(array, separator)

将一个给定的数组array用给定的间隔符separator串在一起，组成一个新的字符串并返回。

fn:length(item)

返回参数item中包含元素的数量。参数Item类型是数组、collection或者String。如果是String类型,返回值是String中的字符数。

fn:replace(string, before, after)

返回一个String对象。用参数after字符串替换参数string中所有出现参数before字符串的地方，并返回替换后的结果

fn:split(string, separator)

返回一个数组，以参数separator 为分割符分割参数string，分割后的每一部分就是数组的一个元素

fn:startsWith(string, prefix)

如果参数string以参数prefix开头，返回true

fn:substring(string, begin, end)

返回参数string部分字符串, 从参数begin开始到参数end位置，包括end位置的字符

fn:substringAfter(string, substring)

返回参数substring在参数string中后面的那一部分字符串

fn:substringBefore(string, substring)

返回参数substring在参数string中前面的那一部分字符串

fn:toLowerCase(string)

将参数string所有的字符变为小写，并将其返回

fn:toUpperCase(string)

将参数string所有的字符变为大写，并将其返回

fn:trim(string)

去除参数string 首尾的空格，并将其返回