李晖晖—sturts2国际化标签总结

国际化标签

国际化标签库概述

为了简化WEB应用的国际化开发,JSTL中提供了一个用于实现国际化和格式化功能的标签库,我们将其简称为国际化标签库,JSP规范为国际化标签库建议的前缀名为fmt。国际化标签库中包括了一组用于实现WEB国际化功能的标签,这组标签封装了Java语言中java.util和java.text这两个包中与国际化相关的API类的功能。国际化标签库中提供了绑定资源包和从资源包中的本地资源文件内读取文本内容的标签,也提供了对数值和日期等本地敏感的数据按本地化信息进行显示和解析的标签,还提供了按本地特定的时区来调整时间的标签。

国际化标签库中的标签可以根据客户端浏览器的信息来自动确定本地信息,也可以由JSP页面作者显式地指定本地信息。如果没有特别指定,本章案例假设默认的本地信息为“中文(中国)”。

在举例讲解国际化标签库中的标签时, 通常要使用到包含有多个资源文件的资源包,这个资源包中的各个资源文件分别对应几个不同本地信息。这里先创建好一组资源包文件。首先按例程8-25和例程8-26创建两个名称分别为greetings.properties和temp.properties的资源文件。

例程8-25 greetings.properties

[plain] view plain copy print ?
  1. org.it315.heading=The first WEB application 
  2. org.it315.welcome=Welcome to www.it315.org ! 
  3. org.it315.okKey=Today is {0,date,full}, you have {1,number,currency} dollars. 
org.it315.heading=The first WEB application
org.it315.welcome=Welcome to www.it315.org !
org.it315.okKey=Today is {0,date,full}, you have {1,number,currency} dollars.

例程8-26 temp.properties

[plain] view plain copy print ?
  1. org.it315.heading=第一个WEB应用程序 
  2. org.it315.welcome=欢迎访问www.it315.org网站! 
  3. org.it315.okKey=今天是{0,date,full},你有{1,number,currency}元。 
org.it315.heading=第一个WEB应用程序
org.it315.welcome=欢迎访问www.it315.org网站!
org.it315.okKey=今天是{0,date,full},你有{1,number,currency}元。

接着使用JDK中提供的native2ascii程序将temp.properties文件中的中文字符转换成其Unicode码形式的转义序列。在命令行窗口中进入temp.properties文件所在的目录,执行如下命令:

native2ascii -encoding GB2312 temp.properties greetings_zh.properties

上面的命令执行后产生的greetings_zh.properties文件内容如例程8-27所示。

例程8-27 greetings_zh.properties

[plain] view plain copy print ?
  1. org.it315.heading=\u7b2c\u4e00\u4e2aWEB\u5e94\u7528\u7a0b\u5e8f 
  2. org.it315.welcome=\u6b22\u8fce\u8bbf\u95eewww.it315.org\u7f51\u7ad9! 
  3. org.it315.okKey=\u4eca\u5929\u662f{0,date,full}\uff0c\u4f60\u6709{1,number, 
  4. currency}\u5143\u3002 
org.it315.heading=\u7b2c\u4e00\u4e2aWEB\u5e94\u7528\u7a0b\u5e8f
org.it315.welcome=\u6b22\u8fce\u8bbf\u95eewww.it315.org\u7f51\u7ad9!
org.it315.okKey=\u4eca\u5929\u662f{0,date,full}\uff0c\u4f60\u6709{1,number,
currency}\u5143\u3002

英文本地环境所对应的资源文件只需复制greetings.properties文件,并改名为greetings_en.properties即可。最后将greetings.properties、greetings_en.properties和greetings_zh.properties这三个资源文件保存到\webapps\JSTL\WEB-INF\classes\org\it315\目录中。

标签

标签用于在JSP页面中显式地设置用户的本地化信息,并将设置的本地化信息以Locale对象的形式保存在某个Web域中,其在Web域中的属性名称为“javax.servlet.jsp.jstl.fmt.locale”。使用标签设置本地化信息后,国际化标签库中的其他标签将使用该本地化信息,而忽略客户端浏览器传递过来的本地信息。标签的语法格式如下:

[variant="variant"]

[scope="{page|request|session|application}"] />

标签的属性说明如表8.12所示。

表8.12  标签的属性

属性名

是否支持EL

属性类型

属 性 描 述

value

true

String或java.util.Locale

指定用户的本地化信息,可以是一个字符串或java.util.Locale实例对象。如果是字符串,则必须包含小写形式的语言编码,其后也可以带有大写形式的国家编码,两者中间用“-”或“_”连接

variant

true

String

指定创建Locale实例对象时设置的变量部分,它用于标识开发商或特定浏览器为实现扩展功能而自定义的信息

scope

false

String

指定将构造出的Locale实例对象保存在哪个Web作用域中

如果标签的value属性值为null,标签将采用客户端浏览器传递过来的本地信息。例程8-28是一个使用标签的例子程序。

例程8-28 fmt_setLocale.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <fmt:setLocale value="${param.locale}" /> 
  4. <fmt:setBundle basename="org.it315.greetings" var="greetings" /> 
  5. <head> 
  6. <title><fmt:message bundle="${greetings}" key="org.it315.heading" />title> 
  7. head> 
  8. <jsp:useBean id="now" class="java.util.Date" /> 
  9. <
  10. session.setAttribute("number", new Integer(8888888)); 
  11. %> 
  12. <fmt:message bundle="${greetings}" key="org.it315.welcome" /><br /> 
  13. <fmt:message bundle="${greetings}" key="org.it315.okKey"> 
  14. <fmt:param value="${now}" /> 
  15. <fmt:param value="${number}" /> 
  16. fmt:message> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>



