jstl 中function的使用

jstl中function的使用比较特殊，它不是以“标签”的形式出现的（很多初学者都以为是<fn:.....>的形式），而是通常和el表达式一起使用

 

<taglib>
         <taglib-uri>http://java.sun.com/jstl/fn</taglib-uri>
         <taglib-location>/WEB-INF/fn.tld</taglib-location>
</taglib>

长度函数： 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

JSP 页面上：

<%@ taglib uri="/WEB-INF/fn.tld" prefix="fn" %>

${fn:toUpperCase("sdjkhjshjhjd") }

这个例子将输出 这些字母的大写字母

一.长度函数 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>

转换的结果为“ AB CD ”，注意，它将只删

 转自：http://blog.sina.com.cn/s/blog_879d7fbe01011p33.html

自定义JSTL函数标签

 (2011-12-06 20:59:07)

转载▼

标签： 

杂谈

 分类： it技术

转自：http://hi.baidu.com/bailang3106/blog/item/e03c69f0e26957ca7931aab9.html

http://wallimn.iteye.com/blog/364732

自定义JSTL标签函数，方便页面的调用，通过调用函数返回数据进行页面显示。简单、方便，在开发中时常用的到。

jstl标签库的配置
* 将jstl.jar和standard.jar拷贝到WEB-INF/lib下（如果使用el表达式，不用拷贝这两个jar）

注意：jstl必须在能够支持j2ee1.4/servlet2.4/jsp2.0版本上的容器才能运行，这个环境
      是目前较为常用的环境

     
标签库的使用
* 采用taglib指令引入
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt"%>

  
自定义函数库：
1、定义类和方法（方法必须是public static）
2、编写自定义tld文件，并且将此文件放到WEB-INF或WEB-INF任意子目录下
3、在jsp中采用taglib指令引入自定义函数库
4、采用 前缀+冒号（:）+函数名 调用即可

以下通过显示省份来看实现步骤：


第一步：新建一个类如下：
UtilFunction.java

Java代码

1. package demo;   
2.   
3. import java.util.ArrayList;   
4. import java.util.List;   
5.   
6. // 测试   
7. // 自定义JSTL函数   
8. public class UtilFunction {   
9.     // 获取省份   
10.     public static List getProvinces() {   
11.          List provinces = new ArrayList();   
12.            
13.         // 暂时添加几个测试   
14.          provinces.add("广东省");   
15.          provinces.add("广西省");   
16.          provinces.add("山东省");   
17.          provinces.add("四川省");   
18.          provinces.add("江西省");   
19.            
20.         return provinces;      
21.      }      
22. }  

第二步：编写tld标签函数注册文件
myfunctions.tld

Xml代码

1. <?xml version="1.0" encoding="UTF-8" ?>  
2.   
3. <taglib xmlns="http://java.sun.com/xml/ns/j2ee"  
4.   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
5.   xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"  
6.   version="2.0">  
7.        
8.   <tlib-version>1.0</tlib-version>  
9.   <short-name>my</short-name>  
10.   <uri>http://www.changtusoft.cn/test/functions</uri>   (其中，若uri为/WEB-INF/xxx.tld，则无需再下面tomcat中注册)
11.      
12.   <!-- JSTL自定义函数   获取省份 -->  
13.   <function>  
14.     <name>getProvinces</name>  
15.     <function-class>demo.UtilFunction</function-class>  
16.     <function-signature>java.util.List getProvinces()</function-signature>  
17.   </function>  
18. </taglib>  

第三步：在web.xml文件中注册tld

Xml代码

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app version="2.5"   
3.     xmlns="http://java.sun.com/xml/ns/javaee"   
4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
5.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee   
6.      http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  
7.   <welcome-file-list>  
8.     <welcome-file>index.jsp</welcome-file>  
9.   </welcome-file-list>  
10.      
11.   <!-- 注册JSTL函数 -->  
12.   <jsp-config>  
13.     <taglib>  
14.         <taglib-uri>http://www.changtusoft.cn/test/functions</taglib-uri>  
15.         <taglib-location>/WEB-INF/myfunctions.tld</taglib-location>  
16.     </taglib>  
17.   </jsp-config>  
18.      
19. </web-app>  

第四步：编写jsp进行测试
index.jsp

Java代码

1. <%@ page language="java" import="java.util.*" pageEncoding="gbk"%>   
2. <!-- 导入jstl标签库 -->   
3. <%@ taglib prefix="c"   uri="http://java.sun.com/jsp/jstl/core" %>   
4. <!-- 导入自定义jstl函数 -->   
5. <%@ taglib prefix="my" uri="http://www.changtusoft.cn/test/functions" %>   
6.   
7. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">   
8. <html>   
9.    <head>   
10.      <title>自定义JSTL函数</title>   
11.    </head>   
12.      
13.    <body>   
14.      省份：   
15.      <select name="provinces">   
16.      <option>--请选择省份--</option>   
17.      <c:forEach items="${my:getProvinces()}" var="p">   
18.          <option>${p }</option>   
19.      </c:forEach>   
20.      </select>   
21.    </body>   
22. </html>  

部署例子到tomcat测试： http://localhost:8080/jstl_functions/index.jsp

结果可以显示省份下拉框表示成功...

注意：

  

可能出现的异常

1、The function xxx must be used with a prefix when a default namespace is not specified

--- 在jsp页面中调用方式不正确，可能将 ":" 写成了 "."

2、The function xxx cannot be located with the specified prefix

--- a) 类中定义的方法不是 public static 的方法

      b) 类中的方法名称和jsp自带的标签元素冲突，重名等