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 的国际化功能。你可以根据需要创建多个资源文件，并根据用户的语言环境自动选择合适的资源文件。希望这份指南对你有所帮助！