Spring Boot国际化

SSSSSSch

于 2022-12-02 19:51:17 发布

阅读量209

点赞数

本文链接：https://blog.csdn.net/SSSSSSch/article/details/128153633

版权

Spring Boot国际化

国际化（Internationalization 简称 I18n，其中“I”和“n”分别为首末字符，18 则为中间的字符数）是指软件开发时应该具备支持多种语言和地区的功能。换句话说就是，开发的软件需要能同时应对不同国家和地区的用户访问，并根据用户地区和语言习惯，提供相应的、符合用具阅读习惯的页面和数据，例如，为中国用户提供汉语界面显示，为美国用户提供提供英语界面显示。在 Spring 项目中实现国际化，通常需要以下 3 步：
1编写国际化资源（配置）文件；
2使用 ResourceBundleMessageSource 管理国际化资源文件；
3在页面获取国际化内容。
1. 编写国际化资源文件
在 Spring Boot 的类路径下创建国际化资源文件，文件名格式为：基本名_语言代码_国家或地区代码，例如 login_en_US.properties、login_zh_CN.properties。以 spring-boot-springmvc-demo1为例，在 src/main/resources 下创建一个 i18n 的目录，并在该目录中按照国际化资源文件命名格式分别创建以下三个文件，
●login.properties：无语言设置时生效
●login_en_US.properties ：英语时生效
●login_zh_CN.properties：中文时生效
以上国际化资源文件创建完成后，IDEA 会自动识别它们，并转换成如下的模式：

图1：国际化资源文件
打开任意一个国际化资源文件，并切换为 Resource Bundle 模式，然后点击“+”号，创建所需的国际化属性，如下图。

图2：编辑国际化资源文件
2. 使用 ResourceBundleMessageSource 管理国际化资源文件
Spring Boot 已经对 ResourceBundleMessageSource 提供了默认的自动配置。 Spring Boot 通过 MessageSourceAutoConfiguration 对 ResourceBundleMessageSource 提供了默认配置，其部分源码如下。

从以上源码可知：
●Spring Boot 将 MessageSourceProperties 以组件的形式添加到容器中；
●MessageSourceProperties 的属性与配置文件中以“spring.messages”开头的配置进行了绑定；
●Spring Boot 从容器中获取 MessageSourceProperties 组件，并从中读取国际化资源文件的 basename（文件基本名）、encoding（编码）等信息，将它们封装到 ResourceBundleMessageSource 中；
●Spring Boot 将 ResourceBundleMessageSource 以组件的形式添加到容器中，进而实现对国际化资源文件的管理。
查看 MessageSourceProperties 类，其代码如下。

通过以上代码，我们可以得到以下 3 点信息：
●MessageSourceProperties 为 basename、encoding 等属性提供了默认值；
●basename 表示国际化资源文件的基本名，其默认取值为“message”，即 Spring Boot 默认会获取类路径下的 message.properties 以及 message_XXX.properties 作为国际化资源文件；
●在 application.porperties/yml 等配置文件中，使用配置参数“spring.messages.basename”即可重新指定国际化资源文件的基本名。
通过以上源码分析可知，Spring Boot 已经对国际化资源文件的管理提供了默认自动配置，我们这里只需要在 Spring Boot 全局配置文件中，使用配置参数“spring.messages.basename”指定我们自定义的国际资源文件的基本名即可，代码如下（当指定多个资源文件时，用逗号分隔）。

3. 获取国际化内容
由于页面使用的是 Tymeleaf 模板引擎，因此我们可以通过表达式 #{...} 获取国际化内容。在 login.html 中获取国际化内容，代码如下。

验证
启动 Spring Boot，使用浏览器访问登陆页，此时浏览器默认使用中文。

将浏览器语言切换为英文，再次访问登陆页。

手动切换语言
如下图所示，在登陆页（login.html）最下方有两个切换语言的链接，想要通过点击它们来切换进行国际化的语言，该怎么做呢？

图5：切换语言按钮
区域信息解析器自动配置
我们知道，Spring MVC 进行国际化时有 2 个十分重要的对象：
●Locale：区域信息对象
●LocaleResolver：区域信息解析器，容器中的组件，负责获取区域信息对象
我们可以通过以上两个对象对区域信息的切换，以达到切换语言的目的。 Spring Boot 在 WebMvcAutoConfiguration 中为区域信息解析器（LocaleResolver）进行了自动配置，源码如下。

从以上源码可知：
●该方法默认向容器中添加了一个区域信息解析器（LocaleResolver）组件，它会根据请求头中携带的“Accept-Language”参数，获取相应区域信息（Locale）对象。
●该方法上使用了 @ConditionalOnMissingBean 注解，其参数 name 的取值为 localeResolver（与该方法注入到容器中的组件名称一致），该注解的含义为：当容器中不存在名称为 localResolver 组件时，该方法才会生效。换句话说，当我们手动向容器中添加一个名为“localeResolver”的组件时，Spring Boot 自动配置的区域信息解析器会失效，而我们定义的区域信息解析器则会生效。
手动切换语言
1. 修改 login.html 切换语言链接，在请求中携带国际化区域信息.

2. 创建一个 component 包，并在该包中创建一个区域信息解析器 MyLocalResolver

package net.biancheng.www.componet;

import org.springframework.util.StringUtils;

import org.springframework.web.servlet.LocaleResolver;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import java.util.Locale;

//自定义区域信息解析器

public class MyLocalResolver implements LocaleResolver {

@Override

public Locale resolveLocale(HttpServletRequest request) {

//获取请求中参数

String l = request.getParameter("l");