最近在網上找了一個有關賬單管理的spring boot項目，其中有一部分是涉及顯示國際化信息的，即將頁面上的中英文進行轉換。因為在這之前這部分內容沒有接觸過，所以在這記錄下過程。
中文效果圖如下所示：
英文效果圖如下所示：
從上面兩幅圖可以看出在切換中英文時有五個部分的內容發送改變。分別是：用戶名（Username）、密碼（Password）、記住我（Remember Me）、登錄（Sign）、重置（Rest）。
第一部分、先在resources目錄下新建一個i18n文件夾，並在該文件夾下新建一個Resource Bundle.如下圖所示：
並在跳出的彈框內寫入以下信息：
點擊“OK”后就會在i18n目錄下生成3個后綴名為“.properties”的文件。如下所示：
第二部分、分別在這三個文件中填入相應信息。
login.properties表示默認顯示的信息。login.password、login.remember、login.reset、login.submit、login.username是自己設置的key值，用於在HTML中顯示。后面的是將要顯示的內容。
1 login.password=密碼 2 login.remember=記住我 3 login.reset=重置 4 login.submit=登錄 5 login.username=用戶名
login_en_US.properties
1 login.password=Password 2 login.remember=Remember Me 3 login.reset=Rest 4 login.submit=Sign 5 login.username=Username
login_zh_CN.properties
1 login.password=密碼 2 login.remember=記住我 3 login.reset=重置 4 login.submit=登錄 5 login.username=用戶名
第三部分、在HTML相應位置填入key值，並在點擊“中文”或“English”發出不同請求信息。
注意：在這個項目中使用的模板是thymeleaf，因此需要現在開始的html標簽內引入該模板的標簽。
根據thymeleaf的文檔
顯示國際化信息時用到的“#{}”而不是"${}"。
由於這個“記住我”是<input>單標簽的沒有標簽體，根據thymeleaf文檔發現需要使用"[[#{}]]"或“[(#{})]”行內表達式。
當點擊“中文”時附帶請求信息“zh_CN”，點擊英文時附帶請求信息“en_US”.
login.html代碼如下所示：
1 <!DOCTYPE html> 2 <html xmlns:th="http://www.thymeleaf.org"> 3 <head lang="en" th:replace="main/public :: #public_head"> 4 5 </head> 6 <body class="login_bg"> 7 <section class="loginBox"> 8 <header class="loginHeader"> 9 <h1>輕舟萬里賬單管理系統</h1> 10 </header> 11 <section class="loginCont"> 12 <!--<div style="color:red; margin-left: 130px">用戶名錯誤！</div>--> 13 <form class="loginForm" action="../main/index.html"> 14 15 <div class="inputbox"> 16 <label for="user" th:text="#{login.username}">Username</label> 17 <input id="user" type="text" name="username" required/> 18 </div> 19 <div class="inputbox"> 20 <label for="mima" th:text="#{login.password}">Password</label> 21 <input id="mima" type="password" name="password" required/> 22 </div> 23 <div class="subBtn"> 24 <input type="checkbox"> [[#{login.remember}]] 25 </div> 26 <br/> 27 <div class="subBtn"> 28 <input type="submit" th:value="#{login.submit}" value="Sign" /> 29 <input type="reset" th:value="#{login.reset}" value="Reset"/> 30 </div> 31 <br/> 32 <div style="margin-left: 100px;"> 33 <a href="#" th:href="@{/index.html(l='zh_CN')}">中文</a> 34 35 <a href="" th:href="@{/index.html(l='en_US')}">English</a> 36 </div> 37 </form> 38 </section> 39 </section> 40 </body> 41 </html>
第四部分、設置區域解析器
在頁面上顯示中文還是英文是由請求信息頭中“accept-language”的決定的，默認是中文。我們只要將點擊所附帶的請求信息傳遞給“accept-language”就會使頁面的中英文改變。
spring boot中有一個WebMvcAutoConfiguration類，提供了本地區域解析器。如下圖所示：
該本地區域解析器上有個注解@ConditionalOnMissingBean表示如果容器中沒有這個bean，就將這個bean放到容器中，如果有就使用已經存在的。
從下面的代碼片段中可以看到有一個請求頭本地區域解析器AcceptHeaderLocaleResolver實現了LocaleResolver接口。
因此我們可以在component包下新建一個自定義區域解析器MyLocaleResolver，該類需要實現接口LocaleResolver，重寫方法，根據請求的參數構造一個Local返回。
1 package club.nipengfei.springboot.component; 2 3 import org.springframework.web.servlet.LocaleResolver; 4 import org.thymeleaf.util.StringUtils; 5 6 import javax.servlet.http.HttpServletRequest; 7 import javax.servlet.http.HttpServletResponse; 8 import java.util.Locale; 9 10 /** 11 * 自定義區域解析器 12 */ 13 public class MyLocaleResolver implements LocaleResolver { 14 @Override 15 public Locale resolveLocale(HttpServletRequest httpServletRequest) { 16 // 獲取自定義請求頭信息 17 String l = httpServletRequest.getParameter("l"); 18 // 獲取系統默認的區域信息 19 Locale locale = Locale.getDefault(); 20 if (!StringUtils.isEmpty(l)){ 21 String[] split = l.split("_"); 22 // 接收第一個參數為語言代碼，第二個參數為國家代碼 23 locale = new Locale(split[0],split[1]); 24 } 25 return locale; 26 } 27 28 @Override 29 public void setLocale(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Locale locale) { 30 31 } 32 }
將其添加到容器中，在config包下新建一個MySpringMvcConfigure，在該類的localeResolver方法中返回LocaleResolver，注意使用注解@Bean。代碼如下所示：
1 package club.nipengfei.springboot.config; 2 3 import club.nipengfei.springboot.component.MyLocaleResolver; 4 import org.springframework.context.annotation.Bean; 5 import org.springframework.context.annotation.Configuration; 6 import org.springframework.web.servlet.LocaleResolver; 7 import org.springframework.web.servlet.config.annotation.ViewControllerRegistry; 8 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; 9 10 @Configuration 11 public class MySpringMvcConfigure { 12 13 @Bean 14 public WebMvcConfigurer webMvcConfigurer(){ 15 return new WebMvcConfigurer() { 16 17 // 添加視圖控制器 18 @Override 19 public void addViewControllers(ViewControllerRegistry registry) { 20 21 registry.addViewController("/").setViewName("/main/login"); 22 registry.addViewController("/index.html").setViewName("/main/login"); 23 } 24 }; 25 } 26 27 // 區域解析器 28 @Bean 29 public LocaleResolver localeResolver(){ 30 return new MyLocaleResolver(); 31 } 32 }
第五部分、在這過程中遇到的問題。
- 中英文顯示亂碼，解決方法是修改properties文件編碼，改為UTF-8。參考：解決 IntelliJ IDEA 中 i18n國際化 中文亂碼問題。
- 無法訪問到login頁面，因為login.html頁面在template/main目錄下。解決方法是添加視圖控制器。