十八、Spring Boot處理國際化資源

1、Spring應(yīng)用程序處理國際化資源的步驟：

1）、編寫國際化配置文件；

2）、使用ResourceBundleMessageSource管理國際化資源文件；

3）、在頁面使用fmt:message取出國際化內(nèi)容。

2、Spring Boot處理國際化資源步驟：

1）、編寫國際化配置文件，抽取頁面中需要進(jìn)行顯示的國際化信息。

國際化預(yù)定義屬性.png

2）、Spring Boot自動(dòng)配置了管理國際化資源文件的組件：

@Configuration
@ConditionalOnMissingBean(value = MessageSource.class, search = SearchStrategy.CURRENT)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE)
@Conditional(ResourceBundleCondition.class)
@EnableConfigurationProperties
@ConfigurationProperties(prefix = "spring.messages")
public class MessageSourceAutoConfiguration {
    
    /**
     * Comma-separated list of basenames (essentially a fully-qualified classpath
     * location), each following the ResourceBundle convention with relaxed support for
     * slash based locations. If it doesn't contain a package qualifier (such as
     * "org.mypackage"), it will be resolved from the classpath root.
     */
    private String basename = "messages";
    
    //other code...
    
    @Bean
    public MessageSource messageSource() {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        if (StringUtils.hasText(this.basename)) {
            //設(shè)置國際化資源文件的基礎(chǔ)名
            messageSource.setBasenames(StringUtils.commaDelimitedListToStringArray(
                    StringUtils.trimAllWhitespace(this.basename)));
        }
        if (this.encoding != null) {
            messageSource.setDefaultEncoding(this.encoding.name());
        }
        messageSource.setFallbackToSystemLocale(this.fallbackToSystemLocale);
        messageSource.setCacheSeconds(this.cacheSeconds);
        messageSource.setAlwaysUseMessageFormat(this.alwaysUseMessageFormat);
        return messageSource;
    }
}

默認(rèn)情況下，國際化資源文件的基礎(chǔ)名為messages，且存放在classpath根路徑下，即messages.properties、messages_zh_CN.properties、messages_en_US.properties等等，這樣就無需在配置文件中設(shè)置spring.messages.basename=...了，但是如果基礎(chǔ)名不為messages或者不在classpath根路徑下，則需要手動(dòng)添加spring.messages.basename=文件名.自定義的基礎(chǔ)名，如果有多個(gè)就用逗號分隔。例如：

spring.messages.basename=i18n.login

3）、去頁面獲取國際化的值：