<fmt:message bundle="${greetings}" key="org.it315.heading" />


<%
session.setAttribute("number", new Integer(8888888));
%>

例程8-28中的标签用于根据标签设置的本地化信息绑定一个资源包,其细节请参看8.4.3节;标签用于从一个资源包中读取信息并进行格式化输出,其细节请参看8.4.5节;标签用于为格式化文本串中的占位符设置参数值,其细节请参看8.4.6节。

在浏览器地址栏输入如下地址访问fmt_setLocale.jsp页面

http://localhost:8080/JSTL/fmt_setLocale.jsp?locale=en_US

例程8-28的运行结果如图8.22所示。


将上面的访问地址中的locale参数设置为zh_CN后访问fmt_setLocale.jsp页面,例程8-28的运行结果如图8.23所示。



标签

标签用于根据标签设置的本地化信息创建一个资源包(ResourceBundle)实例对象,并将其绑定到一个Web域的属性上。标签的语法格式如下:

[var="varName"]

[scope="{page|request|session|application}"] />

标签的属性说明如表8.13所示。

8.13  标签的属性

属性名

是否支持EL

属性类型

属 性 描 述

basename

true

String

指定创建ResourceBundle实例对象的基名

var

false

String

指定将创建出的ResourceBundle实例对象保存到Web域中的属性名称

scope

false

String

指定将创建出的ResourceBundle实例对象保存在哪个Web作用域中

标签有如下一些特性:

(1)如果basename属性的值为null或空字符串,或找不到basename属性指定的资源,标签保存到Web域中的属性的值为null。

(2)如果指定了var属性,标签将把ResourceBundle实例对象以var属性的值作为域属性名称保存到Web域中。

(3)如果没有指定var属性,标签将把ResourceBundle实例对象以域属性名javax.servlet.jsp.jstl.fmt.localizationContext保存到Web域中。所有没有嵌套在标签中且未指定bundle属性的都将使用该标签创建的资源包。

在前面的例程8-28中已经使用了标签,这里就不再对标签进行举例讲解了。

标签

标签与标签的功能类似,但它创建的ResourceBundle实例对象只在其标签体内有效。标签的语法格式如下:

[prefix="prefix"]>

body content

标签的属性说明如表8.14所示。

8.14  标签的属性

属性名

是否支持EL

属性类型

属 性 描 述

basename

true

String

指定创建ResourceBundle实例对象的基名

prefix

true

String

指定追加到嵌套在标签内的标签的key属性值前面的前缀

如果设置了标签的prefix属性,则其中嵌套的标签的key属性值中就可以省略prefix属性设置的前缀部分,这对要使用具有相同前缀的多个关键字的情况提供了一些简便。

例程8-29是一个使用标签的例子程序,其中分别演示了设置和不设置prefix属性的情况。

例程8-29 fmt_bundle.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. 没有设置prefix属性的情况:<br /> 
  4. <fmt:bundle basename="org.it315.greetings"> 
  5. <fmt:message key="org.it315.heading" /><br /> 
  6. <fmt:message key="org.it315.welcome" /><br /><hr /> 
  7. fmt:bundle> 
  8. 设置prefix属性的情况:<br /> 
  9. <fmt:bundle basename="org.it315.greetings" prefix="org.it315."> 
  10. <fmt:message key="heading" /><br /> 
  11. <fmt:message key="welcome" /> 
  12. fmt:bundle> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
没有设置prefix属性的情况:



设置prefix属性的情况:



例程8-29的运行结果如图8.24所示。

8.4.5  标签

标签用于从一个资源包中读取信息并进行格式化输出,它有如下一些使用语法格式:

语法1,没有标签体的情况:

[bundle="resourceBundle"]

[var="varName"]

[scope="{page|request|session|application}"] />

语法2在标签体中指定格式化文本串中的占位符参数的情况:

[bundle="resourceBundle"]

[var="varName"]

[scope="{page|request|session|application}"]>

subtags

语法3,在标签体中指定消息关键字和可选择的占位符参数:

[var="varName"]

[scope="{page|request|session|application}"]>

key

optional subtags

标签的属性说明如表8.15所示。

8.15  标签的属性

属性名

是否支持EL

属性类型

属 性 描 述

key

true

String

指定要输出的信息的关键字

bundle

true

LocalizationContext

指定ResourceBundle对象在Web域中的属性名称

var

false

String

用于指定将格式化结果保存到某个Web域中的某个属性的名称

scope

false

String

指定将格式化结果保存到哪个Web域中

标签有如下一些特性:

  • 如果指定的资源不存在,输出“??????”形式的错误信息。
  • 如果ResouceBundle中不存在key属性指定的信息,输出“??????”形式的错误信息。
  • 如果key属性的值为null或空字符串,输出“??????”形式的错误信息。
  • 如果没有指定var属性,标签将直接输出格式化的结果;如果指定了var属性,则标签将格式化的结果保存在scope属性指定的Web域中,保存在Web域中的属性名称为var属性指定的值。如果指定了scope属性,就必须指定var属性。
  • 要输出的消息的关键字可以使用key属性指定,也可以在标签体中指定。如果标签嵌套在标签内,并且标签设置了prefix属性,则该属性的值追加到标签指定的关键字的前面。
  • 可以通过在标签内嵌套标签来指定格式化文本串中的占位符的参数值,每个标签分别设置一个参数,各个标签的顺序与格式化字符串的参数相对应,即第一个标签对应于格式化字符串中的第一个参数,第二个对应于格式化字符串中的第二个参数,依次类推。
  • 如果标签处理的格式化文本串中包含有参数,但其中没有嵌套与该参数对应标签,则直接输出该参数在格式化文本串中的原始形式。

