1.Spring國際化概述

1）國際化基本規則國際化資訊”也稱為“本地化資訊”，一般需要兩個條件才可以確定一個特定型別的本地化資訊，它們分別是“語言型別”和“國家/地區的型別”。如中文字地化資訊既有中國大陸地區的中文，又有中國臺灣、中國香港地區的中文，還有新加坡地區的中文。Java通過java.util.Locale類表示一個本地化物件，它允許通過語言引數和國家/地區引數建立一個確定的本地化物件。語言引數使用ISO標準語言程式碼表示，這些程式碼是由ISO-639標準定義的，每一種語言由兩個小寫字母表示。在許多網站上都可以找到這些程式碼的完整列表，下面的網址是提供了標準語言程式碼的資訊：http://www.loc.gov/standards/iso639-2/php/English_list.php。2）基本實現流程

2.語言型別判斷

1）基於瀏覽器語言根據Request Headers中的Accept-language來判斷。2）基於客戶端傳參要求客戶端第一次（或者每次）傳遞的自定義引數值來判斷，如規定傳locale，值為zh-cn、en-us等內容，如果只在第一次傳入則local以及timeZone先關資訊要存入session或者cookie中，後面的請求語言方式則直接從兩者中取，其有效時間與session和cookie設定的生命週期關聯。3）基於預設配置當獲取語言型別時沒有找到對應型別時，會使用預設的語言型別。

3.語言型別儲存

<!-- 定義本地化變更攔截器 -->
<
 
bean id="localeChangeInterceptor" class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor" />
<!-- 定義註解URL對映處理器，所有的請求對映關聯本地化攔截器，或者也可自定義該攔截器路徑對映-->
<bean id="urlMapping" class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping">
 <property name
 
="interceptors" ref=" localeChangeInterceptor " />
 <property name="order" value="1"></property>
</bean>

3.1基於url

該種方式需要每次都在請求的url上帶上local引數，指定該次需要的語言型別，並且該方式的local解析器需要配置，如下：

<a href="xxx.do?locale=zh_CN">中文</a>或<a href="xxx.do?locale=en">英文</a>
<bean id="localeResolver" class="org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver"/>

但在該配置下使用會拋Cannot change HTTP accept header - use a different locale resolution strategy異常，這是因為spring source做了限制，無法對本地的local賦值修改，解決辦法如下，新建一個類MyLocaleResolver繼承AcceptHeaderLocaleResolver，重寫resolveLocale和setLocale方法，並將上面的localeResolver的class指向如下MyLocaleResolver類：

public class MyLocaleResolver extends AcceptHeaderLocaleResolver {
 private Locale myLocal;

public Locale resolveLocale(HttpServletRequest request) {
 return myLocal == null ? request.getLocale() : myLocal;
}

public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {
 myLocal = locale;
 }
}

3.2基於session

基於session的狀態儲存方式只需要在第一次請求的時候指定語言型別，localResolver會將該屬性儲存到session中，後面的請求直接從session中獲取該語言型別，該種方式的localResolver對應的類為SessionLocaleResolver，如下配置：

<bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver"/>

該方式的原理圖如下圖所示：

3.3基於cookie

與session的機制類似，差異在於兩者的儲存和週期，鑑於安全、大小以及體驗等因素的影響，實際使用中使用者更傾向於前者，該種cookie儲存方式的localResolver為<bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver" />。

4.文案資料來源

對於語言型別的資原始檔，需要開發者對文案進行蒐集整理，並翻譯成相應的語言確定關鍵字key，目前大多數情況是將這些資訊置於.properties檔案中，在使用的時候直接訪問獲取，當然也可置於資料庫中，但頻繁的文案獲取會影響伺服器效能及產品體驗，可結合資料字典以及快取工具使用。

4.1資料庫（示例）

1）spring 配置方式

<!-- 預設的註解對映的支援 -->
<mvc:annotation-driven validator="validator" conversion-service="conversionService" />
<!-- 資原始檔 -->
<bean id="propertiesMessageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
 <property name="basenames">
 <list>
 <value>resource</value>
 <value>validation</value>
 </list>
 </property>
</bean>

<bean id="databaseMessageSource" class="com.obs2.util.MessageResource">
 <property name="parentMessageSource" ref="propertiesMessageSource"/>
</bean>

<bean id="messageInterpolator" class="com.obs2.util.MessageResourceInterpolator">
 <property name="messageResource" ref="databaseMessageSource"/>
