JSTL标签 参考手册

自定义格式:

-------------------------- Java代码







注意这里小时 hh表示12小时制, HH代表24小时制

示例1： -------------------------- Java代码

大家可以看到大陆和台湾显示日期的格式是有区别的. 显示结果: 2009-12-7 2009/12/7 示例2： -------------------------- Java代码

显示结果: 14:59:28 下午 02:59:28 type可取值及意义: date 格式化日期 time格式化时间 both格式化日期时间 示例3：

-------------------------- Java代码

输出结果: 2009-12-7 21:24:26 2009/12/7 下午 09:24:26 dateStyle用来设定日期显示的样式,其值可以是default, short, medium, long, full,请看示例: -------------------------- Java代码









显示结果如下: 2009-12-7 21:30:49 09-12-7 21:30:49 2009-12-7 21:30:49 2009年12月7日 21:30:49 2009年12月7日 星期一 21:30:49 可以看到dateStyle属性只对日期部分起作用,时间部分没有作用. timeStyle用来显示时间部分的样式,取值范围同上 -------------------------- Java代码









输出: 2009-12-7 21:35:52 2009-12-7 下午9:35 2009-12-7 21:35:52 2009-12-7 下午09时35分52秒 2009-12-7 下午09时35分52秒 CST timeZone用来设定时区,时区的意思类似于酒店里大堂放的几个时钟,比如现在时间会有北京时间,东京时间,纽约时间,伦墩时间, 取值范围为:EST, CST, MST, PST -------------------------- Java代码









输出结果: 下午09时41分37秒 CST 上午08时41分37秒 EST 上午07时41分37秒 CST 上午06时41分37秒 MST 上午05时41分37秒 PST七： ------------------------------------------------------------------- 将字符串类型的时间转换为日期类型. value 用来格式化的时间或日期的字符串 type 指定格式化的是日期还是时间,或者两者都是取值范围:date,time,both pattern 自定义格式化样式 dateStyle 日期的格式化样式 timeStyle 时间的格式化样式 timeZone 指定使用的时区 var 存储格式化后的结果 scope 指定存储的范围 示例: 输出: Sat Apr 05 00:00:00 CST 2008, 这里已经将字符串” 2008-4-5”转换为了日期对象了.转换一定得注意,类似于2008-4-5这样的字符串,type必须为date,类似于12:34:56的字符串,type必须为time类似于2008-4-5 12:34:56这样的字符串,type必须为both还要注意浏览器的语言环境的设置,如果为zh_tw,那么字符串就必须得符合当地的标准,如为2009/12/7 下午 09:24:26就正确转换为日期对象,否则就会报错.八： ------------------------------------------------------------------- value 设定时区 var 存储设定的时区 scope 存储的范围 value用来设定时区,可以是EST,CST,MST,PST等,如果有var属性,则将结果存储在所设定的范围之内.在属性范围内的页面都会使用该时区为默认时区. Java代码





输出: 上午09时25分12秒 EST 上午09时25分12秒 EST 上午09时25分12秒 EST 此时区在该页面内都有效九： ------------------------------------------------------------------- 用来暂时设置时区. Java代码



此标签的时区只是部分,在标签开始至标签结束内有效,其它地方无效,其它地方还是会使用默认时区

Function标签 库

==========================================================================

JSTL Functions 标签库中提供了一组常用的 EL 函数，主要用于处理字符串，在 JSP 中可以直接使用这些函数。

在 JSP 文件中使用 Functions 标签库，要先通过 taglib 指令引入该标签库：

<%@taglib uri=”http://java.sun.com/jsp/jstl/functions” prefix=”fn” %.

18.1fn:contains 函数

fn:contains 函数用于判断在源字符串中是否包含目标字符串，其语法为：

fn:contains(String source,String target) -------boolean;

以上 source 参数指定源字符串， target 参数指定目标字符串，返回类型为 boolean 。

例如对于以下 EL 表达式：

${fn:contains(“Tomcat”,”cat”)}

${fn:contains(“Tomcat”,”CAT”)}

第一个 EL 表达式的值为 true ，第二个 EL 表达式的值为 false 。

18.2fn:containsIgnoreCase 函数

fn:containsIgnoreCase 函数用于判断在源字符串中是否包含目标字符串，并且在判断时忽略大小写，其语法为：

fn: containsIgnoreCase (String source,String target) -------boolean;

以上 source 参数指定源字符串， target 参数指定目标字符串，返回类型为 boolean 。

例如对于以下 EL 表达式：

${fn: containsIgnoreCase (“Tomcat”,”CAT”)}

${fn: containsIgnoreCase (“Tomcat”,”Mike”)}

第一个 EL 表达式的值为 true ，第二个 EL 表达式的值为 false 。

18.3 fn:startsWith 函数

fn:startsWith 函数用于判断源字符串是否以指定的目标字符串开头，其语法为：