<!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>Signin Template for Bootstrap</title>
        <!-- Bootstrap core CSS -->
        <link href="asserts/css/bootstrap.min.css" th:href="@{/webjars/bootstrap/4.1.0/css/bootstrap.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}" src="asserts/img/bootstrap-solid.svg" alt="" width="72" height="72">
            <h1 class="h3 mb-3 font-weight-normal" th:text="#{login.tip}">Please sign in</h1>
            <label class="sr-only" th:text="#{login.username}">Username</label>
            <input type="text" class="form-control" placeholder="Username" th:placeholder="#{login.username}" required="" autofocus="">
            <label class="sr-only" th:text="#{login.password}">Password</label>
            <input type="password" class="form-control" placeholder="Password" th:placeholder="#{login.password}" required="">
            <div class="checkbox mb-3">
                <label>
                                      <input type="checkbox" value="remember-me"> [[#{login.rememberme}]]
                                </label>
            </div>
            <button class="btn btn-lg btn-primary btn-block" type="submit" th:text="#{login.signin}">Sign in</button>
            <p class="mt-5 mb-3 text-muted">? 2017-2018</p>
            <a class="btn btn-sm">中文</a>
            <a class="btn btn-sm">English</a>
        </form>
    </body>
</html>

效果：根據(jù)瀏覽器語言設(shè)置的語言信息進(jìn)行切換國際化語言。

4）、如何通過鏈接切換國際化語言？

原理：

國際化區(qū)域信息對象Locale，有個(gè)區(qū)域信息對象處理器LocaleResolver，在WebMvcAutoConfiguration自動(dòng)配置類中配置了一個(gè)LocaleResolver的Bean。

@Bean
@ConditionalOnMissingBean
@ConditionalOnProperty(prefix = "spring.mvc", name = "locale")
public LocaleResolver localeResolver() {
    if (this.mvcProperties
        .getLocaleResolver() == WebMvcProperties.LocaleResolver.FIXED) {
        return new FixedLocaleResolver(this.mvcProperties.getLocale());
    }
    AcceptHeaderLocaleResolver localeResolver = new AcceptHeaderLocaleResolver();
    localeResolver.setDefaultLocale(this.mvcProperties.getLocale());
    return localeResolver;
}
  • 如果在配置文件中配置了spring.mvc.locale-resolver=fixed，且指定了spring.mvc.locale的值，則頁面使用的是指定且固定的國際語言（FixedLocaleResolver）；
  • spring.mvc.locale-resolver默認(rèn)為accept-header，即通過瀏覽器請求頭中的Accept-Language 作為判斷依據(jù)（AcceptHeaderLocaleResolver）：
public class AcceptHeaderLocaleResolver implements LocaleResolver {
    
    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        Locale defaultLocale = getDefaultLocale();
        if (defaultLocale != null && request.getHeader("Accept-Language") == null) {
            return defaultLocale;
        }
        Locale requestLocale = request.getLocale();
        List<Locale> supportedLocales = getSupportedLocales();
        if (supportedLocales.isEmpty() || supportedLocales.contains(requestLocale)) {
            return requestLocale;
        }
        Locale supportedLocale = findSupportedLocale(request, supportedLocales);
        if (supportedLocale != null) {
            return supportedLocale;
        }
        return (defaultLocale != null ? defaultLocale : requestLocale);
    }
    
    //other code..
}

使用鏈接切換國際化語言的步驟：只需覆蓋默認(rèn)的LocaleResolver對象

i）、編寫一個(gè)自定義的LocaleResolver類：

//使用鏈接的方法發(fā)送國際語言代碼
public class MyLocaleResolver  implements LocaleResolver{

    private final Logger logger = LoggerFactory.getLogger(MyLocaleResolver.class);

    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        String lan = request.getParameter("lan");
        Locale locale = Locale.getDefault();
        if(StringUtils.hasText(lan)){
            try{
                String[] split = lan.split("_");
                locale = new Locale(split[0], split[1]);
            }catch (Exception e){
                e.printStackTrace();
                logger.error("錯(cuò)誤信息:", e);
            }
        }
        return locale;
    }

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

    }
}

先從請求參數(shù)中獲取lan數(shù)據(jù)，然后通過下劃線分割成語言和國家，然后通過語言和國家來封裝成一個(gè)Locale對象并返回，如果未指定lan參數(shù)，則默認(rèn)使用default的Locale對象。

? ii）、修改頁面切換語言的鏈接，添加國際化語言代碼：

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

? iii）、將自定義的LocaleResolver覆蓋默認(rèn)的LocaleResolver：

@Configuration
public class MyMvcConfig extends WebMvcConfigurerAdapter{

    //使用自定義的LocaleResolver來替換掉默認(rèn)的LocaleResolver
    @Bean
    public LocaleResolver localeResolver(){
        return new MyLocaleResolver();
    }
    //other code...
}

? 這樣配置了自定義的LocaleResolver對象就會(huì)把WebMvcAutoConfiguration自動(dòng)配置類中預(yù)定義的LocaleResolver的Bean屏蔽掉，Spring Boot就會(huì)使用自定義的LocaleResolver對象。

注意：一旦使用鏈接來切換國際化語言，則會(huì)導(dǎo)致通過瀏覽器語言切換國際化語言的功能失效了。

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

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

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