JSTL中的 FN函数

ゝ一纸荒年。 2022-07-12 11:58 181阅读 0赞

问题引出：

jstl 写出 集合的size

在jstl中的fn标签也是我们在网页设计中经常要用到的很关键的标签，在使用的时候要先加 上头

<%@ taglib uri="[http://java.sun.com/jsp/jstl/functions ][http_java.sun.com_jsp_jstl_functions] " prefix="fn"%>就可以使用fn标签了。

具体使用方法请参见下表：

<table> 
 <tbody> 
 <tr> 
 <td> &nbsp; 函数 </td> 
 <td> &nbsp; 描述 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:contains(string, substring) </td> 
 <td> &nbsp; 如果参数string中包含参数substring，返回true </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:containsIgnoreCase(string, substring) </td> 
 <td> &nbsp; 如果参数string中包含参数substring（忽略大小写），返回true </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:endsWith(string, suffix) </td> 
 <td> &nbsp; 如果参数 string 以参数suffix结尾，返回true </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:escapeXml(string) </td> 
 <td> &nbsp; 将有特殊意义的XML (和HTML)转换为对应的XML character entity code，并返回 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:indexOf(string, substring) </td> 
 <td> &nbsp; 返回参数substring在参数string中第一次出现的位置 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:join(array, separator) </td> 
 <td> &nbsp; 将一个给定的数组array用给定的间隔符separator串在一起，组成一个新的字符串 并返回。 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:length(item) </td> 
 <td> &nbsp; 返回参数item中包含元素的数量。参数Item类型是数组、collection或者 String。如果是String类型,返回值是String中的字符数。 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:replace(string, before, after) </td> 
 <td> &nbsp; 返回一个String对象。用参数after字符串替换参数string中所有出现参数 before字符串的地方，并返回替换后的结果 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:split(string, separator) </td> 
 <td> &nbsp; 返回一个数组，以参数separator 为分割符分割参数string，分割后的每一部分就是数组的一个元素 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:startsWith(string, prefix) </td> 
 <td> &nbsp; 如果参数string以参数prefix 开头，返回true </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:substring(string, begin, end) </td> 
 <td> &nbsp; 返回参数string部分字符串, 从参数begin开始到参数end位置，包括end位置的字符 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:substringAfter(string, substring) </td> 
 <td> &nbsp; 返回参数substring在参数string中后面的那一部分字符串 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:substringBefore(string, substring) </td> 
 <td> &nbsp; 返回参数substring在参数string中前面的那一部分字符串 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:toLowerCase(string) </td> 
 <td> &nbsp; 将参数string所有的字符变为小写，并将其返回 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:toUpperCase(string) </td> 
 <td> &nbsp; 将参数string所有的字符变为大写，并将其返回 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; fn:trim(string) </td> 
 <td> &nbsp; 去除参数string 首尾的空格，并将其返回 </td> 
 </tr> 
 </tbody> 
</table>

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

长度函数：fn:length

字符串处理函数：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

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

9.7.1 长度函数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”。

9.7.2 判断函数fn:contains函数

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

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

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

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

9.7.3 fn:containsIgnoreCase函数

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

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

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

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

9.7.4 词头判断函数fn:startsWith函数

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

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

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

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

9.7.5 词尾判断函数fn:endsWith函数

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

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

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

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

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

9.7.8 字符匹配函数fn:indexOf函数

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

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

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

9.7.9 分隔符函数fn:join函数

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

表9.25　fn:join函数

<table> 
 <tbody> 
 <tr> 
 <td> &nbsp; 参数 </td> 
 <td> &nbsp; 描述 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; array </td> 
 <td> &nbsp; 字符串数组。其类型必须为String[]类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; separator </td> 
 <td> &nbsp; 分隔符。其类型必须为String类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; 返回结果 </td> 
 <td> &nbsp; 返回一个String类型的值 </td> 
 </tr> 
 </tbody> 
</table>

下面看一个示例。

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

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

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

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

9.7.10 替换函数fn:replace函数

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

表9.26　 fn:replace函数

<table> 
 <tbody> 
 <tr> 
 <td> &nbsp; 参数 </td> 
 <td> &nbsp; 描述 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; inputString </td> 
 <td> &nbsp; 源字符串。其类型必须为String类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; beforeSubstring </td> 
 <td> &nbsp; 指定被替换字符串。其类型必须为String类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; afterSubstring </td> 
 <td> &nbsp; 指定替换字符串。其类型必须为String类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; 返回结果 </td> 
 <td> &nbsp; 返回一个String类型的值 </td> 
 </tr> 
 </tbody> 
</table>

下面看一个示例。

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

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

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

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

表9.27　 fn:split函数

<table> 
 <tbody> 
 <tr> 
 <td> &nbsp; 参数 </td> 
 <td> &nbsp; 描述 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; string </td> 
 <td> &nbsp; 源字符串。其类型必须为String类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; delimiters </td> 
 <td> &nbsp; 指定分隔符。其类型必须为String类型 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; 返回结果 </td> 
 <td> &nbsp; 返回一个String[]类型的值 </td> 
 </tr> 
 </tbody> 
</table>

下面看一个示例。

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

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

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

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

表9.28　 fn:substring函数

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

下面看一个示例。

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

截取结果为“B”。

[http_java.sun.com_jsp_jstl_functions]: http://java.sun.com/jsp/jstl/functions