JSP国际化完全指南轻松实现多语言网站开发

威震华夏关云长

引言

在当今全球化的互联网环境中，开发支持多语言的网站已成为一项基本需求。JSP国际化（Internationalization，简称i18n）技术允许开发者构建能够根据用户语言偏好自动调整显示内容的应用程序，从而为不同语言背景的用户提供更好的体验。本文将全面介绍JSP国际化的概念、实现方法和最佳实践，帮助您轻松构建多语言网站。

国际化的基本原理

国际化是指设计和编写应用程序，使其能够适应不同的语言和地区而无需进行工程上的更改。与之相关的本地化（Localization，简称L10n）则是将国际化的应用程序适配到特定语言和地区的过程。

JSP国际化的核心思想是将所有与语言相关的文本从代码中分离出来，存储在外部资源文件中。当用户请求页面时，系统根据用户的语言环境加载相应的资源文件，从而显示对应语言的内容。

这种方法的优点是：

• 无需修改代码即可添加对新语言的支持
• 维护简单，只需翻译资源文件即可更新语言内容
• 代码更加清晰，不包含硬编码的文本

JSP国际化的核心技术

ResourceBundle

ResourceBundle是Java中用于加载特定语言环境资源的类。它允许我们将应用程序中的文本字符串提取到属性文件中，然后根据用户的Locale加载相应的属性文件。

ResourceBundle的基本用法如下：

2. // 加载默认的资源包
3. ResourceBundle messages = ResourceBundle.getBundle("messages");
5. // 加载特定语言环境的资源包
6. ResourceBundle messages = ResourceBundle.getBundle("messages", new Locale("zh", "CN"));
8. // 从资源包中获取消息
9. String greeting = messages.getString("greeting");

复制代码

Locale类

Locale类表示特定的地理、政治或文化区域。它通常用于根据用户的语言、国家/地区和其他文化偏好定制应用程序的行为。

2. // 创建表示中文（中国）的Locale对象
3. Locale localeZhCN = new Locale("zh", "CN");
5. // 创建表示英语（美国）的Locale对象
6. Locale localeEnUS = new Locale("en", "US");
8. // 获取系统默认的Locale
9. Locale defaultLocale = Locale.getDefault();

复制代码

MessageFormat

MessageFormat类提供了一种灵活的方式来格式化包含变量的消息。它允许我们在资源文件中定义带有占位符的消息，然后在运行时替换这些占位符。

2. // 在资源文件中定义消息
3. // welcome.message=欢迎 {0}，今天是 {1}
5. // 在Java代码中使用MessageFormat
6. String pattern = messages.getString("welcome.message");
7. Object[] params = {"张三", new Date()};
8. String message = MessageFormat.format(pattern, params);
9. System.out.println(message);
10. // 输出：欢迎 张三，今天是 2023-11-15

复制代码

JSTL fmt标签库

JSP标准标签库(JSTL)中的fmt标签提供了一套用于国际化的标签，简化了在JSP页面中实现国际化的过程。要使用这些标签，首先需要在JSP页面中引入fmt标签库：

2. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>

复制代码

实现步骤详解

创建资源文件

资源文件是国际化的基础，它们存储了不同语言版本的文本内容。通常，我们会为每种语言创建一个属性文件，文件名格式为basename_language_country.properties。

例如，创建以下资源文件：

messages_en_US.properties(英语 - 美国)

2. greeting=Hello
3. welcome=Welcome to our website
4. login.username=Username
5. login.password=Password
6. login.button=Login

复制代码

messages_zh_CN.properties(中文 - 中国)

2. greeting=你好
3. welcome=欢迎访问我们的网站
4. login.username=用户名
5. login.password=密码
6. login.button=登录

复制代码

messages_ja_JP.properties(日语 - 日本)

2. greeting=こんにちは
3. welcome=私たちのウェブサイトへようこそ
4. login.username=ユーザー名
5. login.password=パスワード
6. login.button=ログイン

复制代码

这些文件应该放在WEB-INF/classes目录下，这样类加载器才能找到它们。如果使用Maven或Gradle构建项目，可以将它们放在src/main/resources目录下。

配置web.xml

在web.xml中，我们可以配置一些与国际化相关的参数，如默认语言环境、支持的字符集等。