例程8-30是一个使用标签的例子程序。

例程8-30  fmt_message.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <jsp:useBean id="now" class="java.util.Date" /> 
  4. <
  5. session.setAttribute("number", new Integer(8888888)); 
  6. %> 
  7. <fmt:setBundle basename="org.it315.greetings" var="greetings" /> 
  8. <fmt:message>标签内嵌套<fmt:param>标签的情况:<br /> 
  9. <fmt:message bundle="${greetings}"> 
  10. org.it315.okKey 
  11. <fmt:param value="${now}" /> 
  12. <fmt:param value="${number}" /> 
  13. fmt:message><br /><hr /> 
  14. <fmt:message>标签内没有嵌套<fmt:param>标签的情况:<br /> 
  15. <fmt:bundle basename="org.it315.greetings" prefix="org.it315."> 
  16. <fmt:message key="okKey" /> 
  17. fmt:bundle> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>

<%
session.setAttribute("number", new Integer(8888888));
%>

标签内嵌套标签的情况:
org.it315.okKey

标签内没有嵌套标签的情况:

例程8-30的运行结果如图8.25 所示。

标签

标签用于为格式化文本串中的占位符设置参数值,它只能嵌套在标签内使用。标签有如下两种语法格式:

语法1,用value属性指定参数值:

语法2,在标签体中指定参数的值的情况:

body content

说明:标签的value属性的类型是java.lang.Object,它支持动态属性值。在前面的例程中已经多次使用了标签,这里就不再对标签进行举例讲解了。

标签

标签用于设置请求消息的字符集编码,该标签内部调用request.setCharacterEncoding()方法,以便Web容器将请求消息中的参数值按该字符集编码转换成Unicode字符串返回。标签的语法格式如下:

其中的value属性用于指定请求消息的字符集编码,其类型为String,支持动态属性值。

关于标签的几点说明:

(1)为了能够正确解码请求参数值中的非ISO-8859-1编码的字符,应该调用这个标签来设置请求消息的字符集编码,并且必须在获取任何请求参数(包括使用EL表达式获取参数)之前进行调用。

(2)因为很多浏览器没有完全遵守HTTP规范,在请求消息中没有包含Content-Type请求头,所以使用这个标签来设置请求消息的字符集编码是很有必要的。

(3)标签的value属性的设置值通常为提交这次请求的页面的字符集编码,如果不能预先确定请求消息的字符集编码,那就不应指定value属性。如果没有设置标签的value属性,标签首先采用请求消息的Content-Type头中定义的字符集编码,如果不能从请求消息的Content-Type头中确定字符集编码,则采用session域中的javax.servlet.jsp.jstl.fmt.request.charset属性的值,否则,采用ISO-8859-1字符集编码。

例程8-31是一个使用标签的例子程序。

例程8-31 fmt_requestEncoding.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <fmt:requestEncoding value="gb2312" /> 
  4. 我最喜欢的科目是:${param.favourite}<br /> 
  5. <form method="POST"> 
  6. 你最喜欢学习的是什么科目?<br /> 
  7. <input type="text" name="favourite" /> 
  8. <input type="submit" value="OK" /><br/> 
  9. form> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>

我最喜欢的科目是:${param.favourite}
你最喜欢学习的是什么科目?



例程8-31的运行结果如图8.26所示,在文本框中输入“英语”,单击其中的OK按钮后的运行结果如图8.27所示。

标签

标签用于设置时区,但它的设置值只对其标签体部分有效。标签标签的语法格式如下:

body content

其中的value属性支持动态属性值,它的值可以是一个命名时区的字符串,也可以是java.util.TimeZone类的一个实例对象。如果value属性的值为null或空字符串,标签体中的内容就使用GMT的0基准时区。如果value属性的值是表示时区名称的字符串,这个字符串通过java.util.TimeZone.getTimeZone()静态方法被解析为java.util.TimeZone类的实例对象。

例程8-32是一个使用标签的例子程序。

例程8-32 fmt_timeZone.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <%@ page import="java.util.TimeZone" %> 
  4. <jsp:useBean id="now" class="java.util.Date" /> 
  5. 使用“GMT+1:00”时区:<br /> 
  6. <fmt:timeZone value="GMT+1:00"> 
  7. <fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/> 
  8. fmt:timeZone><br /><hr /> 
  9. <
  10. TimeZone tz = TimeZone.getDefault(); 
  11. pageContext.setAttribute("tz", tz); 
  12. %> 
  13. 使用默认的时区,value为java.util.TimeZone的一个实例:<br /> 
  14. <fmt:timeZone value="${tz}"> 
  15. <fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/> 
  16. fmt:timeZone><br /><hr /> 
  17. 使用“America/Los_Angeles”时区:<br /> 
  18. <fmt:timeZone value="America/Los_Angeles"> 
  19. <fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/> 
  20. fmt:timeZone> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
<%@ page import="java.util.TimeZone" %>

使用“GMT+1:00”时区:


<% TimeZone tz = TimeZone.getDefault(); pageContext.setAttribute("tz", tz); %> 使用默认的时区,value为java.util.TimeZone的一个实例:


使用“America/Los_Angeles”时区:


例程8-32的运行结果如图8.28 所示。

标签用于在JSP页面中显示地设置时区,并将设置的时区信息以TimeZone对象的形式保存在某个Web域中,其在Web域中的属性名称为javax.servlet.jsp.jstl.fmt.timeZone。标签的语法格式如下:

[var="varName"]

  [scope="{page|request|session|application}"] />

