JSTL functions

Functions   

   称呼 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")}<br>   

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

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

9.7.3  fn:containsIgnoreCase  函数  

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

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

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

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

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

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

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

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

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

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

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

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

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

前者返回“  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")}<br>   

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

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

9.7.9    分隔符函数 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  ”。  

9.7.10    替换函数 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  ”。  

9.7.11   分隔符转换数组函数 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}  。  

9.7.12    字符串截取函数 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  ”。  


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

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

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

截取的结果为“  A  ”。  

9.7.15   小写转换函数 fn:toLowerCase 函数 

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

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

转换的结果为“  abcd  ”。  

9.7.16   大写转换函数 fn:toUpperCase 函数 

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

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

转换的结果为“  ABCD  ”。  

9.7.17   空格删除函数 fn:trim 函数  

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

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

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