SpringBoot系列之i18n集成教程

SpringBoot系統(tǒng)之i18n國際化語言集成教程
@[toc]

1、環(huán)境搭建

本博客介紹一下SpringBoot集成i18n，實(shí)現(xiàn)系統(tǒng)語言國際化處理，ok，先創(chuàng)建一個(gè)SpringBoot項(xiàng)目，具體的參考我的博客專欄：SpringBoot系列博客專欄鏈接

環(huán)境準(zhǔn)備：

  • IntelliJ IDEA
  • Maven

項(xiàng)目集成：

  • Thymeleaf(模板引擎，也可以選jsp或者freemark)
  • SpringBoot2.2.1.RELEASE

2、resource bundle資源配置

ok，要實(shí)現(xiàn)國際化語言，先要?jiǎng)?chuàng)建resource bundle文件：
在resources文件夾下面創(chuàng)建一個(gè)i18n的文件夾，其中：

  • messages.properties是默認(rèn)的配置
  • messages_zh_CN.properties是（中文/中國）
  • messages_en_US.properties是（英文/美國）

  • etc.


    在這里插入圖片描述

    IDEA工具就提供了很簡(jiǎn)便的自動(dòng)配置功能，如圖，只要點(diǎn)擊新增按鈕，手動(dòng)輸入，各配置文件都會(huì)自動(dòng)生成屬性


    在這里插入圖片描述

    messages.properties：
messages.loginBtnName=登錄~
messages.password=密碼~
messages.rememberMe=記住我~
messages.tip=請(qǐng)登錄~
messages.username=用戶名~

messages_zh_CN.properties：

messages.loginBtnName=登錄
messages.password=密碼
messages.rememberMe=記住我
messages.tip=請(qǐng)登錄
messages.username=用戶名

messages_en_US.properties：

messages.loginBtnName=login
messages.password=password
messages.rememberMe=Remember me
messages.tip=Please login in
messages.username=userName

在項(xiàng)目的application.properties修改默認(rèn)配置，讓SpringBoot的自動(dòng)配置能讀取到resource bundle資源文件

## 配置i18n
# 默認(rèn)是i18n（中文/中國）
spring.mvc.locale=zh_CN
# 配置resource bundle資源文件的前綴名eg:i18n是文件夾名，messages是資源文件名，支持的符號(hào)有.號(hào)或者/
spring.messages.basename=i18n.messages
# 設(shè)置緩存時(shí)間，2.2.1是s為單位，之前版本才是毫秒
spring.messages.cache-duration=1
# 設(shè)置資源文件編碼格式為utf8
spring.messages.encoding=utf-8

注意要點(diǎn)：

  • spring.messages.basename必須配置，否則SpringBoot的自動(dòng)配置將失效
    MessageSourceAutoConfiguration.ResourceBundleCondition 源碼：
protected static class ResourceBundleCondition extends SpringBootCondition {
        //定義一個(gè)map緩存池
        private static ConcurrentReferenceHashMap<String, ConditionOutcome> cache = new ConcurrentReferenceHashMap<>();

        @Override
        public ConditionOutcome getMatchOutcome(ConditionContext context, AnnotatedTypeMetadata metadata) {
            String basename = context.getEnvironment().getProperty("spring.messages.basename", "messages");
            ConditionOutcome outcome = cache.get(basename);//緩存拿得到，直接從緩存池讀取
            if (outcome == null) {//緩存拿不到，重新讀取
                outcome = getMatchOutcomeForBasename(context, basename);
                cache.put(basename, outcome);
            }
            return outcome;
        }

        private ConditionOutcome getMatchOutcomeForBasename(ConditionContext context, String basename) {
            ConditionMessage.Builder message = ConditionMessage.forCondition("ResourceBundle");
            for (String name : StringUtils.commaDelimitedListToStringArray(StringUtils.trimAllWhitespace(basename))) {
                for (Resource resource : getResources(context.getClassLoader(), name)) {
                    if (resource.exists()) {
                    //匹配resource bundle資源
                        return ConditionOutcome.match(message.found("bundle").items(resource));
                    }
                }
            }
            return ConditionOutcome.noMatch(message.didNotFind("bundle with basename " + basename).atAll());
        }
        //解析資源文件
        private Resource[] getResources(ClassLoader classLoader, String name) {
            String target = name.replace('.', '/');//spring.messages.basename參數(shù)值的點(diǎn)號(hào)換成斜桿
            try {
                return new PathMatchingResourcePatternResolver(classLoader)
                        .getResources("classpath*:" + target + ".properties");
            }
            catch (Exception ex) {
                return NO_RESOURCES;
            }
        }

    }

  • cache-duration在2.2.1版本，指定的是s為單位，找到SpringBoot的MessageSourceAutoConfiguration自動(dòng)配置類


    在這里插入圖片描述

3、LocaleResolver類

SpringBoot默認(rèn)采用AcceptHeaderLocaleResolver類作為默認(rèn)LocaleResolver，LocaleResolver類的作用就是作為i18n的分析器，獲取對(duì)應(yīng)的i18n配置，當(dāng)然也可以自定義LocaleResolver類