标签的属性说明如表8.16所示。

表8.16  标签的属性

属性名

是否支持EL

属性类型

属 性 描 述

value

true

String或java.util.TimeZone

指定表示时区的ID字符串或TimeZone对象

var

false

String

指定将创建出的TimeZone实例对象保存到Web域中的属性名称

scope

false

String

指定将创建出的TimeZone实例对象保存到哪个Web域中

其中,value属性的设置值的细节与标签的细节相同;标签将创建出的TimeZone实例对象保存在scope属性指定的Web域中,如果指定了var属性,保存在Web域中的属性名称为var属性指定的值,否则,保存在Web域中的属性名称为javax.servlet.jsp.jstl.fmt.timeZone,所有没有嵌套在其他标签中且未指定timezone属性的标签都将使用该域属性名关联的时区。

例程8-33是一个使用标签的例子程序。

例程8-33 fmt_setTimeZone.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <jsp:useBean id="now" class="java.util.Date" /> 
  4. <fmt:setTimeZone value="America/Los_Angeles"/> 
  5. “America/Los_Angeles”时区的现在时间是:<br /> 
  6. <fmt:formatDate value="${now}" type="both" /><hr /> 
  7. “GMT+1:00”时区的现在时间是:<br /> 
  8. <fmt:timeZone value="GMT+1:00"> 
  9. <fmt:formatDate value="${now}" type="both" /> 
  10. fmt:timeZone> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>


“America/Los_Angeles”时区的现在时间是:

“GMT+1:00”时区的现在时间是:

例程8-33的运行结果如图8.29所示。

标签

标签用于对日期和时间按本地化信息进行格式化,或对日期和时间按化为JSP页面作者自定义的格式进行格式化。标签的语法格式如下:

[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}"] />

标签的属性说明如表8.17所示。

表8.17 标签的属性

属性名

是否支持EL

属性类型

属 性 描 述

value

true

java.util.Date

指定要格式化的日期或时间

type

true

String

指定是格式化输出日期部分,还是格式化输出时间部分,还是两者都输出

dateStyle

true

String

指定日期部分的输出格式,其可用的设置值可以参照java.text.DateFormat类的讲解。该属性仅在type属性取值为date或both时才有效

timeStyle

true

String

指定时间部分的输出格式,其可用的设置值请参照java.text.DateFormat类的讲解。该属性仅在type属性取值为time或both时才有效

pattern

true

String

指定一个自定义的日期和时间输出格式

timeZone

true

String或java.util.timeZone

指定当前采用的时区

var

false

String

用于指定将格式化结果保存到某个Web域中的某个属性的名称

scope

false

String

指定将格式化结果保存到哪个Web域中

标签有如下一些特性:

  • 如果没有指定var属性,标签将直接输出格式化的结果;如果指定了var属性,则标签将格式化的结果保存在scope属性指定的Web域中,保存在Web域中的属性名称为var属性指定的值。如果指定了scope属性,就必须指定var属性。
  • 如果value属性的值为null,则不输出任何内容,如果这时候指定了var和scope属性,将scope属性指定的Web域中的var属性指定的域属性删除。
  • JSP网页作者可以使用pattern属性设置自定义的日期格式,这时候,标签将忽略type、dateStyle和timeStyle等属性。pattern属性的值必须符合java.text.SimpleDateFormat类的日期模式的语法。
  • 如果timeZone属性的值为null或者空字符串,相当于没有设置这个属性。
  • 如果要格式化一个表示日期或时间的字符串,必须首先用标签将其解析为java.util.Date类的一个实例对象,再使用标签对这个Date实例对象进行格式化。标签的介绍请参看8.4.11节。
  • 如果标签不能确定格式化的本地化信息,就使用java.util.Date.toString()方法作为输出格式。

例程8-34是一个使用标签的例子程序。

例程8-34 fmt_formatDate.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <%@ page import="java.util.TimeZone" %> 
  4. <jsp:useBean id="now" class="java.util.Date" /> 
  5. 格式化当前日期、时间: 
  6. <fmt:formatDate value="${now}" type="both" timeStyle="medium" dateStyle="long"/> 
  7. <hr/> 
  8. <
  9. session.setAttribute("tz", TimeZone.getTimeZone("GMT+10")); 
  10. %> 
  11. 指定时区为“GMT+10”: 
  12. <fmt:formatDate value="${now}" type="both" timeZone="${tz}" /><hr /> 
  13. 指定自定义的格式,月.日.年: 
  14. <fmt:formatDate value="${now}" pattern="MM.dd.yyyy" /><hr /> 
  15. 格式化用字符串表示的日期: 
  16. <fmt:parseDate value="7/31/05" pattern="MM/dd/yy" var="parsed" /> 
  17. <fmt:formatDate value="${parsed}" /> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
<%@ page import="java.util.TimeZone" %>

格式化当前日期、时间:


<% session.setAttribute("tz", TimeZone.getTimeZone("GMT+10")); %> 指定时区为“GMT+10”:
指定自定义的格式,月.日.年:
格式化用字符串表示的日期:

例程8-34的运行结果如图8.30 所示。

标签

标签与标签的作用正好相反,它用于将一个表示日期和时间的字符串解析成java.util.Date实例对象,它有如下两种语法格式:

语法1,没有标签体的情况:

[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}"] />

语法2, 有标签体的情况,在标签体中指定要被解析的日期和/或时间值:

