SpringBoot国际化i18n

依赖加载

<!--thymeleaf模板-->
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring5</artifactId>
</dependency>
<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-java8time</artifactId>
</dependency>

设置IDEA编码器格式

在idea中设置统一的编码格式，file->settings->Editors->File Encoding,选择编码格式为utf-8

添加国际化语言文件

在resources资源文件下创建一个i8n的目录，创建一个login.properties的文件，还有login_zh_CN.properties,idea会自动识别国际化操作

#login.properties
login.password=密码1
login.remmber=记住我1
login.sign=登录1
login.username=用户名1
#login_en_US.properties
login.password=Password
login.remmber=Remember Me
login.sign=Sign In
login.username=Username
#login_zh_CN.properties
login.password=密码~
login.remmber=记住我~
login.sign=登录~
login.username=用户名~

添加配置

spring.messages.basename=i18n/login

多语言页面

package com.mashibing.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.util.StringUtils;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;

@Configuration
public class WebMVCConfig implements WebMvcConfigurer {

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("login");
        registry.addViewController("/login.html").setViewName("login");
    }

    @Bean
    public LocaleResolver localeResolver(){
        return new NativeLocaleResolver();
    }

    protected static class NativeLocaleResolver implements LocaleResolver{

        @Override
        public Locale resolveLocale(HttpServletRequest request) {
            String language = request.getParameter("language");
            Locale locale = Locale.getDefault();
            if(!StringUtils.isEmpty(language)){
                String[] split = language.split("_");
                locale = new Locale(split[0],split[1]);
            }
            return locale;
        }

        @Override
        public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {

        }
    }
}

多语言切换配置代码

添加WebMVCConfig.java代码，主要是做自定义添加视图和控制层绑定关系和获取前端语言参数“language”转换成渲染视图时语言。
代码如果看不懂可以参考 SpringMVC扩展

package com.mashibing.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.util.StringUtils;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;

@Configuration
public class WebMVCConfig implements WebMvcConfigurer {

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("login");
        registry.addViewController("/login.html").setViewName("login");
    }

    @Bean
    public LocaleResolver localeResolver(){
        return new NativeLocaleResolver();
    }

    protected static class NativeLocaleResolver implements LocaleResolver{

        @Override
        public Locale resolveLocale(HttpServletRequest request) {
            String language = request.getParameter("language");
            Locale locale = Locale.getDefault();
            if(!StringUtils.isEmpty(language)){
                String[] split = language.split("_");
                locale = new Locale(split[0],split[1]);
            }
            return locale;
        }

        @Override
        public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {

        }
    }
}

实现过程源码

看源码可以知道实现原理，再就是会出现种奇奇怪怪的问题需要解决。本示例中我提供一个源码，你可以拉下来自己运行，对比自己的问题。
圈重点

MessageSourceAutoConfiguration类中看到加载实例化的条件和获取的系统的参数名“spring.messages”。

创建bean "messageSource"的方法，也是国际化处理类的实例化。
可以在这里打断点判断是否实例化。

ResourceBundleCondition类是实例化国际化bean的前置条件。
主要通过获取的配置文件的路径然后读取对应的文件，如果能读到就实例化，如果不能读取就不能实例化。国家失败多数问题出现在这里，读取不到的文件导致实话失败。可以参考SpringBoot静态资源加载 删除一些不要的加载文件夹，或者修改加载路径。

WebMvcAutoConfiguration的内部类EnableWebMvcConfiguration中的localeResolve()地区语言bean创建
从代码中可以看出，默认语言选择优先选择header中“Accept-Language”也可以通过“spring.web.locale”去配置语言。

AcceptHeaderLocaleResolver类中获取请求“语言”从debug 中可以看我们选择的获取的值是的请求头中“Accept-Language”，如果在实际项目中我们只需要修改请求头就可以控制语言的切换，我自己的项目为简单前端请求，就再项目中从新实现的bean,这样就可以通过传参控制语言选择。

SpringBoot学习之路

代码地址
https://gitee.com/zhang798/spring-demo.git
分支 SpringBoot_i18n

git clone https://gitee.com/zhang798/spring-demo.git -b SpringBoot_i18n