Spring Boot國際化配置指南

Spring Boot 提供了強大的國際化（i18n）支持，使得開發者可以輕松地實現多語言應用程序。下面是一份詳細的 Spring Boot 國際化配置指南：

1. 添加依賴

首先，在你的 pom.xml 文件中添加 Spring Boot 的國際化依賴：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

2. 配置國際化資源文件

在 src/main/resources 目錄下創建國際化資源文件。Spring Boot 支持多種文件格式，包括 .properties、.yml 和 .xml。

示例 .properties 文件

創建一個名為 messages.properties 的文件，并添加一些國際化文本：

hello.world=Hello, World!
welcome.message=${welcome.message}

示例 .yml 文件

創建一個名為 messages.yml 的文件，并添加一些國際化文本：

hello:
  world: Hello, World!
welcome:
  message: ${welcome.message}

3. 配置 LocaleResolver 和 MessageSource

Spring Boot 默認使用 AcceptHeaderLocaleResolver 和 ResourceBundleMessageSource。你可以在 application.properties 或 application.yml 中進行配置。

配置 AcceptHeaderLocaleResolver

在 application.properties 中添加以下配置：

spring.mvc.locale=en_US
spring.mvc.locale-resolver=org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver

或者在 application.yml 中添加以下配置：

spring:
  mvc:
    locale: en_US
    locale-resolver: org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver

配置 ResourceBundleMessageSource

在 application.properties 中添加以下配置：

spring.messages.basename=messages

或者在 application.yml 中添加以下配置：

spring:
  messages:
    basename: messages

4. 使用國際化文本

在你的控制器或服務類中使用 @Value 注解讀取國際化文本。

示例控制器

創建一個名為 HomeController 的控制器：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HomeController {

    @Value("${hello.world}")
    private String helloWorld;

    @GetMapping("/")
    public String index(Model model) {
        model.addAttribute("helloWorld", helloWorld);
        return "index";
    }
}

5. 配置請求路徑和文件名

Spring Boot 支持根據請求路徑和文件名自動選擇合適的國際化資源文件。你可以在 application.properties 或 application.yml 中進行配置。

配置請求路徑

在 application.properties 中添加以下配置：

spring.mvc.locale-path-pattern=/i18n/{locale}/{basename}

或者在 application.yml 中添加以下配置：

spring:
  mvc:
    locale-path-pattern: /i18n/{locale}/{basename}

6. 使用 LocaleContextHolder

你還可以使用 LocaleContextHolder 來手動設置和獲取當前的語言環境。

設置語言環境

import org.springframework.context.i18n.LocaleContextHolder;
import org.springframework.stereotype.Service;

@Service
public class LocaleService {

    public void setLocale(String locale) {
        LocaleContextHolder.setLocale(new Locale(locale));
    }
}

獲取語言環境

import org.springframework.context.i18n.LocaleContextHolder;
import org.springframework.stereotype.Service;

@Service
public class LocaleService {

    public String getLocale() {
        return LocaleContextHolder.getLocale().getLanguage();
    }
}

總結

通過以上步驟，你已經成功配置了 Spring Boot 的國際化功能。你可以根據需要創建多個資源文件，并根據用戶的語言環境自動選擇合適的資源文件。希望這份指南對你有所幫助！