</bean>

<!-- 驗證器 -->
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
 <property name="messageInterpolator" ref="messageInterpolator"/>
</bean>

這裡定義了一個propertiesMessageSource，一個databaseMessageSourcer，和一個messageInterpolator。propertiesMessageSource用於讀取properties檔案databaseMessageSourcer用於讀取資料庫的資料配置，其中，有一個屬性設定它的父MessageSource為propertiesMessageSource。意思是如果資料庫找不到對應的資料，到properties檔案當中查詢。messageInterpolator是個攔截器。

2）資料庫的POJO定義

@Entity
@SuppressWarnings("serial")
@Table(name="resource")

public class Resource implements Serializable {
 @Id
 @GeneratedValue(strategy=GenerationType.IDENTITY)
 @Column(name="resource_id")
 private long resourceId;

 @Column(name="name", length=50, nullable=false)
 private String name;

 @Column(name="text", length=1000, nullable=false)
 private String text;

 @Column(name="language", length=5, nullable=false)
 private String language;

 public long getResourceId() {
     return resourceId;
 }

 public void setResourceId(long resourceId) {
    this.resourceId = resourceId;
 }

 public String getName() {
     return name;
 }

 public void setName(String name) {
     this.name = name;
 }

 public String getText() {
     return text;
 }

 public void setText(String text) {
     this.text = text;
}

 public String getLanguage() {
     return language;
 }

 public void setLanguage(String language) {
     this.language = language;
 }
}

定義了一張表[resource]，欄位有：[resource_id]、[name]、[text]、[language]。

3）讀取資料庫的MessageResource類

/**
* 取得資源資料
* @author Robin
*/
public class MessageResource extends AbstractMessageSource implements ResourceLoaderAware {

 @SuppressWarnings("unused")
 private ResourceLoader resourceLoader;

 @Resource
 private ResourceService resourceService;
 /**
 * Map切分字元
 */
 protected final String MAP_SPLIT_CODE = "|";
 protected final String DB_SPLIT_CODE = "_";

 private final Map<String, String> properties = new HashMap<String, String>();

 public MessageResource() {
     reload();
 }

 public void reload() {
     properties.clear();
     properties.putAll(loadTexts());
 }

 protected Map<String, String> loadTexts() {
     Map<String, String> mapResource = new HashMap<String, String>();
     List<com.obs2.service.bean.Resource> resources = resourceService.findAll();
     for (com.obs2.service.bean.Resource item : resources) {
     String code = item.getName() + MAP_SPLIT_CODE + item.getLanguage();
     mapResource.put(code, item.getText());
     }

     return mapResource;
 }

 private String getText(String code, Locale locale) {
     String localeCode = locale.getLanguage() + DB_SPLIT_CODE + locale.getCountry();
     String key = code + MAP_SPLIT_CODE + localeCode;
     String localeText = properties.get(key);
     String resourceText = code;
     if(localeText != null) {
         resourceText = localeText;
     }else {
         localeCode = Locale.ENGLISH.getLanguage();
         key = code + MAP_SPLIT_CODE + localeCode;
         localeText = properties.get(key);
         if(localeText != null) {
             resourceText = localeText;
         }else {
            try {
                 if(getParentMessageSource() != null) {
                     resourceText = getParentMessageSource().getMessage(code, null, locale);
                 }
             } catch (Exception e) {
                 logger.error("Cannot find message with code: " + code);
             }
         }
     }
     return resourceText;
 }

 @Override
 public void setResourceLoader(ResourceLoader resourceLoader) {
     this.resourceLoader = (resourceLoader != null ? resourceLoader : new DefaultResourceLoader());
 }

 @Override
 protected MessageFormat resolveCode(String code, Locale locale) {
     String msg = getText(code, locale);
     MessageFormat result = createMessageFormat(msg, locale);
     return result;
 }

 @Override
 protected String resolveCodeWithoutArguments(String code, Locale locale) {
     String result = getText(code, locale);
     return result;
 }
}

主要是過載AbstractMessageSource和ResourceLoaderAware，以實現Spring MVC的MessageSource國際化呼叫。類中的reload()方法，我把它寫到了一個ServletListener當中，讓專案啟動時，自動載入資料到static的map中。

4）Listener