fn:startsWith(String source,String target) ----boolean

以上 source 参数指定源字符串， target 参数指定目标字符串，返回类型为 boolean 。

例如对于以下 EL 表达式：

${fn: startsWith (“Tomcat”,”Tom”)}

${fn: startsWith (“Tomcat”,”cat”)}

第一个 EL 表达式的值为 true ，第二个 EL 表达式的值为 false 。

18.4 fn:endsWith 函数

fn: endsWith 函数用于判断源字符串是否以指定的目标字符串结尾，其语法为：

fn: endsWith (String source,String target) ----boolean

以上 source 参数指定源字符串， target 参数指定目标字符串，返回类型为 boolean 。

例如对于以下 EL 表达式：

${fn: endsWith (“Tomcat”,”cat”)}

${fn: endsWith (“Tomcat”,”Tom”)}

第一个 EL 表达式的值为 true ，第二个 EL 表达式的值为 false 。

18.5 fn:indexOf 函数

fn:indexOf 函数用于在源字符串中查找目标字符串，并返回源字符串中最先与目标字符串匹配的第一个字符的索引，如果在源字符串中不包含目标字符串，就返回 -1 ，源字符串中的第一个字符的索引为 0 。 fn:indexOf 函数的语法为：

fn: indexOf (String source,String target) ----int

以上 source 参数指定源字符串， target 参数指定目标字符串，返回类型为 int 。

例如对于以下 EL 表达式：

1 ${fn: indexOf (“Tomcat”,”cat”)}

2 ${fn: indexOf (“2211221”,”21”)}

3 ${fn: indexOf (“Tomcat”,”Mike”)}

其输出结果为：

1 3

2 1

3 -1

18.6 fn:replace 函数

fn:replace 函数用于把源字符串中的一部分替换为另外的字符串，并返回替换后的字符串。 fn:replace 函数的语法为：

fn: replace (String source,String before,String after) ----String

以上 source 参数指定源字符串， before 参数指定源字符串中被替换的子字符串， after 参数指定用于替换的子字符串，返回类型为 String 。

例如对于以下 EL 表达式：

1 ${ fn: replace(“TomcAt”,”cAt”,”cat”)}

2 ${ fn: replace(“2008/1/9”,”/”,”-”)}

其输出结果为：

1 Tomcat

2 2008-1-9

18.7 fn:substring 函数

fn:substring 函数用于获取源字符串中的特定子字符串，它的语法为：

fn:substring(String source,int beginIndex,int endIndex) ------String

以上 source 参数指定源字符串， beginIndex 参数表示子字符串中的第一个字符在源字符串中的索引，endIndex 参数表示子字符串的最后一个字符在源字符串中的索引加 1 ，返回类型为 String ，源字符串中的第一个字符的索引为 0 。

例如对于以下 EL 表达式：

1 ${ fn: substring (“Tomcat”,0,3)}

2 ${ fn: substring (“Tomcat”,3,”6”)}

其输出结果为：

1 Tom

2 cat

18.8 fn:substringBefore 函数

fn:substringBefore 函数用于获取源字符串中指定子字符串之前的子字符串，其语法为：

fn:substringBefore(String source,String target) ----String

以上 source 参数指定源字符串， target 参数指定子字符串，返回类型为 String 。如果在源字符串中不包含特定子字符串，就返回空字符串。

例如对于以下 EL 表达式：

1 ${ fn: substringBefore (“Tomcat”,”cat”)}

2 ${ fn: substringBefore (“mydata.txt”,”.txt”)}

其输出结果为：

1 Tom

2 mydata

18.9 fn:substringAfter 函数

fn: substringAfter 函数用于获取源字符串中指定子字符串之后的子字符串，其语法为：

fn: substringAfter (String source,String target) ----String

以上 source 参数指定源字符串， target 参数指定子字符串，返回类型为 String 。如果在源字符串中不包含特定子字符串，就返回空字符串。

例如对于以下 EL 表达式：

1 ${ fn: substringAfter (“Tomcat”,”Tom”)}

2 ${ fn: substringAfter (“mydata.txt”,” mydata.”)}

其输出结果为：

1 cat

2 txt

18.10 fn:split 函数

fn:split 函数用于将源字符串拆分为一个字符串数组，其语法为：

fn: split (String source,String delimiter) ----String[]

以上 source 参数指定源字符串， delimiter 参数指定用于拆分源字符串的分隔符，返回类型为 String[] 。如果在源字符串中不包含 delimiter 参数指定的分隔符，或者 delimiter 参数为 null ，那么在返回的字符串数组中只有一个元素，为源字符串。

例如对于以下 EL 表达式：

${token}

其输出结果为：

www

mywebsite

org

再例如对于以下代码：

${strs[0]}

其输出结果为：

www.mywebsite.org

18.11 fn:join 函数

