国际化主要的好处就是在不修改程序的代码的前提下,在根据客户端所处的地区语言环境显示相应的界面。struts2国际化是建立在java国际化的基础上的,借助于拦截器和国际化资源文件,使得国际化实现更加简单。
1、国际化资源文件命名规则
baseName_language_country.properties
例如
message_zh_CN.properties
message_en_US.properties
第一个是中文,第二个是英文,baseName可以自己起,但是后面就得一摸一样,否则会出错,我就是把CN改成CH,然后想在jsp那里输出资源文件内容struts2就找不到就显示了key值。
2、资源文件的类型有四个:
(1)全局资源文件,对整个应用程序有效,保存在src下,并且全局资源文件需要在struts.xml中使用
<constant name="struts.custom.i18n.resources" value="baseName"/>
在<package>上面
(2)包级别的资源文件,对包及子包中所有类有效,需要在包目录下新建。package_language_country.properties
(3)动作类级别资源文件:只对指定的动作类有效,需要在动作类同一个目录下新建。动作类名_language_country.properties
(4)临时的资源文件:用于视图页面中输出国际化消息时临时指定国际化资源文件,此时需要使用<s:i18n name="baseName">来指定资源文件,可将该标签作为<s:text>或表单标签的父标签。注:临时资源文件名字任意,必须放在src下。
注意除了全局资源文件外,其他资源不需要在struts.xml配置文件中定义,sttuts2会自动按名字取加载资源文件。
3、资源文件的加载顺序
重点:
1、国际化消息的输出
在jsp中输出资源文件内容:
(1)使用s:text标签方式获取资源文件的内容
<s:text name="login.success">
<s:param>
<s:property value="username"/>
</s:param>
</s:text>
资源文件为:
login.name=username
login.password=password
login.submit=submit
login.success=hello,{0},welcome to mysite
其中param是指定带占位符的国际化消息,就是把动作类里的username属性获取然后把它放到{0}的位置。还有序号从0开始。这是直接在页面输出
(2)如果想在表单的label输出资源文件内容:
<s:form action="login" namespace="/i18n">
<s:textfield name="username" key="login.name"/>
<s:password name="password" key="login.password"/>
<s:submit key="login.submit"/>
</s:form>
(3)想在动作类中输出资源文件内容:
String tip = getText("login.name");
2、带占位符的国际化消息
除了在S:text中替换还可以通过动作类中的getText
完整例子
LoginAction
package com.ljs.struts.two;
import com.opensymphony.xwork2.ActionSupport;
public class LoginAction extends ActionSupport {
private String username;
private String password;
private String tip;
public String execute () {
if(username==null||username.trim().length()==0) {
return LOGIN;
} else {
tip = getText("login.success", new String[] {username});
return SUCCESS;
}
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getTip() {
return tip;
}
public void setTip(String tip) {
this.tip = tip;
}
public LoginAction() {
// TODO Auto-generated constructor stub
}
}
login.jsp
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<s:form action="login" namespace="/i18n">
<s:textfield name="username" key="login.name"/>
<s:password name="password" key="login.password"/>
<s:submit key="login.submit"/>
</s:form>
</body>
</html>
success.jsp
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<body>
<h3>
国际化方式一:使用s:text标签方式获取资源文件的内容
</h3>
<s:text name="login.success">
<s:param>
<s:property value="username"/>
</s:param>
</s:text>
<h3>
国际化方式二:通过动作类调用getText(key)方法来获取资源文件的内容
</h3>
<s:property value="tip"/>
</body>
</html>
struts.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd">
<!-- Struts2配置文件的根元素 -->
<struts>
<constant name="struts.custom.i18n.resources" value="message"/>
<package name="i18n" extends="struts-default" namespace="/i18n">
<action name="login" class="com.ljs.struts.two.LoginAction">
<result name="login">/login.jsp</result>
<result name="success">/success.jsp</result>
</action>
</package>
</struts>
还有一个注意的,我虽然改正了资源文件的名字,但是动作类里却忘记
了get和set方法,导致点提交execute方法里的username一直为null,所以跳不到success。