import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.lang.Nullable;
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;

/**
 * <pre>
 *  自定義LocaleResolver類
 * </pre>
 * @author nicky
 * <pre>
 * 修改記錄
 *    修改后版本:     修改人：  修改日期: 2019年11月23日  修改內(nèi)容:
 * </pre>
 */
public class CustomLocalResolver implements LocaleResolver {

    Logger LOG = LoggerFactory.getLogger(this.getClass());

    @Nullable
    private Locale defaultLocale;

    public void setDefaultLocale(@Nullable Locale defaultLocale) {
        this.defaultLocale = defaultLocale;
    }

    @Nullable
    public Locale getDefaultLocale() {
        return this.defaultLocale;
    }

    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        Locale defaultLocale = this.getDefaultLocale();//獲取application.properties默認(rèn)的配置
        if(defaultLocale != null && request.getHeader("Accept-Language") == null) {
            return defaultLocale;//http請(qǐng)求頭沒獲取到Accept-Language才采用默認(rèn)配置
        } else {//request.getHeader("Accept-Language")獲取得到的情況
            Locale requestLocale = request.getLocale();//獲取request.getHeader("Accept-Language")的值
            String localeFlag = request.getParameter("locale");//從URL獲取的locale值
            //LOG.info("localeFlag:{}",localeFlag);
            //url鏈接有傳locale參數(shù)的情況，eg:zh_CN
            if (!StringUtils.isEmpty(localeFlag)) {
                String[] split = localeFlag.split("_");
                requestLocale = new Locale(split[0], split[1]);
            }
            //沒傳的情況，默認(rèn)返回request.getHeader("Accept-Language")的值
            return requestLocale;
        }
    }

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

    }
}

4、I18n配置類

I18n還是要繼承WebMvcConfigurer，注意，2.2.1版本才是實(shí)現(xiàn)接口就可以，之前1.+版本是要實(shí)現(xiàn)WebMvcConfigurerAdapter適配器類的

import com.example.springboot.i18n.component.CustomLocalResolver;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.web.servlet.WebMvcProperties;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;

/**
 * <pre>
 *  I18nConfig配置類
 * </pre>
 * <p>
 * <pre>
 * @author nicky.ma
 * 修改記錄
 *    修改后版本:     修改人：  修改日期: 2019/11/24 11:15  修改內(nèi)容:
 * </pre>
 */
 //Configuration必須加上，不然不能加載到Spring容器
@Configuration
//使WebMvcProperties配置類可用，這個(gè)可以不加上，本博客例子才用
@EnableConfigurationProperties({ WebMvcProperties.class})
public class I18nConfig implements WebMvcConfigurer{
    
    //裝載WebMvcProperties 屬性
    @Autowired
    WebMvcProperties webMvcProperties;
    /**
     * 定義SessionLocaleResolver
     * @Author nicky.ma
     * @Date 2019/11/24 13:52
     * @return org.springframework.web.servlet.LocaleResolver
     */
//    @Bean
//    public LocaleResolver localeResolver() {
//        SessionLocaleResolver sessionLocaleResolver = new SessionLocaleResolver();
//        // set default locale
//        sessionLocaleResolver.setDefaultLocale(Locale.US);
//        return sessionLocaleResolver;
//    }

    /**
     * 定義CookieLocaleResolver
     * @Author nicky.ma
     * @Date 2019/11/24 13:51
     * @return org.springframework.web.servlet.LocaleResolver
     */
//    @Bean
//    public LocaleResolver localeResolver() {
//        CookieLocaleResolver cookieLocaleResolver = new CookieLocaleResolver();
//        cookieLocaleResolver.setCookieName("Language");
//        cookieLocaleResolver.setCookieMaxAge(1000);
//        return cookieLocaleResolver;
//    }

    /**
     * 自定義LocalResolver
     * @Author nicky.ma
     * @Date 2019/11/24 13:45
     * @return org.springframework.web.servlet.LocaleResolver
     */
    @Bean
    public LocaleResolver localeResolver(){
        CustomLocalResolver localResolver = new CustomLocalResolver();
        localResolver.setDefaultLocale(webMvcProperties.getLocale());
        return localResolver;
    }

    /**
     * 定義localeChangeInterceptor
     * @Author nicky.ma
     * @Date 2019/11/24 13:45
     * @return org.springframework.web.servlet.i18n.LocaleChangeInterceptor
     */
    @Bean
    public LocaleChangeInterceptor localeChangeInterceptor(){
        LocaleChangeInterceptor localeChangeInterceptor = new LocaleChangeInterceptor();
        //默認(rèn)的請(qǐng)求參數(shù)為locale，eg: login?locale=zh_CN
        localeChangeInterceptor.setParamName(LocaleChangeInterceptor.DEFAULT_PARAM_NAME);
        return localeChangeInterceptor;
    }