fn:join 函数用于将源字符串数组中的所有字符串连接为一个字符串，其语法为：

fn:join(String source[],String separator) ----String

以上 source 参数指定源字符串数组， separator 参数指定用于连接源字符串数组中的各个字符串的分隔符，返回类型为 String 。

例如对于以下代码：

<%

String strs[] = {“www”,”mywebsite”,”org”};

%>

” var=”strs”/>

${fn:join(strs,”.”)}

其输出结果为：

www. mywebsite. org

18.12 fn:toLowerCase 函数

fn:toLowerCase 函数用于将源字符串中的所有字符改为小写，其语法为：

fn:toLowerCase(String source) -----String

以上 source 参数指定源字符串，返回类型为 String 。

例如对于以下 EL 表达式：

fn:toLowerCase(“TomCat”)

其输出结果为：

tomcat

18.13 fn:toUpperCase 函数

fn: toUpperCase 函数用于将源字符串中的所有字符改为大写，其语法为：

fn: toUpperCase (String source) -----String

以上 source 参数指定源字符串，返回类型为 String 。

例如对于以下 EL 表达式：

fn: toUpperCase (“TomCat”)

其输出结果为：

TOMCAT

18.14 fn:trim 函数

fn:trim 函数用于将源字符串中的开头和末尾的空格删除，其语法为：

fn:trim(String source) ----String

以上 source 参数指定源字符串，返回类型为 String 。

例如对于以下 EL 表达式：

fn:trim(“ Tomcat ”)

以上 EL 表达式的值为“ Tomcat ”。

18.15 fn:escapeXml 函数

fn:escapeXml 函数用于将源字符串中的字符“ < ”、“ > ”、“ ” ”和“ & ”等转换为转义字符，本书第 1 章的 1.2 节（ HTML 简介）介绍了转义字符的概念。 fn:escapeXml 函数的行为与 标签的 escapeXml 属性为 true 时的转换行为相同， fn:escapeXml 函数的语法为：

fn:escapeXml(String source) ----String

以上 source 参数指定源字符串，返回类型为 String 。

例程 18-1 的 out.jsp 演示了 fn:escapeXml 函数的用法。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

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

<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn"%>

1.${fn:escapeXml(" 表示粗体字 ") }

2.

3.${" 表示粗体字 "}

对于 out.jsp 中的以下代码：

1.${fn:escapeXml(" 表示粗体字 ") }

2.

3.${" 表示粗体字 "}

其输出结果为：

1.<b> 表示粗体字 </b>

2.<b> 表示粗体字 </b>

3. 表示粗体字

18.16 fn:length 函数

fn:length 函数用于返回字符串中的字符的个数，或者集合和数组的元素的个数，其语法为：

fn:length(source) ---- int

以上 source 参数可以为字符串、集合或者数组，返回类型为 int 。

<%@ page language="java" contentType="text/html; charset=UTF-8"

pageEncoding="UTF-8"%>

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

<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn"%>

<%@page import="java.util.ArrayList"%>

<%

int[] array = {1,2,3,4};

ArrayList list = new ArrayList();

list.add("one");

list.add("two");

list.add("three");

%>

数组长度： ${fn:length(array)}

集合长度： ${fn:length(list)}

字符串长度： ${fn:length("Tomcat")}

Functions 标签库概览

l fn:contains 函数 ： 用于判断在源字符串中是否包含目标字符串。

l fn:containsIgnoreCase 函数 ： 用于判断在源字符串中是否包含目标字符串 ， 并且在判断时忽略大小写。

l fn:startsWith 函数 ： 用于判断源字符串是否以指定的目标字符串开头。

l fn: endsWith 函数：用于判断源字符串是否以指定的目标字符串结尾。

l fn:indexOf 函数：用于在源字符串中查找目标字符串，并返回源字符串中最先与目标字符串匹配的第一个字符的索引。

l fn:replace 函数：用于把源字符串中的一部分替换为另外的字符串，并返回替换后的字符串。

l fn:substring 函数：用于获取源字符串中的特定子字符串。

l fn:substringBefore 函数：用于获取源字符串中指定子字符串之前的子字符串。

l fn: substringAfter 函数：用于获取源字符串中指定子字符串之后的子字符串

l fn:split 函数：用于将源字符串拆分为一个字符串数组。

l fn:join 函数：用于将源字符串数组中的所有字符串连接为一个字符串。

l fn:toLowerCase 函数：用于将源字符串中的所有字符改为小写。

l fn: toUpperCase 函数：用于将源字符串中的所有字符改为大写。

l fn:trim 函数：用于将源字符串中的开头和末尾的空格删除。

l fn:escapeXml 函数：用于将源字符串中的字符“ < ”、“ > ”、“ ” ”和“ & ”等转换为转义字符。

l fn:length 函数：用于返回字符串中的字符的个数，或者集合和数组的元素的个数