[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

标签的属性说明如表8.18所示。


表8.18 标签的属性

标签有如下一些特性:

l value属性的值必须是合法的日期/时间字符串,否则标签在解析时抛出异常。如果value属性的值为null或空字符串,就删除scope属性指定的域范围中的var属性命名的变量。

  • 根据type属性的值,要解析日期字符串可以包含日期、时间或同时包含日期和时间,并根据指定的格式类型进行解析。
  • 如果timeZone属性的值为null或空字符串,按没有设置这个属性处理。
  • 如果parseLocale属性的值为null或空字符串,按没有设置该属性处理。
  • 如果指定pattern属性,标签就忽略它的type、dateStyle和timeStyle属性。这时,根据pattern属性设置的自定义格式解析value属性指定的日期和/或时间字符串,所以,要解析的日期和/或时间字符串必须严格符合pattern属性设置的自定义格式。pattern属性的值必须符合java.text.SimpleDateFormat类的模式语法。
  • 如果标签不能确定解析的本地环境,就抛出JspException异常,异常信息中包含要解析的字符串。

在前面的例程8-34中已经使用了标签,这里就不再对标签进行举例讲解了。

标签

标签用于将数值、货币或百分数按本地化信息进行格式化,或者按JSP页面作者自定义的格式进行格式化。标签有两种语法格式:

语法1,没有标签体的情况:

       [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}"] />

语法2,有标签体的情况,在标签体中指定要被格式化的数值:

       [pattern="customPattern"]

       [currencyCode="currencyCode"]

       [currencySymbol="currencySymbol"]

       [groupingUsed="{true|false}"]

       [maxIntegerDigits="maxIntegerDigits"]

       [minIntegerDigits="minIntegerDigits"]

       [maxFractionDigits="maxFractionDigits"]

       [minFractionDigits="minFractionDigits"]

       [var="varName"]

       [scope="{page|request|session|application}"]>

要被格式化的数值

如果指定scope属性,就必须指定var属性。标签的属性说明如表8.19所示。


表8.19 标签的属性

标签有如下一些特性:

  • 如果value属性的值为null,则不输出任何内容,如果这时候指定了var和scope属性,将scope属性指定的Web域中的var属性指定的域属性删除。
  • pattern属性优先于type属性,不管是使用哪个属性,格式化的标记(例如十进制小数的整数部分、小数部分的分隔符及组分隔符)通过格式化的Locale特性来决定。
  • pattern属性指定的模式字符串必须符合java.text.DecimalFormat类的模式语法。如果pattern属性为null或空字符串,就相当于没有设置这个属性的值。
  • currencyCode属性的值必须是一个合法的ISO 4217货币编码。
  • groupingUsed属性指定是否要将格式化后的数值的整数部分的数字分组。例如,在英语本地环境中,将比较大的数值按每三个数字分为一组,每组用逗号定界,其它的本地环境可能用点或空格来定界这样的分组。详细信息参考java.text.NumberFormat类的setGroupingUsed()方法。
  • 当type属性的值为currency时,currencyCode属性用来显式地指定要显示的数据的货币符号。currencySymbol属性也可以显式地指定货币符号。当WEB容器的运行环境是JDK1.4或更高版本时,如果同时指定标签的currencyCode和currencySymbol属性,前者优先于后者;但当WEB容器的运行环境是JDK1.4以前的版本时,currencySymbol属性优先于currencyCode属性。
  • 如果标签不能确定格式化的本地环境,就使用Number.toString()作为输出格式。

例程8-35是一个使用标签的例子程序。

例程8-35  fmt_formatNumber.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <%@ page import="java.util.Currency,java.util.Locale"%> 
  4. 将数值格式化为货币格式: 
  5. <fmt:formatNumber value="9876543.21" type="currency" /><hr /> 
  6. 将数值格式化为百分数格式: 
  7. <fmt:formatNumber value="12.3" type="percent" /><hr /> 
  8. 将数值格式化为自定义的格式: 
  9. <fmt:formatNumber value="12.3" pattern=".000" />; 
  10. <fmt:formatNumber value="123456.7891" pattern="#,#00.0#" /><hr /> 
  11. <
  12. String code = Currency.getInstance(Locale.CHINA).getCurrencyCode(); 
  13. String symbol = Currency.getInstance(Locale.US).getSymbol(); 
  14. session.setAttribute("code", code); 
  15. session.setAttribute("symbol", symbol); 
  16. %> 
  17. 同时指定currencyCode和currencySymbol属性,前者优先于后者: 
  18. <fmt:formatNumber value="1234567.11" type="currency" currencyCode="${code}"  
  19. currencySymbol="${symbol}" /> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
<%@ page import="java.util.Currency,java.util.Locale"%>
将数值格式化为货币格式:

将数值格式化为百分数格式:
将数值格式化为自定义的格式:
<% String code = Currency.getInstance(Locale.CHINA).getCurrencyCode(); String symbol = Currency.getInstance(Locale.US).getSymbol(); session.setAttribute("code", code); session.setAttribute("symbol", symbol); %> 同时指定currencyCode和currencySymbol属性,前者优先于后者:

例程8-35的运行结果如图8.31 所示。

标签

标签与标签的作用正好相反,它用于将一个按本地化方式被格式化后的数值、货币或百分数解析为数值,它有如下两种语法格式:

语法1,没有标签体的情况:

[type="{number|currency|percent}"]

[pattern="customPattern"]

[parseLocale="parseLocale"]

[integerOnly="{true|false}"]

[var="varName"]

[scope="{page|request|session|application}"] />

语法2,有标签体的情况,在标签体中指定要被解析的数值:

[pattern="customPattern"]

[parseLocale="parseLocale"]

[integerOnly="{true|false}"]

[var="varName"]

[scope="{page|request|session|application}"]>

numeric value to be parsed

标签的属性说明如表8.20所示。


表8.20 标签的属性

标签有如下一些特性:

  • 如果value属性的值为null或空字符串,则将scope属性指定的Web域中的var属性指定的域属性删除。如果value属性的值不能解析为数值就抛出异常。
  • pattern属性指定的模式字符串必须符合java.text.DecimalFormat类的模式语法。如果其值为null或空字符串,就相当于没有设置这个属性的值。使用解析值时要特别注意,它执行的解析非常严格,要解析的数值字符串必须严格符合特定的本地环境及pattern属性设置的自定义格式。
  • 如果parseLocale属性的值为null或空字符串,就相当于没有指定该属性。
  • integerOnly属性指定是否只是解析value的整数部分。详细信息请看java.text.NumberFormat接口的setParseIntegerOnly()方法。
  • 如果同时指定type属性和pattern属性,后者优先权高于前者。
  • 如果设置了var属性,将解析的结果保存在某个Web域中的var属性指定的域属性中;否则,将使用java.lang.Number.toString()直接输出解析的结果。如果指定scope属性,则必须指定var属性。
  • 如果标签不能确定解析的本地环境,就抛出JspException异常,异常信息中包含要解析的字符串。

例程8-36是一个使用标签的例子程序。

例程8-36 fmt_parseNumber.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. 本地环境为“en_US”解析字符串“$123,456,789.00”: 
  4. <fmt:parseNumber value="$123,456,789.00" type="currency" parseLocale="en_US"/> 
  5. <hr/> 
  6. 解析整个数值字符串“123,456,789%”: 
  7. <fmt:parseNumber value="123,456,789%" type="percent" /><hr /> 
  8. 只解析“123,456,789%”的整数部分: 
  9. <fmt:parseNumber value="123,456,789%" type="percent" integerOnly="true"/><hr /> 
  10. 同时设置type和pattern属性,后者优先于前者: 
  11. <fmt:parseNumber value="12.3" type="currency" pattern=".000" /> 
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
本地环境为“en_US”解析字符串“$123,456,789.00”:


解析整个数值字符串“123,456,789%”:
只解析“123,456,789%”的整数部分:
同时设置type和pattern属性,后者优先于前者:


例程8-36的运行结果如图8.32 所示。


注意:在分层设计的软件架构中,JSP页面通常仅用于实现系统的表示层,数据解析的任务不适合在表示层进行处理,而最好是业务逻辑层进行处理,所以,为了增强软件的易维护性和可扩展性,读者应尽量避免在JSP 页面中使用标签。

JSTL函数

为了简化在JSP页面操作字符串,JSTL中提供了一套EL自定义函数,这些函数包含了JSP页面制作者经常要用到的字符串操作。例如,fn:toLowerCase将字符串中的字符变为小写,fn:indexOf返回一个指定字符串在另一个字符串中第一次出现的索引位置。

JSTL中提供的EL自定义函数必须在EL表达式中使用,例如,${fn:toUpperCase("www.it315.org")}。

fn:toLowerCase函数

fn:toLowerCase函数将一个字符串中包含的所有字符转换为小写形式,并返回转换后的字符串,它接收一个字符串类型的参数。

fn:toLowerCase函数的应用举例:

l fn:toLowerCase("Www.IT315.org") 的返回值为字符串“www.it315.org”

l fn:toLowerCase("")的返回值为空字符串

fn:toUpperCase函数

fn:toUpperCase函数将一个字符串中包含的所有字符转换为大写形式,并返回转换后的字符串,它接收一个字符串类型的参数。

fn:toUpperCase函数的应用举例:

l fn:toUpperCase("Www.IT315.org") 的返回值为字符串“WWW.IT315.ORG”

l fn:toUpperCase("")的返回值为空字符串

fn:trim函数

fn:trim函数删除一个字符串的首尾的空格,并返回删除空格后的结果字符串,它接收一个字符串类型的参数。需要注意的是,fn:trim函数不能删除字符串中间位置的空格。

例如,fn:trim("   www.it  315.org  ") 的返回值为字符串“www.it  315.org”。

fn:escapeXml函数

fn:escapeXml函数将字符串中的需要进行转义的HTML特殊字符按表8.2进行HTML编码转换,并返回转换后的字符串,这样就可以在浏览器中显示出HTML特殊字符。fn:escapeXml函数接收一个字符串类型的参数。

例如,运行包含如下代码的JSP文件后浏览器将跳转到“http://www.it315.org”页面,这是因为这些代码被浏览器作为HTML标签解释执行:

如果用fn:escapeXml函数处理上面的代码,运行JSP文件后就在浏览器窗口输出这行代码,例程8-54是使用fn:escapeXml函数处理上面的代码的例子程序。

例程8-54  fn_escapeXml.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %> 
  2. ${fn:escapeXml('<meta http-equiv="refresh"  
  3. content="0;url=http://www.it315.org"/>')} 
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
${fn:escapeXml('')}

fn_escapeXml.jsp页面的运行结果如图8.46所示。

fn:length函数

fn:length函数用于返回一个集合或数组对象中包含的元素的个数,或返回一个字符串中包含的字符的个数,返回值为int类型。fn:length函数接收一个参数,这个参数可以是标签的items属性支持的任何类型,包括任意类型的数组、java.util.Collection、java.util.Iterator、java.util.Enumeration、java.util.Map等类的实例对象和字符串。

如果fn:length函数的参数为null或者是元素个数为0的集合或数组对象,则函数返回0;如果参数是空字符串,则函数返回0。例程8-55是使用fn:length函数的实例程序。

例程8-55  fn_length.jsp

[html] view plain copy print ?
  1. <%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %> 
  2. <%@ page contentType="text/html;charset=gb2312" %> 
  3. <%@ page import="java.util.*, org.it315.UserBean" %> 
  4. <
  5. Collection users = new ArrayList(); 
  6. for(int i=0; i<5; i++) 
  7. UserBean user = new UserBean(); 
  8. user.setUserName("user" + i); 
  9. user.setPassword("guest" + i); 
  10. users.add(user); 
  11. session.setAttribute("users", users); 
  12. %> 
  13. There are ${fn:length(users)} users online.<hr /> 
  14. 字符串“www.it315.org”中包含 ${fn:length("www.it315.org")} 个字符 
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<%@ page contentType="text/html;charset=gb2312" %>
<%@ page import="java.util.*, org.it315.UserBean" %>
<%
Collection users = new ArrayList();
for(int i=0; i<5; i++)
{
UserBean user = new UserBean();
user.setUserName("user" + i);
user.setPassword("guest" + i);
users.add(user);
}
session.setAttribute("users", users);
%>
There are ${fn:length(users)} users online.
字符串“www.it315.org”中包含 ${fn:length("www.it315.org")} 个字符


fn_length.jsp页面的运行结果如图8.47所示。

fn:split函数

fn:split函数以指定字符串作为分隔符,将一个字符串分割成字符串数组并返回这个字符串数组。fn:split函数接收两个字符串类型的参数,第一个参数表示要分割的字符串,第二个参数表示作为分隔符的字符串。

l fn:split函数实现java.util.StringTokenizer类分割字符串的操作,得到的字符串数组中的各字符串元素不包含分隔符本身,例如,fn:split("www.it315.org", ".")[1]的返回值为字符串“it315”。

  • l 如果第一个参数是空字符串,则fn:split函数返回的字符串数组中只包含空字符串这一个元素,例如,fn:split("", ".")[0]的返回值为空字符串。
  • l 如果第二个参数是空字符串,则函数返回的字符串数组中只包含源字符串这一个元素,例如,fn:split("www.it315.org", "")[0]的返回值为字符串“www.it315.org”,fn:split("www.it315.org", "")[1]的返回值为空字符串。

fn:join函数

fn:join函数以一个字符串作为分隔符,将一个字符串数组中的所有元素合并为一个字符串并返回合并后的结果字符串。fn:join函数接收两个参数,第一个参数是要操作的字符串数组,第二个参数是作为分隔符的字符串。

如果fn:join函数的第二个参数是空字符串,则fn:join函数的返回值是不使用任何分隔符将字符串数组中的各元素连接起来的结果字符串。

fn:join函数的应用举例:

  • l 假设stringArray是保存在Web域中的一个属性,它表示一个值为{"www","it315","org"}的字符串数组,则fn:join(stringArray, ".")返回字符串“www.it315.org”
  • l fn:join(fn:split("www,it315,org", ","), ".") 的返回值为字符串“www.it315.org”

fn:indexOf函数

fn:indexOf函数返回指定字符串在一个字符串中第一次出现的索引值,返回值为int类型。fn:indexOf函数接收两个字符串类型的参数,如果第一个参数字符串中包含第二个参数字符串,那么,不管第二个参数字符串在第一个参数字符串中出现几次,fn:indexOf函数总是返回第一次出现的索引值;如果第一个参数中不包含第二个参数,则fn:indexOf函数返回-1。如果第二个参数为空字符串,则fn:indexOf函数总是返回0。

fn:indexOf函数的应用举例:

  • l fn:indexOf("www.it315.org","t3") 的返回值为5
  • l fn:indexOf("www.it315.org","aaa") 的返回值为 -1
  • l fn:indexOf("www.it315.org","") 的返回值为0

fn:contains函数

fn:contains函数检测一个字符串中是否包含指定的字符串,返回值为布尔类型。fn:contains函数在比较两个字符串是否相等时是大小写敏感的。

fn:contains函数接收两个字符串类型的参数,如果第一个参数字符串中包含第二个参数字符串,则fn:contains函数返回true,否则返回false。如果第二个参数的值为空字符串,则fn:contains函数总是返回true。实际上,fn:contains(string, substring)等价于fn:indexOf(string, substring) != -1。

fn:contains函数的应用举例:

  • l fn:contains("www.it315.org", "org")的返回值为true
  • l fn:contains("www.it315.org", "Org")的返回值为false
  • l fn:contains("", "")的返回值为true

fn:containsIgnoreCase函数

fn:containsIgnoreCase函数检测一个字符串中是否包含指定的字符串,在比较两个字符串是否相等时大小写不敏感。fn:containsIgnoreCase函数的参数和返回值的类型都与fn:contains函数相同,只是前者在比较两个字符串是否相等时不考虑字符的大小写,而后者考虑字符的大小写,fn:containsIgnoreCase(string, substring)等价于fn:contains(fn:toUpperCase(string),fn:toUpperCase(substring))。

fn:containsIgnoreCase函数的应用举例:

  • l fn:containsIgnoreCase("www.it315.org", "Org") 的返回值为 true
  • l fn:containsIgnoreCase (fn:toUpperCase("www.it315.org"), fn:toUpperCase("Org"))的返回值为true

fn:startsWith函数

fn:startsWith函数用于检测一个字符串是否是以指定字符串开始的,返回值为布尔类型。

fn:startsWith函数接收两个字符串类型的参数,如果第一个参数字符串以第二个参数字符串开始,则函数返回true,否则函数返回false。如果第二个参数为空字符串,则fn:startsWith函数总是返回true。实际上,fn:startsWith(string, prefix)等价于表达式fn:indexOf(string, prefix) == 0

fn:startsWith函数的应用举例:

  • l fn:startsWith("www.it315.org","it315")的返回值为false
  • l fn:startsWith("www.it315.org","www")的返回值为true
  • l fn:startsWith("www.it315.org","")的返回值为true

fn:endsWith函数

fn:endsWith函数用于检测一个字符串是否是以指定字符串结束的,返回值为布尔类型。

fn:endsWith函数接收两个字符串类型的参数,如果第一个参数字符串以第二个参数字符串结束,则函数返回true,否则函数返回false。如果第二个参数为空字符串,则fn:endsWith函数总是返回true。

fn:endsWith函数的应用举例:

  • l fn:endsWith("www.it315.org","it315")的返回值为false
  • l fn:endsWith("www.it315.org","org")的返回值为true
  • l fn:endsWith("www.it315.org","")的返回值为true

fn:replace函数

fn:replace函数将一个字符串中包含的指定子字符串替换为其它的指定字符串,并返回替换后的结果字符串。fn:replace方法接收三个字符串类型的参数,第一个参数表示要操作的源字符串,第二个参数表示源字符串中要被替换的子字符串,第三个参数表示要被替换成的字符串。

fn:replace函数按照下面的说明执行字符串的替换操作:

1)源字符串中所有的第二个参数指定的子字符串都被替换成第三个参数指定的字符串,如果替换后的结果字符串中包含第二个参数指定的子字符串,则不再进行替换。例如,

  • l fn:replace("www it315 org", " ", ".")的返回值为字符串“www.it315.org
  • l fn:replace("ddabccff", "abc", "ab")的返回值为字符串“ddabcff”,这个字符串中还包含字符串“abc”,但不再执行替换操作

2)如果第一个参数是空字符串,则fn:replace函数返回空字符串,例如,fn:replace("", " ", ".")的返回值为空字符串。

3)如果第二个参数是空字符串,则fn:replace函数不执行任何替换操作,返回第一个参数指定的字符串。例如,fn:replace("www.it315.org", "", " ") 的返回值为字符串“www.it315.org”。

