JSP标准标签库(JavaServer Pages Standard Tag Library,JSTL)是一个定制标签库的集合,用来解决 像遍历Map或集合、条件测试、XML处理,甚至数据 库访问和数据操作等常见的问题。
一.下载
- 官方下载地址:http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/
- 菜鸟下载地址:jakarta-taglibs-standard-1.1.2.zip
下载 jakarta-taglibs-standard-1.1.2.zip 包并解压,将 jakarta-taglibs-standard-1.1.2/lib/ 下的两个 jar 文件:standard.jar 和 jstl.jar 文件拷贝到 /WEB-INF/lib/ 下。
将 tld 包复制到 WEB-INF 目录下。使用任何库,你必须在每个 JSP 文件中的头部包含 <taglib> 标签。
接下来我们在 web.xml 文件中添加以下配置:
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="4.0" xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"> <display-name>app04a</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<jsp-config>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/fmt</taglib-uri>
<taglib-location>/WEB-INF/lib/fmt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/fmt-rt</taglib-uri>
<taglib-location>/WEB-INF/lib/fmt-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/core</taglib-uri>
<taglib-location>/WEB-INF/lib/c.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/core-rt</taglib-uri>
<taglib-location>/WEB-INF/lib/c-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/sql</taglib-uri>
<taglib-location>/WEB-INF/lib/sql.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/sql-rt</taglib-uri>
<taglib-location>/WEB-INF/lib/sql-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/x</taglib-uri>
<taglib-location>/WEB-INF/lib/x.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jsp/jstl/x-rt</taglib-uri>
<taglib-location>/WEB-INF/lib/x-rt.tld</taglib-location>
</taglib>
</jsp-config> </web-app>
二. JSTL库
JSTL是标准标签库,但它是通过多个标签库来暴 露其行为的。JSTL 1.2中的标签可以分成5类区域,如 表所示。
区域 | 子函数 | URI | 前缀 |
---|---|---|---|
核心 | 变量支持 | http://java.sun.com/jsp/jstl/core | c |
流控制 | |||
URL管理 | |||
其他 | |||
核心 | http://java.sun.com/jsp/jstl/xml | x | |
流控制 | |||
转换 | |||
语言区域 | http://java.sun.com/jsp/jstl/fmt | fmt | |
消息格式化 | |||
数字和日期格式化 | |||
数据库 | SQL | http://java.sun.com/jsp/jstl/sql | sql |
集合长度 | http://java.sun.com/jsp/jstl/functions | fn | |
字符串操作 |
在JSP页面中使用JSTL库,必须通过以下格式使用 taglib指令:
<%@ taglib uri="uri" prefix="prefix" %>
例如,要使用Core库,必须在JSP页面的开头处做 以下声明:
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
注:
属性名称后面的星号(*)表 示该属性是必需的。加号(+)表示该属性的rtexprvalue值为True,这 意味着该属性可以赋静态字符串或者动态值(Java表达式、EL表达式 或者通过设置的值)。rtexprvalue值为False时,表示该属 性只能赋静态字符串的值。
三: 一般行为
1. out标签
out标签在运算表达式时,是将结果输出到当前的 JspWriter。out的语法有两种形式,即有body content和 没有body content:
<c:out value="value" [escapeXml="{true|false}"]
[default="defaultValue"]/>
<c:out value="value" [escapeXml="{true|false}"]>
default value
</c:out
注意;
在标签的语法中,[]表示可选的属性。如果值带下划线,则表示为 默认值。
属性 | 类型 | 描述 |
value*+ | 对象 | 要计算的表达式 |
escapeXml+ | 布尔 | 表示结果中的字符<,>,&,',"将被转换成相应的实体码,如<转换成lt;等等 |
default+ | 对象 | 默认值 |
例如:
<c:out value="${header. cookie}" />
默认情况下,out会将特殊字符<、>、 ' 、 "和&分别 编写成它们相应的字符实体码 <、 >、'、 "和&。
在JSP 2.0版本前,out标签是用于输出有界对象值 的最容易的方法。在JSP 2.0及其更高的版本中,除非 需要对某个值进行XML转义,否则可以放心地使用EL 表达式:
转义和未转义的效果:
<c:out value="${'<'}" />
${'<'}
out中的default属性可以赋一个默认值,当赋予其 value属性的EL表达式返回null时,就会显示默认值。 default属性可以赋动态值,如果这个动态值返回null, out就会显示一个空的字符串。 例如,在下面的out标签中,如果在HttpSession中 没有找到myVar变量,就会显示应用程序范围的变量 myVar值。如果没有找到,则输出一个空的字符串:
<br />
<c:out value="${sessionScope.myvar}" default="${'I am defualt value' }"/>
<br />
${'<'}
</body>
2.set标签
利用set标签,可以完成以下工作:
(1)创建一个字符串和一个引用该字符串的有界 变量。
(2)创建一个引用现存有界对象的有界变量。
(3)设置有界对象的属性。
如果用set创建有界变量,那么,在该标签出现后 的整个JSP页面中都可以使用该变量。
set标签的语法有4种形式。
i)第一种形式用于创建一 个有界变量,并用value属性在其中定义一个要创建的 字符串或者现存有界对象:
<c:set value="value" var="varName"
[scope="{page|request|session|application}"]/>
这里的scope 属性指定了有界变量的范围。
例如;下面的例子创建了job变量,并引用
<br />
<c:set var="job" value="${requestScope }" scope="page" />
<c:out value="${job }" default="${'I am defualt value' }"/>
<br />
${'<'}
</body>
</html>
ii)第二种形式与第一种形式相似,只是要创建的字符 串或者要引用的有界对象是作为body content赋值的:
<c:set var="varName" [scope="{page|request|session|application}
"]>
body content
</c:set>
例如 employee是自己添加的session
<c:set var="employee" scope="request" >我是employee的值</c:set> <c:out value="${requestScope.employee}" default="${'I am defualt value' }"/>
<br />
${'<'}
</body>
</html>
iii) 第三种形式是设置有界对象的属性值。target属性 定义有界对象,以及有界对象的property属性。对该属 性的赋值是通过value属性进行的:
<c:set target="target" property="propertyName" value="value"/>
例
servlet
Map<String, String> capitals = new HashMap<String,String>();
capitals.put("China" ,"Beijing");
capitals.put("Austria","Vienna");
capitals.put("Australia","Canberra");
capitals.put("Canada","Ottua");
jsp
<c:set target="${capitals}" property= "Canada" value="Tokyo" /> <c:out value="${capitals}" default="${'I am defualt value' }"/>
浏览器
iv)第四种形式和第三种形式类似,只是赋值时作为body content 完成的:
<c:set target="target" property="propertyName">
body content
</c:set>
例:
jsp页面
<c:set target="${capitals}" property= "Canada" >Tokyo2</c:set>
<c:out value="${capitals}" default="${'I am defualt value' }"/>
<br />
浏览器
set标签的属性如下表所示。
属性 | 类型 | 描述 | |
value+ | 对象 | 要创建的字符串,或者要引用的有界对象,或者新的属性值 | |
var | 字符串 | 要创建的有界变量 | |
scope | 字符串 | 新创建的有界变量的范围 | |
target+ | 对象 | 其属性要被赋新值的有界对象,这必须是一个JavaBeans实例或者java.util.Map对象 | |
property+ | 字符串 | 要被赋新值的属性名称 |
3. remove标签
remove标签用于删除有界变量,注意,有界变量引用的对象不能删除。因此,如果 另一个有界对象也引用了同一个对象,仍然可以通过另 一个有界变量访问该对象。其语法如下:
<c:remove var="varName"
[scope="{page|request|session|application}"]/>
例:
jsp页面
<c:remove var="capitals" scope="request" />
<c:out value="${capitals}" default="${'I am defualt value' }"/>
<br />
${'<'}
</body>
浏览器
类 | 描 | |
a | 字符 | 要删除的有界变量的名 |
cope | 字符 | 要删除的有界变量的范 |
四.条件行为
条件行为用于处理页面输出取决于特定输入值的情 况,这在Java中是利用if、if...else和switch声明解决的。 JSTL中执行条件行为的有4个标签,即if、 choose、when和otherwise标签。
1. if标签
if标签是对某一个条件进行测试,假如结果为 True,就处理它的body content。测试结果保存在 Boolean对象中,并创建有界变量来引用这个Boolean对 象。利用var属性和scope属性分别定义有界变量的名称 和范围。 if的语法有两种形式。
i) 第一种形式没有body content:
<c:if test="testCondition" var="varName"
[scope="{page|request|session|application}"]/>
例:
jsp页面
<c:if test="${capitals.Canada eq 'shanghai'}" var="testvar" scope="request" />
<c:out value="${testvar}" default="${'I am defualt value' }"/>
<br />
${'<'}
</body>
</html>
浏览器
ii) 第二种形式中使用了一个body content:
<c:if test="testCondition [var="varName"]
[scope="{page|request|session|application}"]>
body content
</c:if>
例:
jsp页面
<c:if test="${capitals.Canada ne 'shanghai'}" var="testvar" scope="request" >
<p>Canada capitals isn't shanghai </p>
</c:if>
<c:out value="${testvar}" default="${'I am defualt value' }"/>
<br />
${'<'}
</body>
</html>
浏览器
属性 | 类型 | 描述 |
test+ | 布尔 | 决定是否处理任何现有body content的测试条件 |
var | 字符串 | 引用测试条件值的有界变量名称;var的类型为Boolean |
scope | 字符串 | var定义的有界变量的范围 |
2.choose, when 和 otherwise标签
choose和when标签的作用与Java中的关键字switch 和case类似。也就是说,它们是为相互排斥的条件执行 提供上下文的。choose标签中必须嵌有一个或者多个 when标签,并且每个when标签都表示一种可以计算和 处理的情况。otherwise标签则用于默认的条件块,假如 没有任何一个when标签的测试条件结果为True,它就 会得到处理。假如是这种情况,otherwise就必须放在最 后一个when后。
choose和otherwise标签没有属性。when标签必须带 有定义测试条件的test属性,用来决定是否应该处理 body content。
例:
jsp页面
<br />
<c:choose>
<c:when test="${capitals.Canada eq 'shanghai' }"> haha</c:when>
<c:when test="${capitals.Canada eq 'outtua' }"> haha</c:when>
<c:when test="${capitals.Canada eq 'Ottua' }"> yes </c:when>
<c:otherwise>I don't know</c:otherwise>
</c:choose>
<br />
${param.status}
</body>
</html>
浏览器
五.遍历行为
当需要无数次地遍历一个对象集合时,遍历行为就 很有帮助。JSTL提供了forEach和forTokens两个执行遍 历行为的标签.
1. forEach标签
forEach标签会无数次地反复遍历body content或者 对象集合。可以被遍历的对象包括java.util.Collection和 java.util.Map的所有实现,以及对象数组或者主类型。 也可以遍历java.util.Iterator和java.util.Enumeration,但 不应该在多个行为中使用Iterator或者Enumeration,因 为无法重置Iterator或者Enumeration。 forEach标签的语法有两种形式。
第一种形式是固 定次数地重复body content:
<c:forEach [var="varName"] begin="begin" end="end" step="step">
body content
</c:forEach>
例
jsp页面
<c:forEach var="x" begin = "" end = "">
<c:out value="${x }" />,
</c:forEach>
浏览显示
第二种形式用于遍历对象集合:
<c:forEach items="collection" [var="varName"]
[varStatus="varStatusName"] [begin="begin"] [end="end"]
[step="step"]>
body content
</c:forEach>
例:
servlet
request.setAttribute("employee",employee); Map<String, String> capitals = new HashMap<String,String>();
capitals.put("China" ,"Beijing");
capitals.put("Austria","Vienna");
capitals.put("Australia","Canberra");
capitals.put("Canada","Ottua");
jsp页面
<br />
<c:forEach var="capital" items="${capitals}">
${capital},
</c:forEach>
浏览器
属性 | 类型 描述 |
var | 字符串 引用遍历的当前项目的有界变量名称 |
items+ | 支持的任意类型 遍历的对象集合 |
varStatus | 字符串 保存遍历状态的有界变量名称。类型值为javax.servlet.jsp.jstl.core.LoopTagStatus |
begin+ | 整数 如果指定items,遍历将从指定索引处的项目开始,例如,集合中第一个项目的索引为0。如果没有指定items,遍历将从设定的索引值开始。如果指定,begin的值必须大于或者等于0 |
end+ | 整数 如果指定items,遍历将在(含)指定索引处的项目结束。如果没有指定items,遍历将在索引到达指定值时结束 |
step+ | 整数 遍历将只处理间隔指定step的项目,从第一个项目开始。在这种情况下,step的值必须大于或者等于1 |
对于每一次遍历,forEach标签都将创建一个有界 变量,变量名称通过var属性定义。这个有界变量只存在于开始和关闭的 forEach标签之间,一到关闭的forEach标签前,它就会 被删除。
示例
forEach标签有一个类型为 javax.servlet.jsp.jstl.core.LoopTagStatus的变量 varStatus。LoopTagStatus接口带有count属性,它返回 当前遍历的“次数”。第一次遍历时,status.count值为 1;第二次遍历时,status.count值为2,依次类推。通过 测试status.count%2的余数,可以知道该标签正在处理 的是偶数编号的元素,还是奇数编号的元素。 以app05a应用程序中的BookController类和 BookList.jsp页面为例。如清单5.1所示,BookController 类调用了一个service方法,返回一个Book对象List。 Book类如清单5.2所示
servlet页面
package servlet; import model.*;
import util.*;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.sql.*;
@WebServlet(name="BooksServlet", urlPatterns= {"/books"})
public class BooksServlet extends HttpServlet{
private static final int serialVersionUID = -; @Override
public void doGet(HttpServletRequest request,HttpServletResponse response) throws ServletException, IOException {
List<Book> books = new BooksList().getBooksList();
request.setAttribute("books",books);
RequestDispatcher rd = request.getRequestDispatcher("/Books.jsp");
rd.forward(request, response);
}
}
jsp页面
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Books list</title>
<style>
table, tr, td {
border: 1px, solid brown;
}
</style>
</head>
<body>
<table>
<tr>
<td>ISB</td>
<td>Title</td>
</tr>
<c:forEach var="book" items="${requestScope.books}">
<tr>
<td>${book.isbn}</td>
<td>${book.title}</td>
</tr>
</c:forEach> </table>
Books in Styled Table
<table>
<tr style="background: #ababff">
<td>ISBN</td>
<td>Title</td>
</tr>
<c:forEach items="${requestScope.books}" var="book" varStatus="status">
<c:if test="${status.count%2 == 0}">
<tr style="background: #eeeeff">
</c:if>
<c:if test="${status.count%2 != 0}">
<tr style="background: #dedeff">
</c:if>
<td>${book.isbn}</td>
<td>${book.title}</td>
</tr>
</c:forEach>
</table> ISBNs only:
<c:forEach items="${requestScope.books }" var="book" varStatus="status">
${book.isbn}<c:if test="${!status.last}">,</c:if>
</c:forEach>
</body>
</html>
book.java类
package model; public class Book {
private int isbn;
private String title;
private float price; public Book(int isbn, String title, float price) {
this.isbn = isbn;
this.title = title;
this.price = price;
} public int getIsbn() {
return isbn;
} public void setIsbn(int isbn) {
this.isbn = isbn;
} public String getTitle() {
return title;
} public void setTitle(String title) {
this.title = title;
} public float getPrice() {
return price;
} public void setPrice(float price) {
this.price = price;
}
}
package model; import java.sql.*;
import java.util.*;
import util.DBConnection;
public class BooksList {
private Connection conn = null;
public List<Book> getBooksList(){
List<Book> books = new ArrayList<Book>();
Book book = null;
try {
conn = DBConnection.getConn();
String sql = "SELECT * FROM books";
PreparedStatement pstmt = conn.prepareStatement(sql);
ResultSet rs = pstmt.executeQuery();
while(rs.next())
{
book = new Book(rs.getInt("isbn"),rs.getString("title"),rs.getFloat("price"));
books.add(book);
}
}catch(SQLException e) {
e.printStackTrace();
}
return books;
}
}
可以利用forEach遍历Map,其格式为:
<c:forEach var="mapItem" items="map">
${mapItem.key} : ${mapItem.value}
</c:forEach>
例:范例展示了forEach与Map的结合使用。清单 5.4中的CityController类将两个Map实例化,并为它们赋 予键/值对。第一个Map中的每一个元素都是一个 String/String对,第二个Map中的每一个元素则都是一个 String/String[]对。
最重要的是,第二个forEach中还嵌套了另一个 forEach.
servlet页面
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
Map<String, String> capitals = new HashMap<String, String>();
capitals.put("Indonesia", "Jakarta");
capitals.put("Malaysia", "Kuala Lumpur");
capitals.put("Thailand", "Bangkok");
request.setAttribute("capitals", capitals);
Map<String, String[]> bigCities = new HashMap<String, String[]>();
bigCities.put("Australia", new String[] { "Sydney", "Melbourne", "Perth" });
bigCities.put("New Zealand", new String[] { "Auckland", "Christchurch", "Wellington" });
bigCities.put("Indonesia", new String[] { "Jakarta", "Surabaya", "Medan" });
request.setAttribute("capitals", capitals);
request.setAttribute("bigCities", bigCities);
RequestDispatcher rd = request.getRequestDispatcher("/Cities.jsp");
rd.forward(request, response);
}
jsp页面
br /> Big Cities
<table>
<tr style="background: #448755; color: white; font-weight: bold">
<td>Country</td>
<td>Cities</td>
</tr>
<c:forEach items="${requestScope.bigCities}" var="mapItem">
<tr>
<td>${mapItem.key}</td>
<td><c:forEach items="${mapItem.value}" var="city"
varStatus="status">
${city}<c:if test="${!status.last}">,</c:if>
</c:forEach></td>
</tr>
</c:forEach>
</table>
浏览器
2.forTokens
forTokens标签用于遍历以特定分隔符隔开的令牌,其语法如下:
<c:forTokens items="stringOfTokens" delims="delimiters"
[var="varName"] [varStatus="varStatusName"]
[begin="begin"] [end="end"] [step="step"]
>
body content
属性 | 类型 | 描述 |
var | 字符串 | 引用遍历的当前项目的有界变量名称 |
items+ | 支持的任意类型 | 要遍历的token字符串 |
varStatus | 字符串 | 保存遍历状态的有界变量名称。类型值为javax.servlet.jsp.jstl.core.LoopTagStatus |
begin+ | 整数 | 遍历的起始索引,此处索引是从0开始的。如有指定,begin的值必须大于或者等于0 |
end+ | 整数 | 遍历的终止索引,此处索引是从0开始的 |
step+ | 整数 | 遍历将只处理间隔指定step的token,从第一个token开始。如有指定,step的值必须大于或者等于1 |
delims+ | 字符串 | 一组分隔符 |
下面是一个forTokens范例:
<c:forTokens var="item" items="Argentina,Brazil,Chile" delims=",">
<c:out value="${item}"/><br/>
</c:forTokens>
六. 格式化行为
JSTL提供了格式化和解析数字与日期的标签,它 们是formatNumber、formatDate、timeZone、 setTimeZone、parseNumber和parseDate。
1. formatNumber标签
i) formatNumber用于格式化数字。这个标签使你可以 根据需要,利用它的各种属性来获得自己想要的格式。 formatNumber的语法有两种形式。第一种形式没有body content:
<fmt:formatNumber value="numericValue"
[type="{number|currency|percent}"]
[pattern="customPattern"]
[currencyCode="currencyCode"]
[currencySymbol="currencySymbol"]
[groupingUsed="{true|false}"]
[maxIntegerDigits="maxIntegerDigits"]
[minIntegerDigits="minIntegerDigits"]
[maxFractionDigits="maxFractionDigits"]
[minFractionDigits="minFractionDigits"]
[var="varName"]
[scope="{page|request|session|application}"]
/>
ii) 第二种形式有body content:
<fmt:formatNumber [type="{number|currency|percent}"]
[pattern="customPattern"]
[currencyCode="currencyCode"]
[currencySymbol="currencySymbol"]
[groupingUsed="{true|false}"]
[maxIntegerDigits="maxIntegerDigits"]
[minIntegerDigits="minIntegerDigits"]
[maxFractionDigits="maxFractionDigits"]
[minFractionDigits="minFractionDigits"]
[var="varName"]
[scope="{page|request|session|application}"]>
numeric value to be formatted
</fmt:formatNumber>
body content是JSP。formatNumber标签的属性如下表所示。
属性 | 类型 | 描述 |
value+ | 字符串或数字 | 要格式化的数字化值 |
type+ | 字符串 | 说明该值是要被格式化成数字、货币,还是百分比。这个属性值有number、currency、percent |
pattern+ | 字符串 | 定制格式化样式 |
currencyCode+ | 字符串 | ISO4217码,如表5.11所示 |
CurrencySymbol+ | 字符串 | 货币符号 |
groupingUsed+ | 布尔 | 说明输出结果中是否包含组分隔符 |
maxIntegerDigits+ | 整数 | 规定输出结果的整数部分最多几位数字 |
minIntegerDigits+ | 整数 | 规定输出结果的整数部分最少几位数字 |
maxFractionDigits+ | 整数 | 规定输出结果的小数部分最多几位数字 |
minFractionDigits+ | 整数 | 规定输出结果的小数部分最少几位数字 |
var | 字符串 | 将输出结果存为字符串的有界变量名称 |
scope | 字符串 | var的范围。如果有scope属性,则必须指定var属性 |
iii) formatNumber标签的用途之一就是将数字格式化成 货币。为此,可以利用currencyCode属性来定义一个 ISO 4217货币代码。部分ISO 4217货币代码如表所示。
币别 | ISO 4217码 | 大单位名称 | 小单位名称 |
加拿大元 | CAD | 加元 | 分 |
人民币 | CNY | 元 | 角 |
欧元 | EUR | 欧元 | 分 |
日元 | JPY | 日元 | 钱 |
英磅 | GBP | 英磅 | 便士 |
formatNumber的用法范例如表所示。注意,在格式化货币时,如果没有定义 currencyCode属性,就使用浏览器的locale。
行为 | 结果 |
<fmt:formatNumber value="12" type="number"/> | 12 |
<fmt:formatNumber value="12" type="number"minIntegerDigits="3"/> | 012 |
<fmt:formatNumber value="12" type="number"minFractionDigits="2"/> | 12.00 |
<fmt:formatNumber value="123456.78" pattern=".000"/> | 123456.780 |
<fmt:formatNumber value="123456.78" pattern="#,#00.0#"/> | 123,456.78 |
<fmt:formatNumber value="12" type="currency"/> | $12.00 |
<fmt:formatNumber value="12" type="currency"currencyCode="GBP"/> | GBP 12.00 |
<fmt:formatNumber value="0.12" type="percent"/> | 12% |
<fmt:formatNumber value="0.125" type="percent"minFractionDigits="2"/> | 12.50% |
2.formatDate标签
<jsp:useBean id="now" class="java.util.Date">
formatDate标签用于格式化日期,其语法如下
<fmt:formatDate value="date"
[type="{time|date|both}"]
[dateStyle="{default|short|medium|long|full}"]
[timeStyle="{default|short|medium|long|full}"]
[pattern="customPattern"]
[timeZone="timeZone"]
[var="varName"]
[scope="{page|request|session|application}"]
/>
body content为JSP。formatDate标签的属性如表所示。
属性 | 类型 | 描述 |
value+ | java.util.Date | 要格式化的日期和/或时间 |
type+ | 字符串 | 说明要格式化的是时间、日期,还是时间与日期元件 |
dataStyle+ | 字符串 | 预定义日期的格式化样式,遵循java.text.DateFormat中定义的语义 |
timeStyle+ | 字符串 | 预定义时间的格式化样式,遵循java.text.DateFormat中定义的语义 |
pattern+ | 字符串 | 定制格式化样式 |
timezone+ | 字符串或java.util.TimeZone | 定义用于显示时间的时区 |
var | 字符串 | 将输出结果存为字符串的有界变量名称 |
scope | 字符串 | var的范围 |
下列代码利用formatDate标签格式化有界变量now 引用的java.util.Date对象:
Default: <fmt:formatDate value="${now}"/>
Short: <fmt:formatDate value="${now}" dateStyle="short"/>
Medium: <fmt:formatDate value="${now}" dateStyle="medium"/>
Long: <fmt:formatDate value="${now}" dateStyle="long"/>
Full: <fmt:formatDate value="${now}" dateStyle="full"/>
下面的formatDate标签用于格式化时间:
Default: <fmt:formatDate type="time" value="${now}"/>
Short: <fmt:formatDate type="time" value="${now}"
timeStyle="short"/>
Medium: <fmt:formatDate type="time" value="${now}"
timeStyle="medium"/>
Long: <fmt:formatDate type="time" value="${now}" timeStyle="lon
g"/>
Full: <fmt:formatDate type="time" value="${now}" timeStyle="ful
l"/>
下面的formatDate标签用于格式化日期和时间:
Default: <fmt:formatDate type="both" value="${now}"/>
Long date long time format: <fmt:formatDate type="both" value="${now}" dateStyle="long" timeStyle="long"/>
下面的formatDate标签用于格式化带时区的时间:
Time zone CT: <fmt:formatDate type="time" value="${now}" timeZone="CT"/><br/>
Time zone HST: <fmt:formatDate type="time" value="${now}" timeZone="HST"/><br/>
下面的formatDate标签利用定制模式格式化日期和时间:
<fmt:formatDate type="both" value="${now}" pattern="dd.MM.yy"/>
<fmt:formatDate type="both" value="${now}" pattern="dd.MM.yyyy"/>
3.timeZone标签
timeZone标签用于定义时区,使其body content中 的时间信息按指定时区进行格式化或者解析。其语法如 下:
<fmt:timeZone value="timeZone">body content</fmt:timeZone>
body content是JSP。属性值可以是类型为String或 者java.util.TimeZone的动态值。美国和加拿大时区的值 如表5.12所示。 如果value属性为null或者empty,则使用GMT时 区。 下面的范例是用timeZone标签格式化带时区的日 期:
<fmt:timeZone value="GMT+1:00">
<fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/>
</fmt:timeZone> <fmt:timeZone value="HST">
<fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/>
</fmt:timeZone>
<fmt:timeZone value="CST">
<fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/>
</fmt:timeZone>
缩写 | 全名 |
Asia/Shanghai | |
ACT | Australia/Darwin |
AET | Australia/Sydney |
AGT | America/Argentina/Buenos_Aires |
ART | Africa/Cairo |
AST | America/Anchorage |
BET | America/Sao_Paulo |
BST | Asia/Dhaka |
CAT | Africa/Harare |
CNT | America/St_Johns |
CST | America/Chicago |
CTT | Asia/Shanghai |
EAT | Africa/Addis_Ababa |
ECT | Europe/Paris |
EST | America/New_York |
HST | Pacific/Honolulu |
IET | America/Indianapolis |
IST | Asia/Calcutta |
JST | Asia/Tokyo |
MIT | Pacific/Apia |
MST | America/Denver |
NET | Asia/Yerevan |
NST | Pacific/Auckland |
PLT | Asia/Karachi |
PNT | America/Phoenix |
PRT | America/Puerto_Rico |
PST | America/Los_Angeles |
SST | Pacific/Guadalcanal |
VST | Asia/Saigon |
4.setTiemZone标签
setTimeZone标签用于将指定时区保存在一个有界 变量或者时间配置变量中。setTimeZone的语法如下:
<fmt:setTimeZone value="timeZone" [var="varName"] [scope="{page|request|session|application}"] />
下表展示了setTimeZone标签的属性
属性 | 类型 | 描述 |
value+ | 字符串或java.util.TimeZone | 时区 |
var | 字符串 | 保存类型为java.util.TimeZone的时区的有界变量 |
scope | 字符串 | var的范围或者时区配置变量 |
5 parseNUmber标签
parseNumber标签用于将以字符串表示的数字、货 币或者百分比解析成数字,其语法有两种形式。
第一种 形式没有body conte
<fmt:parseNumber value="numericValue" [type="{number|currency|percent}"] [pattern="customPattern"] [parseLocale="
parseLocale"] [integerOnly="{true|false}"] [var="varName"][scope="{page|request|session|application}"]/>
第二种形式有 body content:
<fmt:parseNumber [type="{number|currency|percent}"] [pattern="customPattern"] [parseLocale="parseLocale"]
[integerOnly="{true|false}"] [var="varName"] [scope="{page|request|session|application}"]>
numeric value to be parsed
</fmt:parseNumber>
例 下面的parseNumber标签用于解析有界变量quantity 引用的值,并将结果保存在有界变量formattedNumber 中:
<jsp:useBean id="quantity" class="java.lang.String" >${quantity="1.25"}</jsp:useBean>
${quantity*} <%-- 其实可以不转格式也可以用 --%>
<fmt:parseNumber var="formattedNumber" type="number" value="${quantity}"/>
${formattedNumber*}
属性 | 类型 | 描述 |
value+ | 字符串或数字 | 要解析的字符串 |
type+ | 字符串 | 说明该字符串是要被解析成数字、货币,还是百分比 |
pattern+ | 字符串 | 定制格式化样式,决定value属性中的字符串要如何解析 |
parseLocale+ | 字符串或者java.util.Locale | 定义locale,在解析操作期间将其默认为格式化样式,或将pattern属性定义的样式应用其中 |
integerOnly+ | 布尔 | 说明是否只解析指定值的整数部分 |
var | 字符串 | 保存输出结果的有界变量名称 |
scope | 字符串 | var的范围 |
6 parseDate标签
parseDate标签以区分地域的格式解析以字符串表示 的日期和时间,其语法有两种形式。
第一种形式没有 body content:
<fmt:parseDate value="dateString"
[type="{time|date|both}"]
[dateStyle="{default|short|medium|long|full}"]
[timeStyle="{default|short|medium|long|full}"]
[pattern="customPattern"]
[timeZone="timeZone"]
[parseLocale="parseLocale"]
[var="varName"]
[scope="{page|request|session|application}"]
/>
第二种形式有body content:
<fmt:parseDate [type="{time|date|both}"]
[dateStyle="{default|short|medium|long|full}"]
[timeStyle="{default|short|medium|long|full}"]
[pattern="customPattern"]
[timeZone="timeZone"]
[parseLocale="parseLocale"]
[var="varName"]
[scope="{page|request|session|application}"]>
date value to be parsed
</fmt:parseDate>
body content是JSP。表列出了parseDate标签的 属性。
属性 | 类型 | 描述 |
value+ | 字符串 | 要解析的字符串 |
type+ | 字符串 | 说明要解析的字符串中是否包含日期、时间或二者均有 |
dateStyle+ | 字符串 | 日期的格式化样式 |
timeStyle+ | 字符串 | 时间的格式化样式 |
pattern+ | 字符串 | 定制格式化样式,决定要如何解析该字符串 |
timeZone+ | 字符串或者java.util.TimeZone | 定义时区,使日期字符串中的时间信息均根据它来解析 |
parseLocale+ | 字符串或者java.util.Locale | 定义locale,在解析操作期间用其默认为格式化样式,或将pattern属性定义的样式应用其中 |
var | 字符串 | 保存输出结果的有界变量名称 |
scope | 字符串 | var的范围 |
下面的parseDate标签用于解析有界变量myDate引 用的日期,并将得到的java.util.Date保存在一个页面范 围的有界变量formattedDate中:
c:set var="myDate" value="2005/12/05"/>
<fmt:parseDate var="formattedDate" type="date" pattern="YYYY/MM/dd" dateStyle="short" value="${myDate}"/>
${formattedDate }<br />
<fmt:formatDate type="both" value="${formattedDate}" pattern="YYYY/MM/dd" dateStyle="short"/>
七. 函数
除了定制行为外,JSTL 1.1和JSTL 1.2还定义了一 套可以在EL表达式中使用的标准函数。这些函数都集 中放在function标签库中。为了使用这些函数,必须在 JSP的最前面使用以下taglib指令:
<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %
调用函数时,要以下列格式使用一个EL:
${fn:functionName}
这里的functionName是函数名。 大部分函数都用于字符串操作。例如,length函数 用于字符串和集合,并返回集合或者数组中的项目数, 或者返回一个字符串的字符数
1. contains 函数
contains函数用于测试一个字符串中是否包含指定 的子字符串。如果字符串中包含该子字符串,则返回值 为True,区分大小写,否则,返回False。其语法如下:
contains(string, substring).
例
<c:set var="str" value="I am a string" />
${fn:contains(str,"am")}
2. containsIgnoreCase 函数
containsIgnoreCase函数与contains函数相似,但是不区分大小写的,其语法如下:
containsIgnoreCase(string, substring)
例如,下列的EL表达式将返回True:
${fn:containsIgnoreCase("Stella Cadente", "CADENTE")}
3. endWith 函数
endsWith函数用于测试一个字符串是否以指定的后 缀结尾,其返回值是一个Boolean,语法如下:
endsWith(string, suffix)
例如,下列的EL表达式将返回True。
${fn:endsWith("Hello World", "World")}
4. escapeXML 函数
escapeXml函数用于给String编码。这种转换与out 标签将其escapeXml属性设为True一样。escapeXml的语 法如下:
escapeXml(string)
例如,下面的EL表达式:
${fn:escapeXml("Use <br/> to change lines")}
将被渲染成:
Use <br/> to change lines
5. indexOf 函数
indexOf函数返回指定子字符串在某个字符串中第 一次出现时的索引。如果没有找到指定的子字符串,则 返回−1。其语法如下:
indexOf(string, substring)
例如,下列的EL表达式将返回7:
${fn:indexOf("Stella Cadente", "Cadente")}
6. join 函数
join函数将一个String数组中的所有元素都合并成一 个字符串,并用指定的分隔符分开,其语法如下:
join(array, separator)
如果这个数组为null,就会返回一个空字符串。 例如,如果myArray是一个String数组,它带有两 个元素 ,那么,下列EL表达式:
<c:set var="myArray" value="${fn:split('a,cd,f', ',')}" />
${fn:join(myArray,";")}
7. length 函数
length函数用于返回集合中的项目数,或者字符串 中的字符数,其语法如下:
length{input}
下列的EL表达式将返回14:
${fn:length("Stella Cadente", "Cadente")} //亲测只能单个字符串可以用
8 replace 函数
replace函数将字符串中出现的所有beforeString用 afterString替换,并返回结果,其语法如下:
replace(string, beforeSubstring, afterSubstring)
例如,下列的EL表达式将返回“StElla CadEntE” :
${fn:replace("Stella Cadente", "e", "E")}
9. split 函数
split函数用于将一个字符串分离成一个子字符串数 组。它的作用与join相反。例如,下列代码是分离字符 串“my, world” ,并将结果保存在有界变量split中。随 后,利用forEach标签将split格式化成一个HTML表:
<c:set var="split" value='${fn:split("my,world",",")}'/>
<table>
<c:forEach var="substring" items="${split}">
<tr><td>${substring}</td></tr>
</c:forEach>
</table>
结果为:
<table>
<tr><td>my</td></tr>
<tr><td>world</td></tr>
</table>
10. startWith 函数
tartsWith函数用于测试一个字符串是否以指定的 前缀开头,其语法如下:
startsWith(string, prefix)
例如,下列的EL表达式将返回True:
${fn:startsWith("Stella Cadente", "St")}
11 substring 函数
substring函数 substring函数用于返回一个从指定基于0的起始索 引(含)到指定基于0的终止索引的子字符串,其语法 如下:
substring(string, beginIndex, endIndex)
下列的EL表达式将返回“Stel” :
${fn:substring("Stella Cadente", , )}
12 substringAfter 函数
substringAfter函数用于返回指定子字符串第一次出 现后的字符串部分,其语法如下:
substringAfter(string, substring)
例如,下列的EL表达式将返回“lla Cadente” :
${fn:substringAfter("Stella Cadente", "e")}
13 substringafter 函数
substringBefore函数用于返回指定子字符串第一次 出现前的字符串部分,其语法如下:
substringBefore(string, substring)
例如,下列的EL表达式将返回“St” :
${fn:substringBefore("Stella Cadente", "e")}
14 . toLowercCase 函数
toLowerCase函数将一个字符串转换成它的小写版 本,其语法如下:
toLowerCase(string)
例如,下列的EL表达式将返回“stella cadente” :
${fn:toLowerCase("Stella Cadente")}
15. toUpperCase 函数
toUpperCase函数将一个字符串转换成它的大写版 本,其语法如下:
toUpperCase(string)
例如,下列的EL表达式将返回“STELLA CADENTE” :
${fn:toUpperCase("Stella Cadente")}
16. trim 函数
trim函数用于删除一个字符串的空白, 其语法如下:
trim(string)
例如,下列的EL表达式将返回“Stella Cadente” :
${fn:trim(" Stella Cadente ")}