springboot：员工管理系统-国际化

什么是页面国际化？

    我们在浏览网页时，我们看到很多网页都支持多语言切换，比如下图（vue官网）

    我们看一下自己的index.html

    我们页面也有中英文切换的效果，只是还没有实现

    我们有五个地方需要国际化

    我们来实现国际化这个功能！

实现页面国际化

1. 首先需要把IDEA同一字符编码为：UTF-8
   
   
2. 接下来我们在resources资源文件下新建一个i18n目录，建立一个login.propetries文件
3. 再创建login_zh_US.properties,发现IDEA自动识别了我们要做国际化操作;所以文件夹有了变化
   
4. 我们可以在这上面去新建一个文件；
   
   
5. 文件建立完毕
   
6. 我们进入到idea中带有的可视化编辑功能
   
7. 通过视图我们点击 + 号就可以直接添加属性了；我们来依次创建可视化内容
   
8. 然后去查看我们的配置文件；

    login.properties 默认

login.btn=登录
login.password=请输入密码
login.rember=记住我
login.tip=请登录
login.username=请输入用户名

    中文

login.btn=登录
login.password=请输入密码
login.rember=记住我
login.tip=请登录
login.username=请输入用户名

    英文

login.btn=Sign in
login.password=Username
login.rember=Remember me
login.tip=Please sign in
login.username=Username

    这样，我们完成了对国际化配置的编写!

springboot对国际化的自动装配

    我们去看一下SpringBoot对国际化的自动配置！

    这里又涉及到一个底层的类，我们来看一下源码：

    MessageSourceAutoConfiguration ，这个类里面发现SpringBoot已经自动配置好了管理我们国际化资源文件的组件 ResourceBundleMessageSource；

public class MessageSourceAutoConfiguration {
    private static final Resource[] NO_RESOURCES = new Resource[0];

    public MessageSourceAutoConfiguration() {
    }

    @Bean
    @ConfigurationProperties(prefix = "spring.messages") 
    public MessageSourceProperties messageSourceProperties() {
        return new MessageSourceProperties();
    }

    @Bean
    public MessageSource messageSource(MessageSourceProperties properties) {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        if (StringUtils.hasText(properties.getBasename())) {　　　　　　　　//设置国际化文件的基础名（去掉语言国家代码的）
            messageSource.setBasenames(StringUtils.commaDelimitedListToStringArray(StringUtils.trimAllWhitespace(properties.getBasename())));
        }

        if (properties.getEncoding() != null) {
            messageSource.setDefaultEncoding(properties.getEncoding().name());
        }

        messageSource.setFallbackToSystemLocale(properties.isFallbackToSystemLocale());
        Duration cacheDuration = properties.getCacheDuration();
        if (cacheDuration != null) {
            messageSource.setCacheMillis(cacheDuration.toMillis());
        }

        messageSource.setAlwaysUseMessageFormat(properties.isAlwaysUseMessageFormat());
        messageSource.setUseCodeAsDefaultMessage(properties.isUseCodeAsDefaultMessage());
        return messageSource;
    }
}

    我们把国际化文件放在了i18n文件下，所以我们需要在配置文件中配置一下

# 我们的配置文件放在的真实位置
spring.messages.basename=i18n.login

    当然我们配置了国际化，之前的页面肯定要修改，所以我们要获取国际化的值

    页面修改如下，需要以th:开头，并且以[["行内的方式"]]接受了参数

    我们再重新测试一下，可以看到我们的页面变成了，中文显示

优化代码，中英文可以切换

    在Spring中有一个国际化的Locale （区域信息对象）；里面有一个叫做LocaleResolver （获取区域信息对象）的解析器

    我们去我们webmvc自动配置文件，寻找一下！看到SpringBoot默认配置

@Bean
        @ConditionalOnMissingBean
        @ConditionalOnProperty(
            prefix = "spring.mvc",
            name = {"locale"}
        )
        public LocaleResolver localeResolver() {            //容器中没有就自己配，有的话就用用户配置的
            if (this.mvcProperties.getLocaleResolver() == org.springframework.boot.autoconfigure.web.servlet.WebMvcProperties.LocaleResolver.FIXED) {
                return new FixedLocaleResolver(this.mvcProperties.getLocale());
            } else {
                AcceptHeaderLocaleResolver localeResolver = new AcceptHeaderLocaleResolver();
                localeResolver.setDefaultLocale(this.mvcProperties.getLocale());
                return localeResolver;
            }
        }

    AcceptHeaderLocaleResolver 这个类中有一个方法

public Locale resolveLocale(HttpServletRequest request) {
        Locale defaultLocale = this.getDefaultLocale();        //默认的是根据请求头带来的区域信息获取Locale进行国际化
        if (defaultLocale != null && request.getHeader("Accept-Language") == null) {
            return defaultLocale;
        } else {
            Locale requestLocale = request.getLocale();
            List<Locale> supportedLocales = this.getSupportedLocales();
            if (!supportedLocales.isEmpty() && !supportedLocales.contains(requestLocale)) {
                Locale supportedLocale = this.findSupportedLocale(request, supportedLocales);
                if (supportedLocale != null) {
                    return supportedLocale;
                } else {
                    return defaultLocale != null ? defaultLocale : requestLocale;
                }
            } else {
                return requestLocale;
            }
        }
    }

    我们现在想点击链接让我们的国际化资源生效，就需要自己重写LocaleResolver方法

    我们去自己写一个自己的LocaleResolver，可以在链接上携带区域信息！

    首先修改一下前端页面的跳转连接；

    //这里传入参数不需要使用 “数据？key=value” 使用 “（key=value）”

<a class="btn btn-sm" th:href="@{/index.html(l='zh_CN')}">中文</a>
<a class="btn btn-sm" th:href="@{/index.html(l='en_US')}">English</a>

    在config文件/… 创建一个MyLocaleResolver类，用来重写LocaleResolver方法

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 MyLocaleResolver implements LocaleResolver {

    //解析请求
    @Override
    public Locale resolveLocale(HttpServletRequest request) {

        String language = request.getParameter("l");
        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 httpServletRequest, HttpServletResponse httpServletResponse, Locale locale) {

    }
}

    为了让我们的国际化资源能够生效，我们需要在MvcConfig类通过bean交给spring托管！

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

    我们重启项目，来测试，发现点击按钮可以成功实现中英切换！

    总结步骤

1. 我们需要配置i18n文件

2. 我们如果需要在项目中进行按钮自动切换，我们需要自定义一个组件LocaleResolver

3. 记得将自己写的组件配置到spring容器中 @Bean

4. 去给页面通过#{}赋值，让中英文跳转链接生效