4)如果第三个参数是空字符串,则fn:replace函数删除源字符串中包含的第二个参数指定的子字符串。例如,fn:replace("www.it315.org", ".", "")的返回值为字符串“wwwit315org”。

fn:substring函数

fn:substring函数用于截取一个字符串的子字符串并返回截取到的子字符串。fn:substring函数接收三个参数,第一个参数是用于指定要操作的源字符串,第二个参数是用于指定截取子字符串开始的索引值,第三个参数是用于指定截取子字符串结束的索引值,第二个参数和第三个参数都是int类型,其值都从0开始。

fn:substring函数按照下面的说明截取一个字符串的子字符串:

  • l 如果第二个参数的值大于或等于源字符串中包含的字符个数,则fn:substring函数返回空字符串;
  • l 如果第二个参数的值小于0,则将其值设置为0
  • l 如果第三个参数的值小于0或大于源字符串中包含的字符个数,则截取到源字符串的结尾的字符;
  • l 如果第三个参数的值小于第二个参数的值,则fn:substring函数返回空字符串。

fn:substring函数的应用举例(字符串“www.it315.org”中包含13个字符):

  • l fn:substring("www.it315.org", 4, 9) 的返回值为字符串“it315”
  • l fn:substring("www.it315.org", 13, 14) 返回空字符串
  • l fn:substring("www.it315.org", -1, 9) 的返回值为字符串“www.it315”
  • l fn:substring("www.it315.org", 4, -1) 的返回值为字符串“it315.org”
  • l fn:substring("www.it315.org", 4, 13) 的返回值为字符串“it315.org”
  • l fn:substring("www.it315.org", 4, 3) 返回空字符串

