配置国际化资源文件
Action范围资源文件
在Action类文件所在的路径建立名为ActionName_language_country.properties
的文件。
例如:Action类为Testi18nAction的话,则命名为Testi18nAction_en_US.properties
包范围资源文件
在包的根路径下建立文件名为package_language_country.properties
的属性文件,一旦建立,处理该包下的所有Action都可以访问该资源文件。
注意:包范围资源文件中的baseName
就是package
,不是Action所在的包名全局资源文件
命名方式:basename_language_country.properties
在struts.xml
中配置:<constant name="struts.custom.i18n.resources" value="baseName">
。
例如:命名为i18n_en_US.properties
,在struts.xml
中配置:<constant name="struts.custom.i18n.resources" value="i18n">
。国际化资源文件加载的顺序
离当前Action较近的将被优先加载
在页面上和Action类中访问国际化资源文件
在Action类中,若Action实现了
TextProvider
接口,则可以调用其getText()
方法获取value
值
通过继承ActionSupport就能间接实现TextProvider
接口。页面上可以使用
<s:text>
标签,对于表单标签可以使用标签标签的key
属性值
若有占位符,则可以使用<s:text>
标签的<s:param>
子标签来填充占位符。
可以利用标签和OGNL直接访问值栈中的属性值,包括对象栈和Map栈
Demo:
使用全局进行配置:
在struts.xml
中配置<constant name="struts.custom.i18n.resources" value="i18n"></constant>
jsp代码:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<s:form action="">
<!-- key是直接上资源文件中获取value值 -->
<s:textfield name="username" key="username"></s:textfield>
<!-- 如果不用key属性,则也可以强制使用OGNL标签来调getText()方法获取value值-->
<s:textfield name="username" label="%{getText('username')}"></s:textfield>
<s:textfield name="password" key="password"></s:textfield>
<s:submit key="submit"></s:submit>
</s:form>
</body>
</html>
对于上述的Demo,在<s:textfield name="username" key="username"></s:textfield>
有使用到key
属性,因此可以直接获取国际化资源文件value
值,如果不使用key
属性,而是使用label
属性,则可以<s:textfield name="username" label="%{getText('username')}"></s:textfield>
获取,因为此时在对象栈中有DefaultTextProvi
的一个实例,该对象中提供了访问国际化资源文件的getText()
方法。并且在字符串中要进行强制的OGNL解析,因此需要%{}
。但是这只是在主题不是simple的情况下。如果主题是simple的话,上述代码不能实现,应该使用<s:text>
标签,因此做一些修改如下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<s:form action="" theme="simple">
<s:text name="username"/>:<s:textfield name="username" key="username"></s:textfield>
<s:text name="username"/>:<s:textfield name="username" label="%{getText('username')}"></s:textfield>
<s:text name="password"/>:<s:textfield name="password" key="password"></s:textfield>
<s:submit key="submit" value="%{getText('submit')}"></s:submit>
</s:form>
</body>
</html>
- 访问带占位符的Demo
需要自己编写一个继承ActionSupport的Action类,在值栈中填入带占位符的属性即可。
在jsp页面中用到<s:text>
标签并在该标签中使用<s:param>
子标签填充属性即可。
Testi18nAction类:
package com.cerr.struts2.i18n.app;
import com.opensymphony.xwork2.ActionSupport;
import java.util.Arrays;
import java.util.Date;
public class Testi18nAction extends ActionSupport {
private Date date = null;
@Override
public String execute() throws Exception {
date = new Date();
//在Action中访问国际化资源文件的value值
String username = getText("username");
System.out.println(username);
//访问带占位符的
String time = getText("time", Arrays.asList(date));
System.out.println(time);
return SUCCESS;
}
public Date getDate() {
return date;
}
public void setDate(Date date) {
this.date = date;
}
}
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">
<struts>
<!-- 配置国际化资源文件 -->
<constant name="struts.custom.i18n.resources" value="i18n"></constant>
<package name="default" namespace="/" extends="struts-default">
<action name="testi18nAction" class="com.cerr.struts2.i18n.app.Testi18nAction" method="execute">
<result name="success">/i18n.jsp</result>
</action>
</package>
</struts>
i18n.jsp:
<%@ taglib prefix="s" uri="/struts-tags" %>
<%--
Created by IntelliJ IDEA.
User: 白菜
Date: 2019/8/6
Time: 10:34
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<s:text name="time">
<!-- value中的值为值栈栈顶的属性值-->
<s:param value="date"></s:param>
</s:text>
</body>
</html>
实现通过超链接切换语言
关键之处在于Struts2框架是如何确定Locale对象的,确定Locale对象的流程图如下:
具体流程如下:
i18n
拦截器在执行Action方法之前,自动查找请求中一个名为request_locale
的参数,如果该参数存在,拦截器就将其作为参数,转换成Locale
对象,并将其设为用户默认的Locale
(代表国家/语言环境),并把其设置为session
的WW_TRANS_I18N_LOCALE
属性。
若request
没有名为request_locale
的参数,则i18n
拦截器会从Session
中获取WW_TRANS_I18N_LOCALE
的属性值,若该值不为空,则将该属性设置为浏览器的默认的Locale
。
若session
中的WW_TRANS_I18N_LOCALE
的属性值为空,则从ActionContext
中获取Locale
对象。
要进行语言切换的话只要在超链接中传递一个request_locale
参数即可,例如我们在上面的i18n.jsp中添加两行代码即可实现中英文切换:
<a href="testi18nAction.action?request_locale=en_US">English</a>|
<a href="testi18nAction.action?request_locale=zh_CN">中文</a>
值得注意的一定是超链接必须是一个Struts2的请求,因为Struts2请求会使i18n
拦截器不会工作。