Struts 2 國際化實戰：從資源檔配置到前後端完整落地

核心機制：Struts 如何實現 i18n

Struts 透過 MessageResources 機制支援國際化：將不同語言文字放入對應的屬性檔，JSP 使用 <bean:message> 或 <s:text> 標籤，框架自動根據瀏覽器 Accept-Language 或 Session 中的 Locale 解析對應鍵值，實現零代碼侵入的多語言切換。

一、資源檔規範與生成流程

1. 命名慣例

基礎名稱.properties                    # 預設語言（通常英文）
基礎名稱_zh_CN.properties              # 簡體中文
基礎名稱_zh_TW.properties              # 繁體中文
基礎名稱_en_US.properties              # 美式英文

建議統一放置於 /WEB-INF/classes/resources/ 目錄，並在 struts-config.xml 配置：

<message-resources parameter="resources.ApplicationResources"/>

2. 編碼轉換關鍵步驟

1. 使用支援 UTF-8 的編輯器編寫，存檔為 UTF-8 編碼。
2. 執行 JDK 自帶 native2ascii 轉換為 Unicode 轉義格式：

   native2ascii -encoding UTF-8 ApplicationResources.properties ApplicationResources_zh_CN.properties
   

3. 轉換後檔案方可被 Java 正確讀取。

二、JSP 頁面完整國際化

1. 頁面編碼宣告

<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>

2. 文字顯示

<!-- Struts 1.x -->
<bean:message key="index.title"/>

<!-- Struts 2 -->
<s:text name="index.title"/>

3. Action 層手動獲取資源

MessageResources resources = getResources(request);
String msg = resources.getMessage(locale, "key");
request.setAttribute("dynamicMsg", msg);

其中 locale = (Locale) session.getAttribute(Globals.LOCALE_KEY)。

4. 使用者手動切換語言

Locale newLocale = new Locale(language, country);
session.setAttribute(Globals.LOCALE_KEY, newLocale);

語言/國家代碼參考 Unicode 官方列表。

三、圖片與動態內容國際化

1. 靜態圖片

為每種語言準備對應版本圖片，路徑寫入資源檔：

# 資源檔
logo.path=/images/logo_zh_CN.png

public class EncodingFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        req.setCharacterEncoding("UTF-8");
        resp.setCharacterEncoding("UTF-8");
        chain.doFilter(req, resp);
    }
}

<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>com.example.EncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>