2. <?xml version="1.0" encoding="UTF-8"?>
3. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
4.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5.          xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
6.                              http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
7.          version="4.0">
8.    
9.     <!-- 配置字符编码过滤器 -->
10.     <filter>
11.         <filter-name>CharacterEncodingFilter</filter-name>
12.         <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
13.         <init-param>
14.             <param-name>encoding</param-name>
15.             <param-value>UTF-8</param-value>
16.         </init-param>
17.         <init-param>
18.             <param-name>forceEncoding</param-name>
19.             <param-value>true</param-value>
20.         </init-param>
21.     </filter>
22.    
23.     <filter-mapping>
24.         <filter-name>CharacterEncodingFilter</filter-name>
25.         <url-pattern>/*</url-pattern>
26.     </filter-mapping>
27.    
28.     <!-- 配置默认语言环境 -->
29.     <context-param>
30.         <param-name>javax.servlet.jsp.jstl.fmt.locale</param-name>
31.         <param-value>en_US</param-value>
32.     </context-param>
33.    
34.     <!-- 配置资源包的基础名称 -->
35.     <context-param>
36.         <param-name>javax.servlet.jsp.jstl.fmt.localizationContext</param-name>
37.         <param-value>messages</param-value>
38.     </context-param>
39. </web-app>

复制代码

在JSP页面中使用国际化

使用JSTL的fmt标签，我们可以在JSP页面中轻松实现国际化。以下是一个简单的登录页面示例：

2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
6. <!DOCTYPE html>
7. <html>
8. <head>
9.     <meta charset="UTF-8">
10.     <title><fmt:message key="greeting"/></title>
11. </head>
12. <body>
13.     <h1><fmt:message key="welcome"/></h1>
14.    
15.     <form action="login" method="post">
16.         <div>
17.             <label for="username"><fmt:message key="login.username"/>:</label>
18.             <input type="text" id="username" name="username" required>
19.         </div>
20.         <div>
21.             <label for="password"><fmt:message key="login.password"/>:</label>
22.             <input type="password" id="password" name="password" required>
23.         </div>
24.         <div>
25.             <button type="submit"><fmt:message key="login.button"/></button>
26.         </div>
27.     </form>
28.    
29.     <!-- 语言选择器 -->
30.     <div>
31.         <a href="?lang=en_US">English</a> |
32.         <a href="?lang=zh_CN">中文</a> |
33.         <a href="?lang=ja_JP">日本語</a>
34.     </div>
35. </body>
36. </html>

复制代码

动态语言切换实现

实现动态语言切换通常需要以下步骤：

1. 创建语言选择器（如下拉菜单或链接）
2. 将用户选择的语言存储在会话或cookie中
3. 在每个页面加载时检查用户选择的语言并设置相应的Locale

下面是一个完整的实现示例：

LocaleFilter.java

2. import javax.servlet.*;
3. import javax.servlet.annotation.WebFilter;
4. import javax.servlet.http.HttpServletRequest;
5. import javax.servlet.http.HttpSession;
6. import java.io.IOException;
7. import java.util.Locale;
9. @WebFilter("/*")
10. public class LocaleFilter implements Filter {
12.     private static final String DEFAULT_LOCALE = "en_US";
13.     private static final String LOCALE_SESSION_ATTRIBUTE = "userLocale";
15.     @Override
16.     public void init(FilterConfig filterConfig) throws ServletException {
17.     }
19.     @Override
20.     public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
21.             throws IOException, ServletException {
22.         HttpServletRequest httpRequest = (HttpServletRequest) request;
23.         HttpSession session = httpRequest.getSession();
24.         
25.         // 检查请求参数中是否包含语言设置
26.         String langParam = httpRequest.getParameter("lang");
27.         if (langParam != null && !langParam.isEmpty()) {
28.             // 用户选择了新语言，更新会话中的语言设置
29.             session.setAttribute(LOCALE_SESSION_ATTRIBUTE, langParam);
30.         }
31.         
32.         // 获取当前语言环境
33.         String userLocale = (String) session.getAttribute(LOCALE_SESSION_ATTRIBUTE);
34.         if (userLocale == null) {
35.             userLocale = DEFAULT_LOCALE;
36.         }
37.         
38.         // 设置请求的语言环境
39.         String[] localeParts = userLocale.split("_");
40.         if (localeParts.length == 2) {
41.             request.setAttribute("userLocale", new Locale(localeParts[0], localeParts[1]));
42.         }
43.         
44.         chain.doFilter(request, response);
45.     }
47.     @Override
48.     public void destroy() {
49.     }
50. }

复制代码

header.jspf(可被所有页面包含的片段)

2. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <c:if test="${not empty userLocale}">
5.     <fmt:setLocale value="${userLocale}" scope="session" />
6. </c:if>
7. <fmt:setBundle basename="messages" scope="session" />

复制代码

index.jsp

2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
6. <!DOCTYPE html>
7. <html>
8. <head>
9.     <meta charset="UTF-8">
10.     <title><fmt:message key="greeting"/></title>
11. </head>
12. <body>
13.     <%@ include file="header.jspf" %>
14.    
15.     <h1><fmt:message key="welcome"/></h1>
16.    
17.     <p><fmt:message key="intro.text"/></p>
18.    
19.     <!-- 语言选择器 -->
20.     <div>
21.         <a href="?lang=en_US">English</a> |
22.         <a href="?lang=zh_CN">中文</a> |
23.         <a href="?lang=ja_JP">日本語</a>
24.     </div>
25. </body>
26. </html>

复制代码

高级主题

日期和时间的国际化

不同国家和地区对日期和时间的格式有不同的偏好。使用JSTL的fmt标签，我们可以根据用户的语言环境正确格式化日期和时间。

2. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
5. <%@ include file="header.jspf" %>
7. <!DOCTYPE html>
8. <html>
9. <head>
10.     <meta charset="UTF-8">
11.     <title><fmt:message key="date.format.example"/></title>
12. </head>
13. <body>
14.     <h1><fmt:message key="date.format.example"/></h1>
15.    
16.     <!-- 设置当前日期 -->
17.     <jsp:useBean id="now" class="java.util.Date" />
18.    
19.     <!-- 日期格式示例 -->
20.     <p><fmt:message key="full.date"/>:
21.         <fmt:formatDate value="${now}" dateStyle="full" /></p>
22.    
23.     <p><fmt:message key="long.date"/>:
24.         <fmt:formatDate value="${now}" dateStyle="long" /></p>
25.    
26.     <p><fmt:message key="medium.date"/>:
27.         <fmt:formatDate value="${now}" dateStyle="medium" /></p>
28.    
29.     <p><fmt:message key="short.date"/>:
30.         <fmt:formatDate value="${now}" dateStyle="short" /></p>
31.    
32.     <!-- 时间格式示例 -->
33.     <p><fmt:message key="full.time"/>:
34.         <fmt:formatDate value="${now}" type="time" timeStyle="full" /></p>
35.    
36.     <p><fmt:message key="long.time"/>:
37.         <fmt:formatDate value="${now}" type="time" timeStyle="long" /></p>
38.    
39.     <!-- 自定义日期时间格式 -->
40.     <p><fmt:message key="custom.datetime"/>:
41.         <fmt:formatDate value="${now}" pattern="yyyy-MM-dd HH:mm:ss" /></p>
42. </body>
43. </html>

复制代码

数字和货币的国际化

数字和货币的格式也因地区而异。例如，美国使用小数点作为小数分隔符，逗号作为千位分隔符，而许多欧洲国家则相反。同样，货币符号的位置和格式也各不相同。

2. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
5. <%@ include file="header.jspf" %>
7. <!DOCTYPE html>
8. <html>
9. <head>
10.     <meta charset="UTF-8">
11.     <title><fmt:message key="number.format.example"/></title>
12. </head>
13. <body>
14.     <h1><fmt:message key="number.format.example"/></h1>
15.    
16.     <!-- 设置一个数字 -->
17.     <c:set var="number" value="1234567.89" />
18.    
19.     <!-- 数字格式示例 -->
20.     <p><fmt:message key="default.number"/>:
21.         <fmt:formatNumber value="${number}" /></p>
22.    
23.     <p><fmt:message key="number.without.grouping"/>:
24.         <fmt:formatNumber value="${number}" groupingUsed="false" /></p>
25.    
26.     <p><fmt:message key="number.with.decimals"/>:
27.         <fmt:formatNumber value="${number}" maxFractionDigits="4" /></p>
28.    
29.     <!-- 百分比格式 -->
30.     <p><fmt:message key="percentage"/>:
31.         <fmt:formatNumber value="0.85" type="percent" /></p>
32.    
33.     <!-- 货币格式 -->
34.     <p><fmt:message key="currency"/>:
35.         <fmt:formatNumber value="${number}" type="currency" /></p>
36.    
37.     <!-- 设置不同的货币 -->
38.     <p><fmt:message key="usd.currency"/>:
39.         <fmt:setLocale value="en_US" />
40.         <fmt:formatNumber value="${number}" type="currency" /></p>
41.    
42.     <p><fmt:message key="eur.currency"/>:
43.         <fmt:setLocale value="de_DE" />
44.         <fmt:formatNumber value="${number}" type="currency" /></p>
45.    
46.     <p><fmt:message key="jpy.currency"/>:
47.         <fmt:setLocale value="ja_JP" />
48.         <fmt:formatNumber value="${number}" type="currency" /></p>
49.    
50.     <!-- 恢复用户Locale -->
51.     <c:if test="${not empty userLocale}">
52.         <fmt:setLocale value="${userLocale}" />
53.     </c:if>
54. </body>
55. </html>

复制代码

处理不同语言的文本方向

某些语言（如阿拉伯语和希伯来语）是从右到左（RTL）书写的。在国际化网站中，我们需要考虑这些语言的文本方向问题。可以通过CSS和HTML的dir属性来控制文本方向。

2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
6. <%@ include file="header.jspf" %>
8. <!DOCTYPE html>
9. <html>
10. <head>
11.     <meta charset="UTF-8">
12.     <title><fmt:message key="rtl.example"/></title>
13.     <style>
14.         .ltr {
15.             direction: ltr;
16.             text-align: left;
17.         }
18.         .rtl {
19.             direction: rtl;
20.             text-align: right;
21.         }
22.         .container {
23.             max-width: 800px;
24.             margin: 0 auto;
25.             padding: 20px;
26.         }
27.     </style>
28. </head>
29. <body>
30.     <%-- 根据语言设置文本方向 --%>
31.     <c:choose>
32.         <c:when test="${pageContext.response.locale.language == 'ar' || pageContext.response.locale.language == 'he'}">
33.             <c:set var="textDirection" value="rtl" />
34.         </c:when>
35.         <c:otherwise>
36.             <c:set var="textDirection" value="ltr" />
37.         </c:otherwise>
38.     </c:choose>
39.    
40.     <div class="container ${textDirection}">
41.         <h1><fmt:message key="rtl.example"/></h1>
42.         
43.         <p><fmt:message key="rtl.description"/></p>
44.         
45.         <div>
46.             <h2><fmt:message key="sample.text"/></h2>
47.             <p><fmt:message key="sample.paragraph"/></p>
48.         </div>
49.         
50.         <div>
51.             <h2><fmt:message key="language.switcher"/></h2>
52.             <p>
53.                 <a href="?lang=en_US">English</a> |
54.                 <a href="?lang=zh_CN">中文</a> |
55.                 <a href="?lang=ar_SA">العربية</a> |
56.                 <a href="?lang=he_IL">עברית</a>
57.             </p>
58.         </div>
59.     </div>
60. </body>
61. </html>

复制代码

最佳实践和常见问题

最佳实践

1. 始终使用UTF-8编码在所有JSP页面中设置pageEncoding="UTF-8"在HTML中使用<meta charset="UTF-8">在web.xml中配置字符编码过滤器
2. 在所有JSP页面中设置pageEncoding="UTF-8"
3. 在HTML中使用<meta charset="UTF-8">
4. 在web.xml中配置字符编码过滤器
5. 避免在JSP页面中硬编码文本所有用户可见的文本都应该放在资源文件中包括按钮标签、错误消息、提示文本等
6. 所有用户可见的文本都应该放在资源文件中
7. 包括按钮标签、错误消息、提示文本等
8. 使用一致的资源文件命名约定使用有意义的基名，如messages、labels等遵循basename_language_country.properties的命名规则
9. 使用有意义的基名，如messages、labels等
10. 遵循basename_language_country.properties的命名规则
11. 提供完整的翻译确保所有语言版本都包含相同的键对于缺失的翻译，提供默认值或回退机制
12. 确保所有语言版本都包含相同的键
13. 对于缺失的翻译，提供默认值或回退机制
14. 考虑图像和颜色的文化差异避免使用具有特定文化含义的图像注意颜色在不同文化中的象征意义
15. 避免使用具有特定文化含义的图像
16. 注意颜色在不同文化中的象征意义
17. 处理复数形式和性别差异某些语言有复杂的复数形式规则考虑使用ChoiceFormat处理复数形式
18. 某些语言有复杂的复数形式规则
19. 考虑使用ChoiceFormat处理复数形式

始终使用UTF-8编码

• 在所有JSP页面中设置pageEncoding="UTF-8"
• 在HTML中使用<meta charset="UTF-8">
• 在web.xml中配置字符编码过滤器

避免在JSP页面中硬编码文本

• 所有用户可见的文本都应该放在资源文件中
• 包括按钮标签、错误消息、提示文本等

使用一致的资源文件命名约定

• 使用有意义的基名，如messages、labels等
• 遵循basename_language_country.properties的命名规则

提供完整的翻译

• 确保所有语言版本都包含相同的键
• 对于缺失的翻译，提供默认值或回退机制

考虑图像和颜色的文化差异

• 避免使用具有特定文化含义的图像
• 注意颜色在不同文化中的象征意义

处理复数形式和性别差异

• 某些语言有复杂的复数形式规则
• 考虑使用ChoiceFormat处理复数形式

常见问题及解决方案

1. 资源文件加载失败确保资源文件位于正确的位置（WEB-INF/classes或src/main/resources）检查文件名是否正确（区分大小写）验证资源文件的内容格式是否正确
2. 确保资源文件位于正确的位置（WEB-INF/classes或src/main/resources）
3. 检查文件名是否正确（区分大小写）
4. 验证资源文件的内容格式是否正确
5. 中文或其他非ASCII字符显示为乱码确保所有文件使用UTF-8编码保存检查web.xml中是否配置了字符编码过滤器验证数据库连接和表是否使用UTF-8编码
6. 确保所有文件使用UTF-8编码保存
7. 检查web.xml中是否配置了字符编码过滤器
8. 验证数据库连接和表是否使用UTF-8编码
9. 日期/时间/数字格式不正确确保正确设置了Locale检查是否使用了适当的格式样式（full, long, medium, short）考虑使用自定义格式模式
10. 确保正确设置了Locale
11. 检查是否使用了适当的格式样式（full, long, medium, short）
12. 考虑使用自定义格式模式
13. 动态语言切换不生效确保语言参数正确传递和处理检查Locale过滤器是否正确配置和映射验证会话中的Locale设置是否正确保存和检索
14. 确保语言参数正确传递和处理
15. 检查Locale过滤器是否正确配置和映射
16. 验证会话中的Locale设置是否正确保存和检索

资源文件加载失败

• 确保资源文件位于正确的位置（WEB-INF/classes或src/main/resources）
• 检查文件名是否正确（区分大小写）
• 验证资源文件的内容格式是否正确

中文或其他非ASCII字符显示为乱码

• 确保所有文件使用UTF-8编码保存
• 检查web.xml中是否配置了字符编码过滤器
• 验证数据库连接和表是否使用UTF-8编码

日期/时间/数字格式不正确

• 确保正确设置了Locale
• 检查是否使用了适当的格式样式（full, long, medium, short）
• 考虑使用自定义格式模式

动态语言切换不生效

• 确保语言参数正确传递和处理
• 检查Locale过滤器是否正确配置和映射
• 验证会话中的Locale设置是否正确保存和检索

实际案例分析

让我们通过一个完整的示例，展示如何实现一个支持多语言的JSP网站。这个案例将包括用户登录、内容展示和语言切换等功能。

项目结构

2. src/
3. └── main/
4.     ├── java/
5.     │   └── com/
6.     │       └── example/
7.     │           ├── filter/
8.     │           │   └── LocaleFilter.java
9.     │           ├── servlet/
10.     │           │   ├── LoginServlet.java
11.     │           │   └── LogoutServlet.java
12.     │           └── util/
13.     │               └── I18nUtil.java
14.     ├── resources/
15.     │   ├── messages_en_US.properties
16.     │   ├── messages_zh_CN.properties
17.     │   └── messages_ja_JP.properties
18.     └── webapp/
19.         ├── WEB-INF/
20.         │   └── web.xml
21.         ├── css/
22.         │   └── style.css
23.         ├── fragments/
24.         │   ├── header.jspf
25.         │   └── footer.jspf
26.         ├── index.jsp
27.         ├── login.jsp
28.         ├── welcome.jsp
29.         └── error.jsp

复制代码

资源文件

messages_en_US.properties

2. greeting=Hello
3. welcome=Welcome to our website
4. home=Home
5. login=Login
6. logout=Logout
7. username=Username
8. password=Password
9. submit=Submit
10. language=Language
11. intro.text=This is a multilingual website example. You can switch between different languages using the language selector.
12. login.success=Login successful!
13. login.error=Invalid username or password
14. welcome.user=Welcome, {0}!
15. current.date=Current date and time

复制代码

messages_zh_CN.properties

2. greeting=你好
3. welcome=欢迎访问我们的网站
4. home=首页
5. login=登录
6. logout=退出
7. username=用户名
8. password=密码
9. submit=提交
10. language=语言
11. intro.text=这是一个多语言网站示例。您可以使用语言选择器在不同语言之间切换。
12. login.success=登录成功！
13. login.error=用户名或密码无效
14. welcome.user=欢迎，{0}！
15. current.date=当前日期和时间

复制代码

messages_ja_JP.properties

2. greeting=こんにちは
3. welcome=私たちのウェブサイトへようこそ
4. home=ホーム
5. login=ログイン
6. logout=ログアウト
7. username=ユーザー名
8. password=パスワード
9. submit=送信
10. language=言語
11. intro.text=これは多言語ウェブサイトの例です。言語セレクタを使用して、異なる言語を切り替えることができます。
12. login.success=ログインに成功しました！
13. login.error=無効なユーザー名またはパスワード
14. welcome.user=ようこそ、{0}さん！
15. current.date=現在の日付と時刻

复制代码

过滤器和工具类

LocaleFilter.java

2. package com.example.filter;
4. import javax.servlet.*;
5. import javax.servlet.annotation.WebFilter;
6. import javax.servlet.http.HttpServletRequest;
7. import javax.servlet.http.HttpSession;
8. import java.io.IOException;
9. import java.util.Locale;
11. @WebFilter("/*")
12. public class LocaleFilter implements Filter {
14.     private static final String DEFAULT_LOCALE = "en_US";
15.     private static final String LOCALE_SESSION_ATTRIBUTE = "userLocale";
17.     @Override
18.     public void init(FilterConfig filterConfig) throws ServletException {
19.     }
21.     @Override
22.     public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
23.             throws IOException, ServletException {
24.         HttpServletRequest httpRequest = (HttpServletRequest) request;
25.         HttpSession session = httpRequest.getSession();
26.         
27.         // 检查请求参数中是否包含语言设置
28.         String langParam = httpRequest.getParameter("lang");
29.         if (langParam != null && !langParam.isEmpty()) {
30.             // 用户选择了新语言，更新会话中的语言设置
31.             session.setAttribute(LOCALE_SESSION_ATTRIBUTE, langParam);
32.         }
33.         
34.         // 获取当前语言环境
35.         String userLocale = (String) session.getAttribute(LOCALE_SESSION_ATTRIBUTE);
36.         if (userLocale == null) {
37.             userLocale = DEFAULT_LOCALE;
38.         }
39.         
40.         // 设置请求的语言环境
41.         String[] localeParts = userLocale.split("_");
42.         if (localeParts.length == 2) {
43.             request.setAttribute("userLocale", new Locale(localeParts[0], localeParts[1]));
44.         }
45.         
46.         chain.doFilter(request, response);
47.     }
49.     @Override
50.     public void destroy() {
51.     }
52. }

复制代码

I18nUtil.java

2. package com.example.util;
4. import java.util.Locale;
5. import java.util.ResourceBundle;
7. public class I18nUtil {
8.    
9.     private static final String BASE_NAME = "messages";
10.    
11.     public static String getMessage(String key, Locale locale) {
12.         try {
13.             ResourceBundle bundle = ResourceBundle.getBundle(BASE_NAME, locale);
14.             return bundle.getString(key);
15.         } catch (Exception e) {
16.             return "???" + key + "???";
17.         }
18.     }
19.    
20.     public static String getMessage(String key, Locale locale, Object... params) {
21.         try {
22.             ResourceBundle bundle = ResourceBundle.getBundle(BASE_NAME, locale);
23.             String pattern = bundle.getString(key);
24.             return java.text.MessageFormat.format(pattern, params);
25.         } catch (Exception e) {
26.             return "???" + key + "???";
27.         }
28.     }
29. }

复制代码

Servlet类

LoginServlet.java

2. package com.example.servlet;
4. import com.example.util.I18nUtil;
5. import javax.servlet.ServletException;
6. import javax.servlet.annotation.WebServlet;
7. import javax.servlet.http.HttpServlet;
8. import javax.servlet.http.HttpServletRequest;
9. import javax.servlet.http.HttpServletResponse;
10. import javax.servlet.http.HttpSession;
11. import java.io.IOException;
12. import java.util.Locale;
14. @WebServlet("/login")
15. public class LoginServlet extends HttpServlet {
16.    
17.     @Override
18.     protected void doPost(HttpServletRequest request, HttpServletResponse response)
19.             throws ServletException, IOException {
20.         
21.         String username = request.getParameter("username");
22.         String password = request.getParameter("password");
23.         
24.         // 简单的验证逻辑（实际应用中应该使用数据库验证）
25.         if ("admin".equals(username) && "password".equals(password)) {
26.             // 登录成功
27.             HttpSession session = request.getSession();
28.             session.setAttribute("user", username);
29.             
30.             // 获取当前Locale
31.             Locale locale = (Locale) request.getAttribute("userLocale");
32.             if (locale == null) {
33.                 locale = request.getLocale();
34.             }
35.             
36.             // 设置成功消息
37.             String successMessage = I18nUtil.getMessage("login.success", locale);
38.             request.setAttribute("message", successMessage);
39.             
40.             // 重定向到欢迎页面
41.             response.sendRedirect("welcome.jsp");
42.         } else {
43.             // 登录失败
44.             Locale locale = (Locale) request.getAttribute("userLocale");
45.             if (locale == null) {
46.                 locale = request.getLocale();
47.             }
48.             
49.             String errorMessage = I18nUtil.getMessage("login.error", locale);
50.             request.setAttribute("error", errorMessage);
51.             
52.             // 返回登录页面
53.             request.getRequestDispatcher("login.jsp").forward(request, response);
54.         }
55.     }
56. }

复制代码

LogoutServlet.java

2. package com.example.servlet;
4. import javax.servlet.ServletException;
5. import javax.servlet.annotation.WebServlet;
6. import javax.servlet.http.HttpServlet;
7. import javax.servlet.http.HttpServletRequest;
8. import javax.servlet.http.HttpServletResponse;
9. import javax.servlet.http.HttpSession;
10. import java.io.IOException;
12. @WebServlet("/logout")
13. public class LogoutServlet extends HttpServlet {
14.    
15.     @Override
16.     protected void doGet(HttpServletRequest request, HttpServletResponse response)
17.             throws ServletException, IOException {
18.         
19.         HttpSession session = request.getSession();
20.         session.invalidate();
21.         
22.         response.sendRedirect("index.jsp");
23.     }
24. }

复制代码

JSP页面

fragments/header.jspf

2. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <c:if test="${not empty userLocale}">
5.     <fmt:setLocale value="${userLocale}" scope="session" />
6. </c:if>
7. <fmt:setBundle basename="messages" scope="session" />

复制代码

fragments/footer.jspf

2. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
5. <div class="footer">
6.     <p>&copy; 2023 Multilingual Website. All rights reserved.</p>
7.    
8.     <div class="language-selector">
9.         <fmt:message key="language"/>:
10.         <a href="?lang=en_US">English</a> |
11.         <a href="?lang=zh_CN">中文</a> |
12.         <a href="?lang=ja_JP">日本語</a>
13.     </div>
14. </div>

复制代码

index.jsp

2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
6. <!DOCTYPE html>
7. <html>
8. <head>
9.     <meta charset="UTF-8">
10.     <title><fmt:message key="greeting"/></title>
11.     <link rel="stylesheet" type="text/css" href="css/style.css">
12. </head>
13. <body>
14.     <%@ include file="fragments/header.jspf" %>
15.    
16.     <div class="container">
17.         <h1><fmt:message key="welcome"/></h1>
18.         
19.         <p><fmt:message key="intro.text"/></p>
20.         
21.         <c:if test="${empty sessionScope.user}">
22.             <div class="login-link">
23.                 <a href="login.jsp"><fmt:message key="login"/></a>
24.             </div>
25.         </c:if>
26.         
27.         <c:if test="${not empty sessionScope.user}">
28.             <div class="user-info">
29.                 <p><fmt:message key="welcome.user">
30.                     <fmt:param value="${sessionScope.user}"/>
31.                 </fmt:message></p>
32.                 <a href="logout"><fmt:message key="logout"/></a>
33.             </div>
34.         </c:if>
35.     </div>
36.    
37.     <%@ include file="fragments/footer.jspf" %>
38. </body>
39. </html>

复制代码

login.jsp

2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
6. <!DOCTYPE html>
7. <html>
8. <head>
9.     <meta charset="UTF-8">
10.     <title><fmt:message key="login"/></title>
11.     <link rel="stylesheet" type="text/css" href="css/style.css">
12. </head>
13. <body>
14.     <%@ include file="fragments/header.jspf" %>
15.    
16.     <div class="container">
17.         <h1><fmt:message key="login"/></h1>
18.         
19.         <c:if test="${not empty error}">
20.             <div class="error-message">
21.                 <c:out value="${error}"/>
22.             </div>
23.         </c:if>
24.         
25.         <form action="login" method="post">
26.             <div class="form-group">
27.                 <label for="username"><fmt:message key="username"/>:</label>
28.                 <input type="text" id="username" name="username" required>
29.             </div>
30.             
31.             <div class="form-group">
32.                 <label for="password"><fmt:message key="password"/>:</label>
33.                 <input type="password" id="password" name="password" required>
34.             </div>
35.             
36.             <div class="form-group">
37.                 <button type="submit"><fmt:message key="submit"/></button>
38.             </div>
39.         </form>
40.         
41.         <div class="back-link">
42.             <a href="index.jsp"><fmt:message key="home"/></a>
43.         </div>
44.     </div>
45.    
46.     <%@ include file="fragments/footer.jspf" %>
47. </body>
48. </html>

复制代码

welcome.jsp

2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
3. <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
4. <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
6. <!DOCTYPE html>
7. <html>
8. <head>
9.     <meta charset="UTF-8">
10.     <title><fmt:message key="welcome"/></title>
11.     <link rel="stylesheet" type="text/css" href="css/style.css">
12. </head>
13. <body>
14.     <%@ include file="fragments/header.jspf" %>
15.    
16.     <div class="container">
17.         <h1><fmt:message key="welcome.user">
18.             <fmt:param value="${sessionScope.user}"/>
19.         </fmt:message></h1>
20.         
21.         <p><fmt:message key="current.date"/>:
22.             <fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="medium"/></p>
23.         
24.         <div class="actions">
25.             <a href="index.jsp"><fmt:message key="home"/></a> |
26.             <a href="logout"><fmt:message key="logout"/></a>
27.         </div>
28.     </div>
29.    
30.     <%@ include file="fragments/footer.jspf" %>
31. </body>
32. </html>

复制代码

css/style.css

2. body {
3.     font-family: Arial, sans-serif;
4.     margin: 0;
5.     padding: 0;
6.     background-color: #f5f5f5;
7. }
9. .container {
10.     max-width: 800px;
11.     margin: 0 auto;
12.     padding: 20px;
13.     background-color: #fff;
14.     border-radius: 5px;
15.     box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
16. }
18. h1 {
19.     color: #333;
20.     border-bottom: 2px solid #eee;
21.     padding-bottom: 10px;
22. }
24. .form-group {
25.     margin-bottom: 15px;
26. }
28. .form-group label {
29.     display: block;
30.     margin-bottom: 5px;
31.     font-weight: bold;
32. }
34. .form-group input {
35.     width: 100%;
36.     padding: 8px;
37.     border: 1px solid #ddd;
38.     border-radius: 4px;
39.     box-sizing: border-box;
40. }
42. button {
43.     background-color: #4CAF50;
44.     color: white;
45.     padding: 10px 15px;
46.     border: none;
47.     border-radius: 4px;
48.     cursor: pointer;
49. }
51. button:hover {
52.     background-color: #45a049;
53. }
55. .error-message {
56.     color: #D8000C;
57.     background-color: #FFD2D2;
58.     padding: 10px;
59.     margin-bottom: 20px;
60.     border-radius: 4px;
61. }
63. .footer {
64.     margin-top: 20px;
65.     padding-top: 20px;
66.     border-top: 1px solid #eee;
67.     text-align: center;
68.     color: #777;
69. }
71. .language-selector {
72.     margin-top: 10px;
73. }
75. .language-selector a {
76.     margin: 0 5px;
77.     text-decoration: none;
78.     color: #4CAF50;
79. }
81. .language-selector a:hover {
82.     text-decoration: underline;
83. }
85. .login-link, .back-link, .actions {
86.     margin-top: 20px;
87. }
89. .login-link a, .back-link a, .actions a {
90.     color: #4CAF50;
91.     text-decoration: none;
92. }
94. .login-link a:hover, .back-link a:hover, .actions a:hover {
95.     text-decoration: underline;
96. }

复制代码

web.xml配置

2. <?xml version="1.0" encoding="UTF-8"?>
3. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
4.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5.          xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
6.                              http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
7.          version="4.0">
8.    
9.     <!-- 配置字符编码过滤器 -->
10.     <filter>
11.         <filter-name>CharacterEncodingFilter</filter-name>
12.         <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
13.         <init-param>
14.             <param-name>encoding</param-name>
15.             <param-value>UTF-8</param-value>
16.         </init-param>
17.         <init-param>
18.             <param-name>forceEncoding</param-name>
19.             <param-value>true</param-value>
20.         </init-param>
21.     </filter>
22.    
23.     <filter-mapping>
24.         <filter-name>CharacterEncodingFilter</filter-name>
25.         <url-pattern>/*</url-pattern>
26.     </filter-mapping>
27.    
28.     <!-- 配置默认语言环境 -->
29.     <context-param>
30.         <param-name>javax.servlet.jsp.jstl.fmt.locale</param-name>
31.         <param-value>en_US</param-value>
32.     </context-param>
33.    
34.     <!-- 配置资源包的基础名称 -->
35.     <context-param>
36.         <param-name>javax.servlet.jsp.jstl.fmt.localizationContext</param-name>
37.         <param-value>messages</param-value>
38.     </context-param>
39.    
40.     <!-- 欢迎页面配置 -->
41.     <welcome-file-list>
42.         <welcome-file>index.jsp</welcome-file>
43.     </welcome-file-list>
44. </web-app>

复制代码

这个完整的示例展示了一个支持多语言的JSP网站的基本结构和实现方式。用户可以通过语言选择器切换不同的语言，网站会根据用户的选择显示相应语言的内容。同时，示例还包括了用户登录功能，展示了如何在Servlet中处理国际化消息。

总结

JSP国际化是构建多语言网站的关键技术，它允许开发者创建能够适应不同语言和地区的应用程序。通过本文的介绍，我们了解了JSP国际化的基本原理、核心技术、实现步骤以及高级主题。

主要要点包括：

1. 资源文件管理：将所有文本内容提取到属性文件中，按语言环境组织。
2. Locale处理：使用Locale类表示特定的语言环境，并通过过滤器或会话管理用户的语言偏好。
3. JSTL fmt标签：利用JSTL的fmt标签库简化JSP页面中的国际化操作。
4. 动态语言切换：实现允许用户在运行时切换语言的功能。
5. 高级格式处理：处理日期、时间、数字和货币的地区特定格式。
6. 文本方向支持：考虑从右到左语言的特殊需求。
7. 最佳实践：遵循编码标准、避免硬编码文本、提供完整翻译等。

资源文件管理：将所有文本内容提取到属性文件中，按语言环境组织。

Locale处理：使用Locale类表示特定的语言环境，并通过过滤器或会话管理用户的语言偏好。

JSTL fmt标签：利用JSTL的fmt标签库简化JSP页面中的国际化操作。

动态语言切换：实现允许用户在运行时切换语言的功能。

高级格式处理：处理日期、时间、数字和货币的地区特定格式。

文本方向支持：考虑从右到左语言的特殊需求。

最佳实践：遵循编码标准、避免硬编码文本、提供完整翻译等。

通过遵循这些原则和技术，您可以构建出真正国际化、用户体验良好的多语言网站。随着全球化的发展，国际化已成为现代Web应用开发的重要技能，希望本文能帮助您更好地理解和实现JSP国际化。