异常教程

JSP 国际化（保姆级教程）

更新时间:

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

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

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

在当今全球化背景下，Web 应用的用户群体可能来自不同国家和地区。如何让同一套代码适配多种语言和文化习惯，成为开发者必须面对的挑战。JSP 国际化正是为了解决这一问题而设计的技术方案，它通过灵活的资源文件管理和动态语言切换机制，帮助开发者轻松实现多语言支持。本文将从基础概念到实战案例，逐步解析 JSP 国际化的实现原理与具体操作，尤其适合编程初学者和中级开发者快速掌握这一技能。

JSP 国际化的核心概念与原理

什么是 JSP 国际化？

JSP 国际化（Internationalization，简称 I18N）是指在 Web 应用中，通过技术手段将界面文本、日期格式、货币符号等元素与代码逻辑分离，使其能够根据用户的语言环境动态适配。例如，当用户选择中文界面时，系统自动显示中文文本；选择英文时则切换为英文文本。

核心机制：资源文件与 Locale

JSP 国际化的核心是 资源文件（Resource Bundle） 和 Locale（地区与语言标识）。资源文件以键值对形式存储多语言文本，而 Locale 则通过 language 和 country 两个属性（如 en_US 表示美国英语）确定当前用户的语言环境。

形象比喻：可以将资源文件想象成一本“翻译字典”，而 Locale 就是用户选择的“语言版本开关”。当系统需要显示文本时，它会根据当前 Locale 从字典中找到对应的翻译内容。

实现 JSP 国际化的步骤与案例

第一步：创建资源文件

资源文件通常以 .properties 格式保存，命名规则为：

  • basename_language_country.properties
    例如：
  • messages_zh_CN.properties（中文简体）
  • messages_en_US.properties（美国英语）

资源文件内容示例

welcome=欢迎来到我的网站！  
login=登录  
register=注册  

welcome=Welcome to My Site!  
login=Login  
register=Register

注意：资源文件应与 JSP 文件位于同一包或指定路径下，如 src/main/resources 目录。

第二步：在 JSP 中使用 JSTL 标签读取资源

JSTL（JSP Standard Tag Library）的 fmt 标签库提供了对国际化的直接支持。需在 JSP 文件顶部引入：

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

基础用法：显示翻译文本

<fmt:setBundle basename="messages" var="msg" />  
<p><fmt:message key="welcome" bundle="${msg}" /></p>

这里，basename 指向资源文件的基名 messages，系统会根据当前 Locale 自动匹配对应的文件（如 messages_zh_CN.properties）。

第三步：设置与获取 Locale

方法 1：通过请求参数动态切换语言

用户可通过 URL 参数传递 Locale，例如：

<!-- 切换到英文界面 -->  
<a href="?lang=en">English</a>  
<!-- 切换到中文界面 -->  
<a href="?lang=zh">中文</a>

在 Servlet 或 JSP 中获取参数并设置 Locale：

// 在 Servlet 中  
String lang = request.getParameter("lang");  
Locale locale = (lang != null) ? new Locale(lang) : Locale.getDefault();  
request.getSession().setAttribute("userLocale", locale);

方法 2：根据用户浏览器设置自动匹配

若未指定参数，可通过 request.getLocale() 获取浏览器默认的 Locale：

Locale locale = request.getLocale();

第四步：在 JSP 中应用 Locale

使用 fmt:setLocale 标签将 Locale 应用到当前页面：

<%-- 从 Session 中获取 Locale --%>  
<fmt:setLocale value="${sessionScope.userLocale}" />  
<fmt:setBundle basename="messages" />  

<p><fmt:message key="welcome" /></p>

完整案例：动态切换语言界面

1. 创建资源文件结构

src/main/resources/  
    messages_zh_CN.properties  
    messages_en_US.properties

2. 在 JSP 中实现语言切换链接

<%@ page contentType="text/html;charset=UTF-8" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

<%-- 设置默认 Locale --%>
<c:set var="userLocale" value="${sessionScope.userLocale}" scope="session"/>
<c:if test="${empty userLocale}">
    <c:set var="userLocale" value="${request.locale}" scope="session"/>
</c:if>

<fmt:setLocale value="${userLocale}" />
<fmt:setBundle basename="messages" var="msg"/>

<!DOCTYPE html>
<html>
<head>
    <title><fmt:message key="title" /></title>
</head>
<body>
    <h1><fmt:message key="welcome" /></h1>
    
    <!-- 语言切换按钮 -->
    <a href="?lang=en">English</a> | 
    <a href="?lang=zh">中文</a>
    
    <form action="submit">
        <label for="username"><fmt:message key="username" /></label>
        <input type="text" id="username" name="username">
    </form>
</body>
</html>

3. 在 Servlet 中处理 Locale 传递

@WebServlet("/setLanguage")  
public class LanguageServlet extends HttpServlet {  
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  
        String lang = request.getParameter("lang");  
        Locale locale = (lang != null) ? new Locale(lang) : Locale.getDefault();  
        request.getSession().setAttribute("userLocale", locale);  
        response.sendRedirect("index.jsp");  
    }  
}

进阶技巧：日期与货币的国际化

1. 格式化日期

通过 fmt:formatDate 标签自动适配不同地区的日期格式：

<fmt:formatDate value="${date}" type="both" dateStyle="long" timeStyle="medium" />

例如：

  • 中文环境显示为“2023年10月5日 下午3:45:30”
  • 英文环境显示为“October 5, 2023 3:45:30 PM”

2. 处理货币符号

使用 fmt:formatNumber 标签动态显示货币符号：

<fmt:formatNumber value="${price}" type="currency" />

例如：

  • 中文环境显示“¥ 99.00”
  • 美国环境显示“$99.00”

常见问题与解决方案

问题 1：资源文件未生效

可能原因：资源文件路径错误或命名不符合规则。
解决方案：

  1. 确认文件名是否为 basename_language_country.properties
  2. 检查资源文件是否存放在 src/main/resources 或类路径下

问题 2：动态切换语言后页面未更新

可能原因：未正确将 Locale 存入 Session 或 Request。
解决方案：
在 JSP 中强制刷新页面：

<% response.sendRedirect("index.jsp"); %>

结论

通过本文的讲解，读者应已掌握 JSP 国际化 的核心方法：利用资源文件分离文本、通过 JSTL 标签动态读取、结合 Locale 实现语言切换，并能处理日期与货币的格式化。这一技术不仅提升代码的可维护性，还能显著扩展 Web 应用的用户覆盖范围。建议读者通过实际项目练习，例如开发一个多语言的个人博客或电商网站，进一步巩固所学知识。

关键点回顾：

  • 资源文件的命名与内容管理
  • JSTL fmt 标签的使用场景
  • Locale 的动态设置与传递
  • 日期、货币的国际化处理

掌握这些技能后，开发者可以更从容地应对全球化业务需求，为用户提供无缝的多语言体验。

最新发布

查看更多文章