扫码一下
查看教程更方便
Struts 2 本地化、国际化 (i18n)
国际化 (i18n) 是规划和实施产品和服务的过程，以便它们可以轻松地适应特定的当地语言和文化，这一过程称为本地化。 国际化过程称为翻译或本地化支持。
国际化缩写为 i18n，因为单词以字母“i”开头并以“n”结尾，并且第一个 i 和最后一个 n 之间有 18 个字符。
Struts2 通过以下位置的资源包、拦截器和标签库提供本地化，即国际化 (i18n) 支持
- 用户界面(UI)标签
- 消息和错误。
- 在 Action 类中。
资源包
Struts2 使用资源包为 Web 应用程序的用户提供多种语言和区域设置选项。 我们无需担心用不同的语言编写页面。 我们所要做的就是为自己想要的每种语言创建一个资源包。 资源包将包含使用用户语言的标题、消息和其他文本。 资源包是包含应用程序默认语言的键/值对的文件。
资源文件最简单的命名格式是
bundlename_language_country.properties
这里，bundlename 可以是 ActionClass、Interface、SuperClass、Model、Package、全局资源属性。 下一部分 language_country 代表国家语言环境，例如，西班牙语（西班牙）语言环境由 es_ES 表示，英语（美国）语言环境由 en_US 表示等。我们可以跳过可选的国家/地区部分。
当我们通过键引用消息元素时，Struts 框架按以下顺序搜索相应的消息包
- ActionClass.properties
- Interface.properties
- SuperClass.properties
- model.properties
- package.properties
- struts.properties
- global.properties
要以多种语言开发应用程序，我们应该维护与这些语言/区域设置相对应的多个属性文件，并根据键/值对定义所有内容。
例如，如果要为美国英语（默认）、西班牙语和法语开发应用程序，则必须创建三个属性文件。 这里我只使用 global.properties 文件，你也可以使用不同的属性文件来隔离不同类型的消息。
- global.properties - 默认情况下将应用英语（美国）
- global_fr.properties - 这将用于法语语言环境。
- global_es.properties - 这将用于西班牙语言环境。
访问消息
消息资源的访问方式有多种，包括getText、text标签、UI标签的key属性、i18n标签。 让我们简要介绍一下 -
要显示 i18n 文本，请在属性标记或任何其他标记（例如 UI 标记）中调用 getText，如下所示
<s:property value = "getText('some.key')" />
文本标签从默认资源包中检索消息，即 struts.properties
<s:text name = "some.key" />
i18n 标记将任意资源包推送到值堆栈。 i18n 标签范围内的其他标签可以显示来自该资源包的消息
<s:i18n name = "some.package.bundle">
<s:text name = "some.key" />
</s:i18n>
大多数 UI 标签的 key 属性可用于从资源包生成消息
<s:textfield key = "some.key" name = "textfieldName"/>
本地化示例
让我们的目标是从上一章以多种语言创建 index.jsp。
<%--
Created by IntelliJ IDEA.
User: liuhanzeng
Date: 2022/5/9
Time: 9:36 PM
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<html>
<head>
<title>具有多语言支持的 Employee 表格</title>
</head>
<body>
<h1><s:text name = "global.heading"/></h1>
<s:url var = "indexEN" namespace="/" action = "locale" >
<s:param name = "request_locale" >en</s:param>
</s:url>
<s:url var = "indexES" namespace="/" action = "locale" >
<s:param name = "request_locale" >es</s:param>
</s:url>
<s:url var = "indexFR" namespace="/" action = "locale" >
<s:param name = "request_locale" >fr</s:param>
</s:url>
<s:a href="%{indexEN}" >English</s:a>
<s:a href="%{indexES}" >Spanish</s:a>
<s:a href="%{indexFR}" >France</s:a>
<s:form action = "empinfo" method = "post" namespace = "/">
<s:textfield name = "name" key = "global.name" size = "20" />
<s:textfield name = "age" key = "global.age" size = "20" />
<s:submit name = "submit" key = "global.submit" />
</s:form>
</body>
</html>
我们将创建 success.jsp 文件，如果定义的操作返回 SUCCESS，将调用该文件。
%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Success</title>
</head>
<body>
<s:property value = "getText('global.success')" />
</body>
</html>
在这里，我们需要创建以下两个动作。 (a) 第一个动作 a 处理 Locale 并以不同的语言显示相同的 index.jsp 文件 ；(b) 另一个动作是处理提交表单本身。 这两个动作都将返回 SUCCESS，但我们将根据返回值采取不同的动作，因为我们的目的对于这两个动作是不同的
处理语言环境的Action
package com.jiyik.struts2.action;
import com.opensymphony.xwork2.ActionSupport;
public class Locale extends ActionSupport {
@Override
public String execute() {
return SUCCESS;
}
}
提交表单的Action
package com.jiyik.struts2.action;
import com.opensymphony.xwork2.ActionSupport;
public class Employee extends ActionSupport {
private String name;
private int age;
@Override
public String execute() {
return SUCCESS;
}
public String getName() {
return name;
}
public int getAge() {
return age;
}
public void setName(String name) {
this.name = name;
}
public void setAge(int age) {
this.age = age;
}
}
现在让我们创建以下三个 global.properties 文件并将其放入 CLASSPATH
global.properties
global.name = Name
global.age = Age
global.submit = Submit
global.heading = Select Locale
global.success = Successfully authenticated
global_fr.properties
global.name = Nom d'utilisateur
global.age = l'âge
global.submit = Soumettre des
global.heading = Sé lectionnez Local
global.success = Authentifi é avec succès
global_es.properties
global.name = Nombre de usuario
global.age = Edad
global.submit = Presentar
global.heading = seleccionar la configuracion regional
global.success = Autenticado correctamente
我们将使用以下两个Action创建我们的 struts.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<constant name = "struts.devMode" value = "true" />
<package name = "helloworld" extends = "struts-default">
<action name="empinfo" class="com.jiyik.struts2.action.Employee" method="execute">
<result name = "input">/index.jsp</result>
<result name = "success">/success.jsp</result>
</action>
<action name = "locale"
class = "com.jiyik.struts2.action.Locale"
method = "execute">
<result name = "success">/index.jsp</result>
</action>
</package>
</struts>
以下是 web.xml 文件的内容
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
启动服务
接下来是使用 IDEA 启动我们的项目，项目启动成功之后，我们在浏览器中访问如下界面
现在选择任何一种语言，假设我们选择法语，它将显示以下结果
我们也可以选择尝试西班牙语界面。最后，让我们尝试在法语语言环境下点击提交按钮，它会显示以下界面
恭喜，现在我们有了一个多语言网页，可以在全球范围内访问我们的网站。
