Struts2讲义39

9.1.2          占位符国际化使用方式

占位符的使用目的是可以让开发者可以动态的填入某些国际化的值。也许这句话读者看的不是很明白。试举一例，在我们平时日常语言中常常会说“我。。。”。在“我”之后，我们可以根据不同情况加上不同的内容。因此占位符就充当了“我”之后的那些内容表达意义的角色。在不同语言环境和不同的业务逻辑下，占位符所代表的含义可以千变万化。相应的也可以说动态的显示了不同的信息。在 Struts2 国际化应用中，使用占位符可以展现各种语言字符。

技术要点

以登录功能为例，来介绍占位符的国际化。

国际化属性文件中占位符的使用方式。

多个 getText 方法介绍。

text 标签中指定占位符位置。

演示代码

使用的 Action 文件：

<!------------文件名：LoginAction.java-------------->
public class LoginAction extends ActionSupport {
    ………
         public String execute() throws Exception {
                   username = getUsername();// 属性值即JSP页面上输入的值
                   password = getPassword();// 属性值即JSP页面上输入的值

                   //定义getText方法需要的参数变量   
                   List valueList =  new ArrayList();
                   String[] valueArray = {null,null};
                   String defaultValue = "default";

                   try {
                            // 判断输入值是否是空对象或没有输入
                            if (username != null && !username.equals("") && password != null
                                               && !password.equals("")) {
ActionContext.getContext().getSession().put("user", getUsername());

                                     //对getText方法需要的参数变量赋予开发需要的值
                                     valueList.add(username);
                                     valueList.add(password);
                                     valueArray[0]=username;
                                     valueArray[1]=password;

                                     //打印各个getText方法，显示占位符中的属性值
System.out.println(getText("successMessage"));
System.out.println(getText("successMessage",valueList));
System.out.println(getText("successMessage",valueArray));
System.out.println(getText("successMessage",defaultValue,valueList));
System.out.println(getText("successMessage",defaultValue,valueArray));
                            // 根据标志内容导航到操作成功页面
                                     FORWARD = "success";
                            } else {
                            // 根据标志内容导航到操作失败页面
                                     FORWARD = "input";
                            }
                   } catch (Exception ex) {
                            ex.printStackTrace();
                   }
                   return FORWARD;
         }
………
}

 

使用占位符的中文属性文件内容：

<!---------------文件名：messageResource_zh_CN.properties-------------->
………
successMessage={0},欢迎您!您的密码为{1}，请注意保存。

 

使用占位符的英文属性文件内容：

<!--------------文件名：messageResource_en_US.properties---------->
………
successMessage={0},Welcome !Your password is{1},please remember it。

 

使用占位符的登录成功 success.jsp 中文件：

<!------------------文件名：success.jsp---------------------->
………
<!-- 取得属性文件中定义的值 -->
    <s:text name="successMessage">
    <!-- 占位符{0}的值由用户名值填充 -->
    <s:param><s:property value="username"/></s:param>
    <!-- 占位符{1}的值由密码值填充 -->
    <s:param><s:property value="password"/></s:param>
</s:text>…
………

 

显示占位符的中文登录成功界面如图 9.7 。

 

图 9.7  占位符中文登录成功界面

显示占位符的英文登录成功界面如图 9.8 。

 

图 9.8  占位符英文登录成功界面

LoginAction 代码中打印在控制台用户名和密码值（支持中文）如图 9.9 。

 

 

图 9.9  中文属性值控制台打印信息

LoginAction 代码中打印在控制台用户名和密码值（支持英文）如图 9.10 。

 

 

图 9.10  英文属性值控制台打印信息

代码解释

（ 1 ）在本示例中笔者在登录成功的显示信息中使用了两个占位符。占位符在属性文件中的写法都是以“ {} ”格式，第一个可以在“ {} ”中写上 0 ，表示是第一个占位符位置。依此类推后面依次是“ {1} ”，“ {2} ”等等。这里本示例中是想把登录成功后的用户名数据填充到“ {0} ”之中。将用户密码填充到“ {1} ”之中。所以在两个国际化属性文件中的“ successMessage ”的 value 值中都有“ {0} ”和“ {1} ”。

（ 2 ）之前也已说过 LoginAction 继承 ActionSupport 类后可以使用 ActionSupport 中 getText 方法。而 getText 方法是个重载方法，因此它的同名方法又很多。具体都是使用在又占位符的属性文件中。

这里将前一小节中介绍过的 getText 方法一起列出来。各个 getText 方法使用用途和方法申明如下：

String getText(String  key) ：上一小节已说明将属性文件中的 key 作为参数得到属性文件中 value 值。

String getText(String key,List  valueList) ：将属性文件中 key 映射的 value 中所有占位符封装成 List 变量，返回有占位符的 value 值。

String getText(String key,String[] valueArray) ：将属性文件中 key 映射的 value 中所有占位符封装成字符串数组变量，返回有占位符的 value 值。

String getText(String key,String defaultValue,List valueList) ：将属性文件中 key 映射的 value 中所有占位符封装成 List 变量，返回有占位符的 value 值。如果 List 变量为空或者没有将占位符代表的值赋予它，则返回缺省的 defaultValue 。

String getText(String key,String defaultValue,String[] valueArray) 将属性文件中 key 映射的 value 中所有占位符封装成字符串数组变量，返回有占位符的 value 值。如果字符串数组变量为空或者没有将占位符代表的值赋予它，则返回缺省的 defaultValue 。

请读者查看本示例中 LoginAction 的打印方法，“ successMessage ”中如果有值赋予占位符则打印出这些值。如果没有，就如图 9.9 、图 9.10 第一行所示打印出“ {0} ”，“ {1} ”。而因为 valueList 和 valueArray 在 LoginAction 中都有值赋予，因此调用 String getText(String key,String defaultValue,String[] valueArray) 和 String getText(String key,String defaultValue,List valueList) 时候打印出来的结果值并不是参数 defaultValue 的值。如果没有则打印出来的内容应该为“ default ”即 Action 中定义的 defaultValue 值。

（ 3 ）在 success.jsp 中，还是使用 struts2 标签 <text> 。只不过在 text 标签中加了 <param> 标签，在 Struts2 标签章节中也已介绍过这个 <param> ，该标签可以嵌套在其他很多标签中，作为参数定义。这里由于“ successMessage ”中有两个占位符定义，因此定义了两个 <param> 标签。使用 < property > 标签显示属性文件中“ username ”和“ password ”两个 key 映射的 value 值。效果见图 9.7 、图 9.8 。

国际化用的太少了