很多软件为实现全球的应用。适应多个国家语言,需要提供国际化资源配置文件以及开发。软件的为支持国际化的开发常常称为:i18n。
这篇博客已登录动态切换语言为实例,介绍struts的国际化开发。实例中支持英文和中文
1.JSP页面
<%@ page language="java" import="java.util.*" pageEncoding="GB18030"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
<title>My JSP 'index.jsp' starting page</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="This is my page">
</head>
<body>
<a href="changeLang.do?lang=zh">中文</a> <a href="changeLang.do?lang=en">英文</a><br>
</body>
</html>
2.提供struts-config.xml配置文件
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.2//EN"
"http://struts.apache.org/dtds/struts-config_1_2.dtd">
<struts-config>
<form-beans>
<form-bean name="loginForm" type="com.bjpowernode.struts.LoginActionForm"></form-bean>
</form-beans>
<action-mappings>
<action path="/login"
type="com.bjpowernode.struts.LoginAction"
name="loginForm"
scope="request"
>
<forward name="success" path="/login_success.jsp"></forward>
<forward name="error" path="/login.jsp"></forward>
<!--
<forward name="error" path="/login_error.jsp"></forward>
-->
</action>
<action path="/changeLang"
type="com.bjpowernode.struts.ChangeLanguageAction"
>
<forward name="index" path="/index.jsp"/>
</action>
</action-mappings>
<message-resources parameter="resources.MessageResources"/>
</struts-config>
3.提供国际化资源文件
支持英文的资源文件:MessageResources_en_US.properties。还有缺省(英文)资源文件:MessageResources.properties 内容是相同的。
eerrors.header=<UL>
errors.prefix=<font color="red"><LI>
errors.suffix=</LI></font>
errors.footer=</UL>
login.form.field.username=User Name
login.form.field.password=Password
login.form.button.login=Login
login.success={0},Login Success
login.user.not.found=User Not Found,UserName=[{0}]
login.password.error=Password Error
支持中文的资源文件:MessageResources_zh_CN.properties
errors.header=<UL>
errors.prefix=<font color="red"><LI>
errors.suffix=</LI></font>
errors.footer=</UL>
login.form.field.username=\u59D3\u540D
login.form.field.password=\u5BC6\u7801
login.form.button.login=\u767B\u5F55
login.success={0},\u767B\u5F55\u6210\u529F\!
login.user.not.found=\u7528\u6237\u4E0D\u80FD\u627E\u5230,\u7528\u6237\u540D\u79F0\=\u3010{0}\u3011
login.password.error=\u5BC6\u7801\u9519\u8BEF
4.页面中读取国际化文本消息
<%@ page language="java" contentType="text/html; charset=GB18030"
pageEncoding="GB18030"%>
<%@ taglib uri="http://struts.apache.org/tags-html" prefix="html"%>
<%@ taglib uri="http://struts.apache.org/tags-bean" prefix="bean"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=GB18030">
<title>Insert title here</title>
</head>
<body>
<form action="login.do" method="post">
<bean:message key="login.form.field.username"/>:<input type="text" name="username"><br>
<bean:message key="login.form.field.password"/>:<input type="password" name="password"><br>
<input type="submit" value="<bean:message key="login.form.button.login"/>">
</form>
</body>
</html>
5.切换语言的Action
package com.bjpowernode.struts;
import java.util.Locale;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.Globals;
import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
/**
* 完成语言自动切换
* @author xj
*
*/
public class ChangeLanguageAction extends Action {
@Override
public ActionForward execute(ActionMapping mapping, ActionForm form,HttpServletRequest request, HttpServletResponse response)throws Exception {
//读取JSP页面,用户请求的语言环境
String lang = request.getParameter("lang");
//读取操作系统当前默认的语言环境
Locale locale = Locale.getDefault();
if("zh".equals(lang)){
locale = new Locale("zh","CN");
}else if("en".equals(lang)){
locale = new Locale("en","US");
}
//将Locale设置到session中
/*request.getSession().setAttribute(Globals.LOCALE_KEY, locale);*/
//将语言设置到request中
this.setLocale(request, locale);
return mapping.findForward("index");
}
}
总结下支持国家化开发的步骤;
1.struts的国际化配置
2.提供国际化资源文件
3.在jsp中采用读取国际化
4.利用struts默认将Locale放到Session中的特性,可以完成语言的自动切换
以登录后的提示消息(成功或异常),介绍动态文本的国际化
1.国际化资源文件:将错误消息,配置进去。需要根据登录用户动态改变的东西,采用占位符。
上面的实例中的国家化资源文件配置中,提供了“登录成功”“用户不能找到”和“密码错误”三种消息类型。
2.捕获异常消息
package com.bjpowernode.struts;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionMessage;
import org.apache.struts.action.ActionMessages;
/**
* 登录Action
* 负责取得表单数据,调用业务逻辑,返回转向信息
* @author xj
*
*/
public class LoginAction extends Action {
@Override
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response)
throws Exception {
//拿到提交表单中的用户信息
LoginActionForm laf = (LoginActionForm)form;
String username = laf.getUsername();
String password = laf.getPassword();
UserManager userManager = new UserManager();
ActionMessages messages = new ActionMessages();
try{
userManager.login(username, password);
//创建国际化消息文本
ActionMessage message = new ActionMessage("login.success",username);
messages.add("login_success_1",message);
//传递国际化消息
this.saveMessages(request, messages);
return mapping.findForward("success");
}catch(UserNotFoundException e){
e.printStackTrace();
//创建国际化消息文本
ActionMessage error = new ActionMessage("login.user.not.found",username);
messages.add("error_1",error);
//传递国际化消息
this.saveErrors(request, messages);
}catch(PasswordErrorException e){
//创建国际化消息文本
ActionMessage error = new ActionMessage("login.password.error");
messages.add("error_2",error);
//传递国际化消息
this.saveErrors(request, messages);
}
return mapping.findForward("error");
}
}
3.读取消息
登录成功:
<body>
<html:messages id="msg" message="true">
<bean:write name="msg" />
</html:messages>
</body>
登录失败:
<body>
<font color="red">
<html:messages id="msg" property="error_1">
<bean:write name="msg" />
</html:messages>
</font>
<font color="blue" >
<html:messages id="msg" property="error_2">
<bean:write name="msg" />
</html:messages>
</font>
</body>
总结动态文本国家化的过程:
1.动态休息国际化主要分三个步骤;
- 创建国际化消息文本
- 传递国际化消息文本
- 显示国际化消息文本
2.如果创建国际化消息文本?
ActionMessage和ActionMessages
3.如何传递国际化消息文本
调用saveMessage()传递提示消息,调用saveError()传递错误消息
4.如何显示国际化消息文本
通过 显示提示消息和错误消息
通过显示错误消息(只能显示错误消息)