fn:substringAfter函数

fn:substringAfter函数用于截取并返回一个字符串中的指定子字符串第一次出现之后的子字符串。fn:substringAfter函数接收两个字符串类型的参数,第一个参数表示要操作的源字符串,第二个参数表示指定的子字符串,例如,fn:substringAfter("www.it315.org", ".")的返回值为字符串“it315.org”。

fn:substringAfter函数按照下面的说明截取一个字符串的子字符串:

  • l 如果第一个参数是空字符串,则fn:substringAfter函数返回空字符串,例如fn:substringAfter("", ".") 的返回值为空字符串;
  • l 如果第二个参数是空字符串,则fn:substringAfter函数的返回值为源字符串,例如,fn:substringAfter("www.it315.org", "")的返回值为字符串“www.it315.org”;
  • l 如果第二个参数不是第一个参数的子字符串,则substringAfter函数返回空字符串,例如,fn:substringAfter("www.it315.org", "itorg")的返回值为空字符串。

fn:substringBefore函数

fn:substringBefore函数用于截取并返回一个字符串中的指定子字符串第一次出现之前的子字符串。fn:substringBefore函数接收两个字符串类型的参数,第一个参数表示要操作的源字符串,第二个参数表示指定的子字符串,例如,fn:substringBefore("www.it315.org", ".") 的返回值为字符串“www”。

fn:substringBefore函数按照下面的说明截取一个字符串的子字符串:

  • l 如果第一个参数是空字符串,则fn:substringBefore函数返回空字符串,例如,fn:substringBefore("", ".") 的返回值为空字符串;
  • l 如果第二个参数是空字符串,则fn:substringBefore函数返回空字符串,例如,fn:substringBefore("www.it315.org", "") 的返回值为空字符串
  • l 如果第二个参数不是第一个参数的子字符串,则fn:substringBefore函数返回空字符串,例如,fn:substringBefore("www.it315.org", "itorg") 的返回值为空字符串。

你可能感兴趣的:(Java,struts2)