Springboot?Thymeleaf如何配置國(guó)際化頁(yè)面

本文小編為大家詳細(xì)介紹“Springboot Thymeleaf如何配置國(guó)際化頁(yè)面”，內(nèi)容詳細(xì)，步驟清晰，細(xì)節(jié)處理妥當(dāng)，希望這篇“Springboot Thymeleaf如何配置國(guó)際化頁(yè)面”文章能幫助大家解決疑惑，下面跟著小編的思路慢慢深入，一起來(lái)學(xué)習(xí)新知識(shí)吧。

1．編寫(xiě)多語(yǔ)言國(guó)際化配置文件

在項(xiàng)目的類路徑resources下創(chuàng)建名稱為i18n的文件夾，并在該文件夾中根據(jù)需要編寫(xiě)對(duì)應(yīng)的多語(yǔ)言國(guó)際化文件login.properties、login_zh_CN.properties和login_en_US.properties文件

login.properties

login.tip=請(qǐng)登錄
login.username=用戶名
login.password=密碼
login.rememberme=記住我
login.button=登錄

login_zh_CN.properties

login.tip=請(qǐng)登錄
login.username=用戶名
login.password=密碼
login.rememberme=記住我
login.button=登錄

login_en_US.properties

login.tip=Please sign in
login.username=Username
login.password=Password
login.rememberme=Remember me
login.button=Login

login.properties為自定義默認(rèn)語(yǔ)言配置文件，login_zh_CN.properties為自定義中文國(guó)際化文件，login_en_US.properties為自定義英文國(guó)際化文件

需要說(shuō)明的是，Spring Boot默認(rèn)識(shí)別的語(yǔ)言配置文件為類路徑resources下的messages.properties；其他語(yǔ)言國(guó)際化文件的名稱必須嚴(yán)格按照“文件前綴名語(yǔ)言代碼國(guó)家代碼.properties”的形式命名

本示例中，在項(xiàng)目類路徑resources下自定義了一個(gè)i18n包用于統(tǒng)一配置管理多語(yǔ)言配置文件，并將項(xiàng)目默認(rèn)語(yǔ)言配置文件名自定義為login.properties，因此，后續(xù)還必須在項(xiàng)目全局配置文件中進(jìn)行國(guó)際化文件基礎(chǔ)名配置，才能引用自定義國(guó)際化文件

2．編寫(xiě)配置文件

打開(kāi)項(xiàng)目的application.properties全局配置文件，在該文件中添加國(guó)際化文件基礎(chǔ)名設(shè)置，內(nèi)容如文件

# 配置國(guó)際化文件基礎(chǔ)名
spring.messages.basename=i18n.login

spring.messages.basename=i18n.login”設(shè)置了自定義國(guó)際化文件的基礎(chǔ)名。其中，i18n表示國(guó)際化文件相對(duì)項(xiàng)目類路徑resources的位置，login表示多語(yǔ)言文件的前綴名。如果開(kāi)發(fā)者完全按照Spring Boot默認(rèn)識(shí)別機(jī)制，在項(xiàng)目類路徑resources下編寫(xiě)messages.properties等國(guó)際化文件，可以省略國(guó)際化文件基礎(chǔ)名的配置

3．定制區(qū)域信息解析器

在完成上一步中多語(yǔ)言國(guó)際化文件的編寫(xiě)和配置后，就可以正式在前端頁(yè)面中結(jié)合Thymeleaf模板相關(guān)屬性進(jìn)行國(guó)際化語(yǔ)言設(shè)置和展示了，不過(guò)這種實(shí)現(xiàn)方式默認(rèn)是使用請(qǐng)求頭中的語(yǔ)言信息（瀏覽器語(yǔ)言信息）自動(dòng)進(jìn)行語(yǔ)言切換的，有些項(xiàng)目還會(huì)提供手動(dòng)語(yǔ)言切換的功能，這就需要定制區(qū)域解析器了

在項(xiàng)目中創(chuàng)建名為com.lagou.config的包，并在該包下創(chuàng)建一個(gè)用于定制國(guó)際化功能區(qū)域信息解析器的自定義配置類MyLocalResovel

package com.lagou.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 javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;
@Configuration
public class MyLocalResolver implements LocaleResolver {
    // 完成自定義 區(qū)域解析方式
    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        // 獲取頁(yè)面手動(dòng)傳遞的語(yǔ)言參數(shù)值 : zh_CN   en_US   ""
        String l = request.getParameter("l");
        Locale locale = null;
        if (!StringUtils.isEmpty(l)) {
            // 如果參數(shù)不為空，就根據(jù)參數(shù)值，進(jìn)行手動(dòng)語(yǔ)言切換
            String[] s = l.split("_");
            locale = new Locale(s[0], s[1]);
        } else {
            // Accept-Language: zh-CN,zh;q=0.9
            String header = request.getHeader("Accept-Language");
            String[] split = header.split(",");
            String[] split1 = split[0].split("-");
            locale = new Locale(split1[0], split1[1]);
        }
        return locale;
    }
    @Override
    public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {
    }
    // 將自定義的LocaleResolver重新注冊(cè)成一個(gè)類型為L(zhǎng)ocaleResolver的Bean組件
    @Bean
    public LocaleResolver localeResolver() {
        return new MyLocalResolver();
    }
}