/**
* 系統啟動監聽
* @author Robin
*/
public class SystemListener implements ServletContextListener {
/**
* context初始化時激發
*/
@Override
public void contextInitialized(ServletContextEvent e) {
// 取得ServletContext
ServletContext context = e.getServletContext();
WebApplicationContext applicationContext = WebApplicationContextUtils .getWebApplicationContext(context);
// 設定國際化多語言
MessageResource messageSource = applicationContext.getBean(MessageResource.class);
 messageSource.reload();
}

/**
* context刪除時激發
*/
@Override
public void contextDestroyed(ServletContextEvent e) {
}

/**
* 建立一個 session時激發
* @param e
*/

public void sessionCreated(HttpSessionEvent e) {
}

/**
* 當一個 session失效時激發
* @param e
*
public void sessionDestroyed(HttpSessionEvent e) {

}

/**
* 設定 context的屬性，它將激發attributeReplaced或attributeAdded方法
* @param e
*/
public void setContext(HttpSessionEvent e) {
}

/**
* 增加一個新的屬性時激發
* @param e
*/
public void attributeAdded(ServletContextAttributeEvent e) {
}

/**
*刪除一個新的屬性時激發
* @param e
*/

public void attributeRemoved(ServletContextAttributeEvent e) {

}

/*
* 屬性被替代時激發
* @param e

*/
public void attributeReplaced(ServletContextAttributeEvent e) {
}
}

該Listener需要加入到web.xml當中：

<!-- 系統啟動監聽 -->
<listener>
    <listener-class>com.obs2.util.SystemListener</listener-class>
</listener>

5）Interceptor攔截器

/**
* 攔截Annotation驗證資訊
* @author Robin
*
*/

public class MessageResourceInterpolator implements MessageInterpolator {
@Resource
private MessageResource messageResource;

public void setMessageResource(MessageResource messageResource) {
 this.messageResource = messageResource;
}

@Override
public String interpolate(String messageTemplate, Context context) {

String messageTemp = null;
 if(messageTemplate.startsWith("{") && messageTemplate.endsWith("}")) {
 messageTemp = messageTemplate.substring(1, messageTemplate.length() - 1);
 }else {
 return messageTemplate;
 }

 String[] params = (String[]) context.getConstraintDescriptor().getAttributes().get("params");
 MessageBuilder builder = new MessageBuilder().code(messageTemp);

 if (params != null) {
 for (String param : params) {
 builder = builder.arg(param);
 }

 }

 String result = builder.build().resolveMessage(messageResource, Locale.ENGLISH).getText();
 return result;

 }

@Override
public String interpolate(String messageTemplate, Context context, Locale locale) {

 String messageTemp = null;
 if(messageTemplate.startsWith("{") && messageTemplate.endsWith("}")) {
 messageTemp = messageTemplate.substring(1, messageTemplate.length() - 1);
 }else {
 return messageTemplate;
 }

 String[] params = (String[]) context.getConstraintDescriptor().getAttributes().get("params");

 MessageBuilder builder = new MessageBuilder().code(messageTemp);
 if (params != null) {
 builder = builder.args(params);
 }

 String result = builder.build().resolveMessage(messageResource, locale).getText();

 return result
 }

}

4.2靜態資源

<!-- 資原始檔繫結器，檔名稱：messages.properties（沒有找到時的預設檔案）， messages_en.properties（英文），messages_zh_CN.properties（中文），等等-->
<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
    <property name="basename" value="config.messages.messages" />
    <property name="defaultEncoding" value="UTF-8"/>
    <property name="basename" value="i18n.messages"/>
    <property name="useCodeAsDefaultMessage" value="true" />
</bean>

5.文案獲取

5.1資源獲取介面

5.1.1 MessageSource詳解

Spring定義了訪問國際化資訊的MessageSource介面，並提供了幾個易用的實現類。首先來了解一下該介面的幾個重要方法：1）String getMessage(String code, Object[] args, String defaultMessage, Locale locale) code表示國際化資源中的屬性名；args用於傳遞格式化串佔位符所用的執行期引數；當在資源找不到對應屬性名時，返回defaultMessage引數所指定的預設資訊；locale表示本地化物件；2）String getMessage(String code, Object[] args, Locale locale) throws NoSuchMessageException與上面的方法類似，只不過在找不到資源中對應的屬性名時，直接丟擲NoSuchMessageException異常；3）String getMessage(MessageSourceResolvable resolvable, Locale locale) throws NoSuchMessageException