首页
/ 正文

Servlet 国际化（建议收藏）

更新时间: 2025-04-01 02:44:47

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

在当今全球化的互联网时代，构建支持多语言的 Web 应用程序已成为开发者必备的能力之一。Servlet 国际化作为 Java Web 开发中的核心技能，能够帮助开发者轻松实现用户界面的多语言适配，提升用户体验。无论是面向国际市场的电商网站，还是需要覆盖多地区的公共服务平台，掌握这一技术都至关重要。本文将从基础概念、实现步骤到实战案例，逐步解析如何通过 Servlet 实现高效、灵活的国际化功能。

一、什么是国际化？

国际化（Internationalization，简称 I18n）是指在软件设计阶段预先考虑支持多种语言和地区的特性，而本地化（Localization，简称 L10n）则是针对特定地区或语言进行内容适配的过程。两者的结合，共同构成了多语言应用的核心能力。

1.1 国际化的关键概念

Locale（区域设置）：由语言代码（如 en 表示英语）、国家/地区代码（如 US 表示美国）和变体代码组成，例如 zh_CN 表示简体中文（中国）。
ResourceBundle（资源包）：存储不同语言文本的键值对集合，类似于“词典”。例如，messages.properties 可能包含 greeting=Hello，而 messages_zh.properties 则对应 greeting=你好。
ResourceBundle.Control：用于控制资源包的加载逻辑，如缓存策略或自定义查找规则。

1.2 为什么需要国际化？

想象一个场景：一家电商网站仅支持英文界面，当中国用户访问时，他们可能因无法理解内容而流失。通过国际化，开发者可以：

降低维护成本：统一管理文本，避免重复编码。
提升用户体验：用户可选择母语界面，降低使用门槛。
扩展市场覆盖：快速适配不同地区，打开新用户群体。

二、Servlet 国际化的实现步骤

接下来，我们将通过一个简单案例，分步骤演示如何实现基于 Servlet 的国际化功能。

2.1 步骤 1：创建资源文件

资源文件是国际化的核心，需遵循以下规则：

文件名格式：basename_locale.properties，例如：
- messages.properties（默认语言，通常为英语）
- messages_zh.properties（中文）
- messages_fr.properties（法语）

内容格式：键值对，键名需唯一且无空格，如：

# messages.properties  
welcome.message=Welcome to our website!  
login.button=Sign In  

# messages_zh.properties  
welcome.message=欢迎来到我们的网站！  
login.button=登录

表格：资源文件命名规范

场景	文件名示例	说明
默认语言	`messages.properties`	无后缀表示基础语言（如英语）
指定语言	`messages_fr.properties`	法语（法语代码 `fr`）
语言+地区组合	`messages_zh_TW.properties`	繁体中文（台湾地区）

2.2 步骤 2：配置 Locale 解析逻辑

在 Servlet 中，需通过 Locale 对象确定用户的语言偏好。常见的解析方式包括：

从 HTTP 请求头获取：用户浏览器通常会发送 Accept-Language 头，例如 en-US,en;q=0.5。
通过 URL 参数指定：用户可通过 URL 传递语言参数，如 ?lang=zh。

代码示例：解析 Locale

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
    // 方法1：从请求头获取  
    Locale locale = request.getLocale();  

    // 方法2：从URL参数获取（优先级更高）  
    String lang = request.getParameter("lang");  
    if (lang != null) {  
        locale = new Locale(lang); // 如 lang=zh → Locale.SIMPLIFIED_CHINESE  
    }  

    // 使用 Locale 加载资源  
    ResourceBundle bundle = ResourceBundle.getBundle("messages", locale);  
    String welcome = bundle.getString("welcome.message");  
    response.getWriter().write(welcome);  
}

2.3 步骤 3：动态替换界面文本

在 HTML 或 JSP 页面中，通过 EL 表达式或直接调用资源包获取文本。例如：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>  
<%  
    // 设置页面编码  
    request.setCharacterEncoding("UTF-8");  
    response.setCharacterEncoding("UTF-8");  
%>  
<html>  
<head>  
    <title><%= ResourceBundle.getBundle("messages", locale).getString("page.title") %></title>  
</head>  
<body>  
    <h1><%= ResourceBundle.getBundle("messages", locale).getString("welcome.message") %></h1>  
    <form action="/login" method="post">  
        <button type="submit"><%= ResourceBundle.getBundle("messages", locale).getString("login.button") %></button>  
    </form>  
</body>  
</html>

三、进阶技巧与常见问题

3.1 动态切换语言

用户可能需要在页面上实时切换语言，例如通过下拉菜单选择“中文”或“英文”。此时可通过重定向或会话（Session）保存用户偏好：

