jsp JSTL fmt 标签库

小鱼儿 2022-12-23 06:43 144阅读 0赞

formatting标签库:就是用于在 JSP 页面中做国际化格式化的动作  
分为了两类，分别是：                                                                                                    
国际化核心标签:<fmt:setLocale>、<fmt:bundle>、<fmt:setBundle>、<fmt:message>、<fmt:param>、<fmt:requestEncoding>  
格式化标签:<fmt:timeZone>、<fmt:setTimeZone>、<fmt:formatNumber>、<fmt:parseNumber>、<fmt:formatDate>、<fmt:parseDate>

1.<fmt:setLocale>标签:用于设置本地化环境  
属性描述  (java 项目 www.fhadmin.org)  
value:Locale 环境的指定，可以是 java.util.Locale 或 String 类型的实例   
scope:Locale 环境变量的作用范围（可选）   
如:  
    设置本地环境为繁体中文  
    <fmt:setLocale value="zh\_TW"/>  
    设置本地环境为简体中文  
    <fmt:setLocale value="zh\_CN"/>

2.<fmt:requestEncoding>标签:用于为请求设置字符编码  
它只有一个属性 value ，在该属性中可以定义字符编码。   
如：  
    <fmt:requestEncoding value="GB2312"/>

3.<fmt:bundle> 、 <fmt:setBundle> 标签:用于资源配置文件的数据来源  
3.1<fmt:bundle> 标签将资源配置文件绑定于它标签体中的显示  
属性描述  
basename:资源配置文件的指定，只需要指定文件名而无须扩展名  
prefix:前置关键字  
如:  
资源文件中配置的数据为:  
label.backcolor=\#FFF  
label.fontcolor=\#000  
则,可以用如下方法取得label的backcolor和fontcolor值:  
    <fmt:bundle basename="MyResourse" prefix="label.">   
        <fmt:message key="backcolor" />  
        <fmt:message key="fontcolor" />  
    </fmt:bundle>

3.2<fmt:setBundle> 标签则允许将资源配置文件保存为一个变量，在之后的工作可以根据该变量来进行  
属性描述 ，二组标签共有的属性   
var:<fmt:setBundle> 独有的属性，用于保存资源配置文件为一个变量   
scope:变量的作用范围   
如:  
    查找一个名为 applicationMessage\_zh\_CN.properties 的资源配置文件，来作为显示的 Resource 绑定  
    <fmt:setBundle basename="applicationMessage" var="applicationBundle"/>

4.<fmt:message> 标签:用于显示资源配置文件信息(该资源文件必须遵循如下格式:1.扩展名必须为properties,2.文件的内容必须依照key = value的格式;3.文件要放到WEB-INF/classes目录下)  
属性描述   
key:资源配置文件的“键”指定   
bundle:若使用 <fmt:setBundle> 保存了资源配置文件，该属性就可以从保存的资源配置文件中进行查找   
var:将显示信息保存为一个变量   
scope:变量的作用范围   
如:  
1)用<fmt:setBundle>标签将"applicationMessage"资源配置文件被赋于了变量"applicationBundle"  
    用<fmt:message>标签显示由<fmt:setBundle>标签保存的资源配置文件中"键"为"passWord"的信息  
      
        <fmt:setBundle basename="applicationMessage" var="applicationBundle"/>   
        <fmt:message key="passWord" bundle="$\{applicationBundle\}" />

2)用<fmt:bundle>标签定义的"applicationAllMessage"资源配置文件作用于其标签体内的显示  
    用<fmt:message>标签显示"applicationAllMessage"资源配置文件中"键"为"userName"的信息

<fmt:bundle basename="applicationAllMessage">   
            <fmt:message key="userName" />  
        </fmt:bundle>

5.<fmt:param 标签:用于参数传递  
<fmt:param>标签应该位于 <fmt:message> 标签内，将为该消息标签提供参数值。它只有一个属性value   
如：在MyResourse.properties文件中,有一个索引值如下(其中,\{0\}代表占位符):  
Str2=Hi,\{0\}   
则,使用<fmt:param>标签传入值如下:  
    <fmt:bundle basename="MyResourse">   
        <fmt:message key="Str2">  
            <fmt:param value="张三" />  
        </fmt:message>  
    </fmt:bundle>  
也可以在资源文件中指定参数的类型:  
如:在MyResourse.properties文件中,有一个索引值如下:  
Str3=\{0,date\}  
则,使用<fmt:param>标签传入值如下:  
    <% request.setAttribute("now",new Date()); %>  
    <fmt:bundle basename="MyResourse">   
        <fmt:message key="Str3">  
            <fmt:param value="$\{now\}" />  
        </fmt:message>  
    </fmt:bundle>

6.<fmt:timeZone>、<fmt:setTimeZone>标签:用于设定时区  
<fmt:timeZone> 标签将使得在其标签体内的工作可以使用该时区设置  
<fmt:setTimeZone> 标签则允许将时区设置保存为一个变量，在之后的工作可以根据该变量来进行  
属性描述   
value:时区的设置   
var:<fmt:setTimeZone> 独有的属性，用于保存时区为一个变量   
scope:变量的作用范围

7.<fmt:formatNumber>标签:用于格式化数字  
属性描述   
value:格式化的数字,该数值可以是 String 类型或 java.lang.Number 类型的实例   
type:格式化的类型,可能值包括:currency（货币）、number（数字）和percent（百分比）  
pattern:格式化模式   
var:结果保存变量   
scope:变量的作用范围   
maxIntegerDigits:指定格式化结果的最大值   
minIntegerDigits:指定格式化结果的最小值   
maxFractionDigits:指定格式化结果的最大值，带小数   
minFractionDigits:指定格式化结果的最小值，带小数

如:  
    结果将被保存在“ money ”变量中，将根据 Locale 环境显示当地的货币格式  
        <fmt:formatNumber value="1000.888" type="currency" var="money"/>

8.<fmt:parseNumber> 标签:用于解析数字  
属性描述   
value:将被解析的字符串   
type:解析格式化的类型   
pattern:解析格式化模式   
var:结果保存变量，类型为 java.lang.Number   
scope:变量的作用范围   
parseLocale:以本地化的形式来解析字符串，该属性的内容应为 String 或 java.util.Locale 类型的实例

如:  
    将"15%"转换为数字  
        <fmt:parseNumber value="15%" type="percent" var="num"/>

9.<fmt:formatDate>标签:用于格式化日期  
属性描述  
value:格式化的日期，该属性的内容应该是 java.util.Date 类型的实例  
type:格式化的类型  
pattern:格式化模式  
var:结果保存变量  
scope:变量的作用范围  
timeZone:指定格式化日期的时区

10.<fmt:parseDate>标签:用于解析日期  
属性描述   
value:将被解析的字符串   
type:解析格式化的类型   
pattern:解析格式化模式   
var:结果保存变量，类型为 java.lang.Date   
scope:变量的作用范围   
parseLocale:以本地化的形式来解析字符串，该属性的内容为 String 或 java.util.Locale 类型的实例   
timeZone:指定解析格式化日期的时区