SpringMVC國際化（i18n）（五）
阿新 • • 發佈：2019-01-07
國際化我們通常用縮寫來簡單，那就是i18n。它就是讓我們的系統可以轉換成不同的語言。為了轉換成不同的言語，我們需要定義不同的檔案，如：messages_en.properties,messages_en_US.properties,messages_fr.properties。我想聰明的你，可以看出他們之間的定義格式了。(如果，讀者在定義這些檔案後，系統沒有實現國際化，那麼可以將系統預設的語言檔案直接用messages.peoperties.)
1. 新增配置檔案
接下來，我們要做的事就是轉換我們的資訊，筆者這裡對英語的語言就沒有定義為message_en_US.properties檔案，而是直接用messages.properties,因為英語就是作為系統的預設語言。messages.properties的配置資訊如下：
Size.profileForm.twitterHandle=Please type in your twitter user name Email.profileForm.email=Please specify a valid email address NotEmpty.profileForm.email=Please specify your email address PastLocalDate.profileForm.birthDate=Please specify a real birth date NotNull.profileForm.birthDate=Please specify your birth date typeMismatch.birthDate = Invalid birth date format. NotEmpty.profileForm.tastes=Please enter at least one thing profile.title=Your profile twitter.handle=Twitter handle email=Email birthdate=Birth Date tastes.legend=What do you like? remove=Remove taste.placeholder=Enter a keyword add.taste=Add taste submit=Submit
對於法語，讀者可以用翻譯的軟體來翻譯。檔案是messages_fr.properties
Email.profileForm.email=Veuillez spécifier une adresse mail valide NotEmpty.profileForm.email=Veuillez spécifier votre adresse mail PastLocalDate.profileForm.birthDate=Veuillez donner votre vraie date de naissance NotNull.profileForm.birthDate=Veuillez spécifier votre date de naissance typeMismatch.birthDate = Date de naissance invalide. NotEmpty.profileForm.tastes=Veuillez saisir au moins une chose profile.title=Votre profil twitter.handle=Pseudo twitter email=Email birthdate=Date de naissance tastes.legend=Quels sont vos go?ts ? remove=Supprimer taste.placeholder=Entrez un mot-clé add.taste=Ajouter un centre d'intérêt submit=Envoyer
2.改變本地語言
在我們的程式中，使用者使用系統是跟自己本地相關係的。我們會Session中儲存使用者的個人資訊。我們應該要允許使用者去改變自己的本地語言。所以我們要使用SessionLocaleResolver.讓我們修改WebConfiguration：
package masterSpringMVC.config;
import masterSpringMVC.date.USLocalDateFormatter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;
import org.springframework.web.servlet.i18n.SessionLocaleResolver;
import java.time.LocalDate;
import java.util.Locale;
/**
* 定製SpringMVC的配置（如：日期、語言等）
* 有點類似於Spring的xml的檔案配置
* 可以新增需要用的Bean,還有攔截器、事務控制等
* Created by OwenWilliam on 2016/5/15.
*/
@Configuration
public class WebConfiguration extends WebMvcConfigurerAdapter {
/**
*格式轉換處理
* @param registry
*/
@Override
public void addFormatters(FormatterRegistry registry) {
registry.addFormatterForFieldType(LocalDate.class, new USLocalDateFormatter());
}
/**
* 從HTTP的請求地址中找到所屬於的國家
* @return
*/
@Bean
public LocaleResolver localeResolver()
{
return new SessionLocaleResolver();
}
/**
* 攔截器：攔截請求的地址
* @return
*/
@Bean
public LocaleChangeInterceptor localeChangeInterceptor()
{
LocaleChangeInterceptor localeChangeInterceptor = new LocaleChangeInterceptor();
//在攔截的地址後面新增？lang=xx。如： http://localhost:8080/profile?lang=fr
localeChangeInterceptor.setParamName("lang");
return localeChangeInterceptor;
}
/**
* 註冊攔截器
* @param registry
*/
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(localeChangeInterceptor());
}
}
在上面的程式碼中，細心的你已經清單到了newSessionLocaleResolver()。其實這個是LocaleResolver的介面。其實LocaleResolver的介面有如下幾個：
1) FixedLocaleResolver: 這修復了配置中定義的區域設定,一旦這個被定義了就不能修改。
2) CookiesLocaleResolver:這個允許將相關的資訊檢索和儲存到本地的cookie中。
3) SessionLocaleResolver:這個作用域就是在HTTPsession中。
3.檢視層修改
1) 我們需要在檢視的profilePage的頁面中新增可能更換語言的控制元件，這個不僅僅是用在這個頁面上，同時也是公用部分，所以我們新增到layout的頁面。修改之後的頁面如下：
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout">
<head>
<meta http-equiv="Content-Type" content="text/html" charset="UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1.0, user-scalable=no"/>
<title>Default title</title>
<link href="/webjars/materializecss/0.96.0/css/materialize.css"
type="text/css" rel="stylesheet" media="screen,projection"/>
</head>
<body>
<ul id="lang-dropdown" class="dropdown-content">
<li><a href="?lang=en_US">English</a></li>
<li><a href="?lang=fr">French</a></li>
</ul>
<nav>
<div class="nav-wrapper indigo">
<ul class="right">
<li>
<a class="dropdown-button" href="#!" data-activates="lang-dropdown">
<i class="mdi-action-language right"></i>Lang
</a>
</li>
</ul>
</div>
</nav>
<section layout:fragment="content">
<p>Page content goes here</p>
</section>
<script src="/webjars/jquery/2.1.4/jquery.js"></script>
<script src="/webjars/materializecss/0.96.0/js/materialize.js"></script>
<script type="text/javascript">
$(".dropdown-button").dropdown();
</script>
<script type="text/javascript" layout:fragment="script">
</script>
</body>
</html>
2) 最後，我們要在檢視的頁面上用到國際化，我們用到的EL表達語言是#{}.
檢視下面的程式碼，清單#{}的地方(profilePage.html)。
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
layout:decorator="layout/default">
<head lang="en">
<title>Your profile</title>
</head>
<body>
<div class="row" layout:fragment="content">
<h2 class="indigo-text center" th:text="#{profile.title}">Personal
info</h2>
<form th:action="@{/profile}" th:object="${profileForm}"
method="post" class="col m8 s12 offset-m2">
<div class="row">
<div class="input-field col s6">
<input th:field="${profileForm.twitterHandle}"
id="twitterHandle" type="text" th:errorclass="invalid"/>
<label for="twitterHandle" th:text="#{twitter.
handle}">Twitter handle</label>
<div th:errors="*{twitterHandle}" class="redtext">Error</div>
</div>
<div class="input-field col s6">
<input th:field="${profileForm.email}" id="email"
type="text" th:errorclass="invalid"/>
<label for="email" th:text="#{email}">Email</label>
<div th:errors="*{email}" class="red-text">Error</div>
</div>
</div>
<div class="row">
<div class="input-field col s6">
<input th:field="${profileForm.birthDate}"
id="birthDate" type="text" th:errorclass="invalid"/>
<label for="birthDate" th:text="#{birthdate}" th:place
holder="${dateFormat}">Birth Date</label>
<div th:errors="*{birthDate}" class="red-text">Error</
div>
</div>
</div>
<div class="row s12 center">
<button class="btn indigo waves-effect waves-light"
type="submit" name="save" th:text="#{submit}">Submit
<i class="mdi-content-send right"></i>
</button>
</div>
</form>
</div>
</body>
</html>
4.總結
在這一章節中，我們學習了SpringMVC的國際化是如何配置的。無非不是messages_xx.properties的檔案配置。當然，為了要以通過控制元件來修改，所以我們在webConfiguration中也添加了程式碼。這個地方主要是瀏覽器請求時的地址解析是請求哪一種語言呼叫。如：http://localhost:8080/profile?lang=fr
。最後，我們也不要忘記在檢視層中加入我們國際化檔案資訊。最後執行的結果如下：
原始碼路徑：[email protected]:owenwilliam/masterSpringMVC.git