MyLocalResolver自定義區(qū)域解析器配置類實(shí)現(xiàn)了LocaleResolver接口，并重寫(xiě)了其中的resolveLocale()方法進(jìn)行自定義語(yǔ)言解析，最后使用@Bean注解將當(dāng)前配置類注冊(cè)成Spring容器中的一個(gè)類型為L(zhǎng)ocaleResolver的Bean組件，這樣就可以覆蓋默認(rèn)的LocaleResolver組件。其中，在resolveLocale()方法中，根據(jù)不同需求（手動(dòng)切換語(yǔ)言信息、瀏覽器請(qǐng)求頭自動(dòng)切換語(yǔ)言信息）分別獲取了請(qǐng)求參數(shù)l和請(qǐng)求頭參數(shù)Accept-Language，然后在請(qǐng)求參數(shù)l不為空的情況下就以l參數(shù)攜帶的語(yǔ)言為標(biāo)準(zhǔn)進(jìn)行語(yǔ)言切換，否則就定制通過(guò)請(qǐng)求頭信息進(jìn)行自動(dòng)切換。

需要注意的是，在請(qǐng)求參數(shù)l的語(yǔ)言手動(dòng)切換組裝時(shí)，使用的是下劃線“_”進(jìn)行的切割，這是由多語(yǔ)言配置文件的格式?jīng)Q定的（例如login_zh_CN.properties）；而在請(qǐng)求頭參數(shù)Accept-Language的語(yǔ)言自動(dòng)切換組裝時(shí)，使用的是短橫線“-”進(jìn)行的切割，這是由瀏覽器發(fā)送的請(qǐng)求頭信息樣式?jīng)Q定的（例如Accept-Language: en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7）

4．頁(yè)面國(guó)際化使用

打開(kāi)項(xiàng)目templates模板文件夾中的用戶登錄頁(yè)面login.html，結(jié)合Thymeleaf模板引擎實(shí)現(xiàn)國(guó)際化功能

<!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,shrinkto-
fit=no">
        <title>用戶登錄界面</title>
        <link th:href="@{/login/css/bootstrap.min.css}" rel="external nofollow"  rel="stylesheet">
        <link th:href="@{/login/css/signin.css}" rel="external nofollow"  rel="stylesheet">
    </head>
    <body class="text-center">
        <!-- 用戶登錄form表單 -->
        <form class="form-signin">
            <img class="mb-4" th:src="@{/login/img/login.jpg}" width="72" height="72">
            <h3 class="h5 mb-3 font-weight-normal" th:text="#{login.tip}">請(qǐng)登錄</h3>
            <input type="text" class="form-control"
                   th:placeholder="#{login.username}" required="" autofocus="">
            <input type="password" class="form-control"
                   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.button}">登錄</button>
            <p class="mt-5 mb-3 text-muted">? <span
                    th:text="${currentYear}">2019</span>-<span
                    th:text="${currentYear}+1">2020</span></p>
            <a class="btn btn-sm" th:href="@{/toLoginPage(l='zh_CN')}" rel="external nofollow" >中文</a> <!--注意這個(gè)路徑是我們controller訪問(wèn)頁(yè)面的路徑，不同的是這次攜帶了參數(shù)，可以幫我們用來(lái)區(qū)分locale-->
            <a class="btn btn-sm" th:href="@{/toLoginPage(l='en_US')}" rel="external nofollow" >English</a>
        </form>
    </body>
</html>

使用Thymeleaf模板的#{}消息表達(dá)式設(shè)置了國(guó)際化展示的部分信息。在對(duì)記住我rememberme國(guó)際化設(shè)置時(shí)，需要國(guó)際化設(shè)置的rememberme在input標(biāo)簽外部，所以這里使用了行內(nèi)表達(dá)式[[#login.rememberme}]]動(dòng)態(tài)獲取國(guó)際化文件中的login.rememberme信息。另外，在表單尾部還提供了中文、English手動(dòng)切換語(yǔ)言的功能鏈接，在單擊鏈接時(shí)會(huì)分別攜帶國(guó)家語(yǔ)言參數(shù)向“/”路徑請(qǐng)求跳轉(zhuǎn)，通過(guò)后臺(tái)定制的區(qū)域解析器進(jìn)行手動(dòng)語(yǔ)言切換。

注：省略了controller控制層處理

5．整合效果測(cè)試

點(diǎn)擊后

單擊“English”鏈接進(jìn)行語(yǔ)言國(guó)際化切換時(shí)攜帶了指定的“l(fā)=zh_CN”參數(shù)，后臺(tái)定制的區(qū)域解析器配置類MyLocalResovel中的解析方法會(huì)根據(jù)定制規(guī)則進(jìn)行語(yǔ)言切換，從而達(dá)到了手動(dòng)切換國(guó)際化語(yǔ)言的效果

讀到這里，這篇“Springboot Thymeleaf如何配置國(guó)際化頁(yè)面”文章已經(jīng)介紹完畢，想要掌握這篇文章的知識(shí)點(diǎn)還需要大家自己動(dòng)手實(shí)踐使用過(guò)才能領(lǐng)會(huì)，如果想了解更多相關(guān)內(nèi)容的文章，歡迎關(guān)注億速云行業(yè)資訊頻道。