    /**
     * 注冊(cè)攔截器
     * @Author nicky.ma
     * @Date 2019/11/24 13:47
     * @Param [registry]
     * @return void
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
     registry.addInterceptor(localeChangeInterceptor()).addPathPatterns("/**");
    }
}

注意要點(diǎn)：

  • 舊版代碼可以不加LocaleChangeInterceptor 攔截器，2.2.1版本必須通過攔截器
  • 如下代碼，bean的方法名必須為localeResolver，否則會(huì)報(bào)錯(cuò)
@Bean
    public LocaleResolver localeResolver(){
        CustomLocalResolver localResolver = new CustomLocalResolver();
        localResolver.setDefaultLocale(webMvcProperties.getLocale());
        return localResolver;
    }

原理：
跟一下源碼，點(diǎn)進(jìn)LocaleChangeInterceptor類


在這里插入圖片描述

在這里插入圖片描述

DispatcherServlet是Spring一個(gè)很重要的分發(fā)器類，在DispatcherServlet的一個(gè)init方法里找到這個(gè)LocaleResolver的init方法
在這里插入圖片描述

這個(gè)IOC獲取的bean類名固定為localeResolver，寫例子的時(shí)候，我就因?yàn)楦牧薭ean類名，導(dǎo)致一直報(bào)錯(cuò)，跟了源碼才知道Bean類名要固定為localeResolver
在這里插入圖片描述

拋異常的時(shí)候，也是會(huì)獲取默認(rèn)的LocaleResolver的

在這里插入圖片描述
在這里插入圖片描述
在這里插入圖片描述

找到資源文件，確認(rèn)，還是默認(rèn)為AcceptHeaderLocaleResolver


在這里插入圖片描述

配置了locale屬性的時(shí)候，還是選用AcceptHeaderLocaleResolver作為默認(rèn)的LocaleResolver

spring.mvc.locale=zh_CN

WebMvcAutoConfiguration.localeResolver方法源碼，ConditionalOnMissingBean主鍵的意思是LocaleResolver沒有自定義的時(shí)候，才作用，ConditionalOnProperty的意思，有配了屬性才走這里的邏輯


在這里插入圖片描述
  • 攔截器攔截的請(qǐng)求參數(shù)默認(rèn)為locale，要使用其它參數(shù)，必須通過攔截器設(shè)置 ,eg：localeChangeInterceptor.setParamName("lang");
    在這里插入圖片描述
  • LocalResolver種類有：CookieLocaleResolver(Cookie)、SessionLocaleResolver(會(huì)話)、FixedLocaleResolver、AcceptHeaderLocaleResolver(默認(rèn))、.etc

5、Thymeleaf集成

本博客的模板引擎采用Thymeleaf的，所以新增項(xiàng)目時(shí)候就要加上maven相關(guān)依賴，沒有的話，自己加上：

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

ok，然后去找個(gè)bootstrap的登錄頁面，本博客已尚硅谷老師的例子為例，進(jìn)行拓展，引入靜態(tài)資源文件：


在這里插入圖片描述

Thymeleaf的i18n支持是采用#符號(hào)的

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
        <meta name="description" content="">
        <meta name="author" content="">
        <title>SpringBoot i18n example</title>
        <!-- Bootstrap core CSS -->
        <link href="asserts/css/bootstrap.min.css" th:href="@{asserts/css/bootstrap.min.css}" rel="stylesheet">
        <!-- Custom styles for this template -->
        <link href="asserts/css/signin.css" th:href="@{asserts/css/signin.css}" rel="stylesheet">
    </head>

    <body class="text-center">
        <form class="form-signin" action="dashboard.html">
            <img class="mb-4" th:src="@{asserts/img/bootstrap-solid.svg}" alt="" width="72" height="72">
            <h1 class="h3 mb-3 font-weight-normal" th:text="#{messages.tip}">Please sign in</h1>
            <label class="sr-only" th:text="#{messages.username}">Username</label>
            <input type="text" class="form-control" th:placeholder="#{messages.username}" required="" autofocus="">
            <label class="sr-only" th:text="#{messages.password} ">Password</label>
            <input type="password" class="form-control" th:placeholder="#{messages.password}" required="">
            <div class="checkbox mb-3">
                <label>
          <input type="checkbox" value="remember-me" > [[#{messages.rememberMe}]]
        </label>
            </div>
            <button class="btn btn-lg btn-primary btn-block" type="submit" th:text="#{messages.loginBtnName}">Sign in</button>
            <p class="mt-5 mb-3 text-muted">? 2019</p>
            <a class="btn btn-sm" th:href="@{/login(locale='zh_CN')} ">中文</a>
            <a class="btn btn-sm" th:href="@{/login(locale='en_US')} ">English</a>
        </form>

    </body>

</html>

切換中文網(wǎng)頁：


在這里插入圖片描述

切換英文網(wǎng)頁：


在這里插入圖片描述

當(dāng)然不點(diǎn)鏈接傳locale的方式也是可以自動(dòng)切換的，瀏覽器設(shè)置語言：


在這里插入圖片描述

原理localeResolver類會(huì)獲取Accept language參數(shù)


在這里插入圖片描述

附錄：
logging manual：SpringBoot官方手冊(cè)
example source：例子代碼下載鏈接

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容