// 在切换语言的 Servlet 中  
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
    String selectedLang = request.getParameter("language");  
    Locale locale = new Locale(selectedLang);  

    // 保存到 Session  
    request.getSession().setAttribute("userLocale", locale);  
    response.sendRedirect(request.getHeader("Referer")); // 重定向回原页面  
}

3.2 处理复杂格式（如日期、货币）

资源文件仅能存储静态文本，若需动态格式化内容（如显示日期），需结合 java.text 包：

// 格式化当前时间  
DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.LONG, locale);  
String formattedDate = dateFormat.format(new Date());

3.3 常见问题与解决方案

问题：资源文件未加载，始终显示默认语言。
- 原因：资源文件未放入正确目录（如 src/main/resources）。
- 解决：确保文件路径与包结构一致，例如 messages_zh.properties 应与 messages.properties 同级。
问题：特殊字符显示为乱码。
- 原因：资源文件未使用 UTF-8 编码保存。
- 解决：在编辑器中设置文件编码为 UTF-8，并在 Servlet 中指定编码格式：
```
response.setCharacterEncoding("UTF-8");  
response.setContentType("text/html; charset=UTF-8");  
```

四、实战案例：构建多语言登录页面

4.1 案例需求

用户可选择中英文界面。
登录按钮和提示文本需动态切换语言。

4.2 实现步骤

创建资源文件：

messages.properties：

login.title=Login Page  
login.username=Username:  
login.password=Password:

messages_zh.properties：

login.title=登录页面  
login.username=用户名：  
login.password=密码：

编写 Servlet：

@WebServlet("/login")  
public class LoginServlet extends HttpServlet {  
    protected void doGet(HttpServletRequest request, HttpServletResponse response)  
            throws ServletException, IOException {  
        // 获取用户选择的语言  
        String lang = request.getParameter("lang");  
        Locale locale = (lang != null) ? new Locale(lang) : request.getLocale();  

        // 将 Locale 放入请求属性  
        request.setAttribute("locale", locale);  
        RequestDispatcher dispatcher = request.getRequestDispatcher("/WEB-INF/views/login.jsp");  
        dispatcher.forward(request, response);  
    }  
}

编写 JSP 页面：

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>  
<html>  
<head>  
    <title><%= ResourceBundle.getBundle("messages", (Locale) request.getAttribute("locale")).getString("login.title") %></title>  
</head>  
<body>  
    <h1><%= ResourceBundle.getBundle("messages", (Locale) request.getAttribute("locale")).getString("login.title") %></h1>  
    <form action="/login" method="post">  
        <label><%= ResourceBundle.getBundle("messages", (Locale) request.getAttribute("locale")).getString("login.username") %>:  
            <input type="text" name="username"></label><br>  
        <label><%= ResourceBundle.getBundle("messages", (Locale) request.getAttribute("locale")).getString("login.password") %>:  
            <input type="password" name="password"></label><br>  
        <button type="submit">Submit</button>  
    </form>  
    <!-- 语言切换链接 -->  
    <a href="?lang=en">English</a> | <a href="?lang=zh">中文</a>  
</body>  
</html>

五、结论

通过本文的讲解，读者已掌握 Servlet 国际化 的核心原理与实现方法。从资源文件的创建、Locale 的解析到动态界面的渲染，每一步都体现了灵活性与可扩展性。随着应用规模的扩大，开发者还可进一步结合框架（如 Spring 的 MessageSource）或数据库实现更复杂的多语言管理。

国际化并非一次性任务，而是需要持续维护的工程。例如，新增语言时只需添加对应资源文件，无需修改业务逻辑。通过合理规划，开发者能够以最小的成本，让 Web 应用触达全球用户。

未来，随着 AI 翻译技术的发展，资源文件的生成效率将进一步提升，但掌握手动实现国际化仍是理解其底层逻辑的关键。希望本文能为你的多语言 Web 开发之路提供清晰的指引！

Servlet 国际化（建议收藏）

一、什么是国际化？

1.1 国际化的关键概念

1.2 为什么需要国际化？

二、Servlet 国际化的实现步骤

2.1 步骤 1：创建资源文件

表格：资源文件命名规范

2.2 步骤 2：配置 Locale 解析逻辑

代码示例：解析 Locale

2.3 步骤 3：动态替换界面文本

三、进阶技巧与常见问题

3.1 动态切换语言

3.2 处理复杂格式（如日期、货币）

3.3 常见问题与解决方案

四、实战案例：构建多语言登录页面

4.1 案例需求

4.2 实现步骤

五、结论

最新发布

HTML tfoot valign 属性（建议收藏）

HTML th abbr 属性（建议收藏）

HTML th align 属性（手把手讲解）

HTML th axis 属性（超详细）

HTML th bgcolor 属性（超详细）

HTML th char 属性（建议收藏）

HTML th charoff 属性（超详细）

HTML th colspan 属性（保姆级教程）

HTML th headers 属性（手把手讲解）

HTML th height 属性（超详细）