国际化i18n应用

后端

2022-12-10 06:42:03

使用 Spring Boot 实现强大且可扩展的国际化

在当今全球互联的世界中，创建针对不同语言、地域和文化的应用程序至关重要。Spring Boot 通过其强大的国际化 (i18n) 支持，使这一任务变得轻而易举。

什么是国际化？

国际化是指将应用程序调整到不同语言环境的能力，同时考虑到文化差异和语言惯例。通过国际化，您可以扩展应用程序的覆盖范围并为更广泛的用户群提供本地化体验。

Spring Boot 的国际化特性

Spring Boot 提供了一系列开箱即用的国际化特性，简化了应用程序的本地化过程。这些特性包括：

MessageSource： 用于从国际化资源文件中获取翻译文本的接口。
LocaleResolver： 用于确定当前请求的语言环境。
内置的语言环境支持： 支持多种语言环境，包括英语、西班牙语、法语等。

配置 Spring Boot 的国际化

配置 Spring Boot 的国际化非常简单。只需执行以下步骤：

添加 Spring Boot Starter Web 依赖：

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

配置国际化属性： 在 application.properties 文件中，设置以下属性：

spring.messages.basename=i18n/messages
spring.messages.encoding=UTF-8

创建国际化资源文件： 在 i18n 目录下创建 messages.properties 文件，并添加语言翻译：

welcome=欢迎
goodbye=再见

使用国际化资源

要使用国际化资源，请在控制器中注入 MessageSource bean：

@RestController
public class ExampleController {

    @Autowired
    private MessageSource messageSource;

    @RequestMapping("/")
    public String index(Locale locale) {
        String message = messageSource.getMessage("welcome", null, locale);
        return "<h1>" + message + "</h1>";
    }
}

此代码从资源文件中检索翻译文本并将其呈现给用户。

最佳实践

在进行国际化时，遵循一些最佳实践可以提高您的应用程序的可维护性和效率：

使用不同的语言代码命名国际化资源文件，例如 messages_zh_CN.properties 和 messages_en_US.properties。
将国际化资源文件组织到一个单独的目录中。
使用 Spring Boot 提供的国际化工具，例如 MessageSource 和 LocaleResolver。
始终指定正确的语言环境时使用国际化资源。

代码示例

以下是一个完整的 Spring Boot 应用程序示例，演示了如何使用国际化：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Locale;

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Bean
    public MessageSource messageSource() {
        ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
        messageSource.setBasename("classpath:i18n/messages");
        messageSource.setDefaultEncoding("UTF-8");
        return messageSource;
    }

    @RestController
    public class ExampleController {

        @Autowired
        private MessageSource messageSource;

        @RequestMapping("/")
        public String index(Locale locale) {
            String message = messageSource.getMessage("welcome", null, locale);
            return "<h1>" + message + "</h1>";
        }
    }
}