20160502-struts2入門--國際化

破玉發表於2016-05-02

一、國際化

準備資原始檔，資原始檔的命名格式如下：
baseName_language_country.properties
baseName_language.properties
baseName.properties
其中baseName是資原始檔的基本名，我們可以自定義，但language和country必須是java支援的語言和國家。如：
中國大陸： baseName_zh_CN.properties
美國： baseName_en_US.properties
 
現在為應用新增兩個資原始檔：
第一個存放中文：itcast_zh_CN.properties
內容為：welcome=歡迎來到傳智播客
第二個存放英語（美國）： itcast_en_US.properties
內容為： welcome=welcome to itcast
 
對於中文的屬性檔案，我們編寫好後，應該使用jdk提供的native2ascii命令把檔案轉換為unicode編碼的檔案。命令的使用方式如下：
native2ascii  原始檔.properties  目標檔案.properties
 
配置全域性資源與輸出國際化資訊
當準備好資原始檔之後，我們可以在struts.xml中通過struts.custom.i18n.resources常量把資原始檔定義為全域性資原始檔，如下
<constant name="struts.custom.i18n.resources" value="itcast" />
itcast為資原始檔的基本名。
 
後面我們就可以在頁面或在action中訪問國際化資訊：
l在JSP頁面中使用<s:text name=“”/>標籤輸出國際化資訊：
<s:text name=“user”/>，name為資原始檔中的key
l在Action類中，可以繼承ActionSupport，使用getText()方法得到國際化資訊，該方法的第一個引數用於指定資原始檔中的key。
l在表單標籤中，通過key屬性指定資原始檔中的key，如：
<s:textfield name="realname" key="user"/>
  
package com.dzq.action;

import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;

public class ManagerAction  extends ActionSupport{
@Override
public String execute() throws Exception {
    ActionContext.getContext().put("message", this.getText("welcome"));
    return "message";
}
}

 

 
國際化—輸出帶佔位符的國際化資訊
資原始檔中的內容如下：
welcome= {0}，歡迎來到傳智播客{1}
 
在jsp頁面中輸出帶佔位符的國際化資訊
  
<s:text name="welcome">
       <s:param><s:property value="realname"/></s:param>
    <s:param>學習</s:param>
</s:text>
在Action類中獲取帶佔位符的國際化資訊，可以使用getText(String key, String[] args)或getText(String aTextName, List args)方法。
  
package com.dzq.action;

import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;

public class ManagerAction  extends ActionSupport{
@Override
public String execute() throws Exception {
    ActionContext.getContext().put("message", this.getText("welcome",new String[]{"liming","study"}));
    return "message";
}
}

 

國際化—包範圍資原始檔
在一個大型應用中，整個應用有大量的內容需要實現國際化，如果我們把國際化的內容都放置在全域性資源屬性檔案中，顯然會導致資原始檔變的過於龐大、臃腫，不便於維護，這個時候我們可以針對不同模組，使用包範圍來組織國際化檔案。
 
方法如下：
在java的包下放置package_language_country.properties資原始檔，package為固定寫法，處於該包及子包下的action都可以訪問該資源。當查詢指定key的訊息時，系統會先從package資原始檔查詢，當找不到對應的key時，才會從常量struts.custom.i18n.resources指定的資原始檔中尋找。
 
國際化—Action範圍資原始檔
我們也可以為某個action單獨指定資原始檔，方法如下：
在Action類所在的路徑，放置ActionClassName_language_country.properties資原始檔，ActionClassName為action類的簡單名稱。
 
當查詢指定key的訊息時，系統會先從ActionClassName_language_country.properties資原始檔查詢，如果沒有找到對應的key，然後沿著當前包往上查詢基本名為package 的資原始檔，一直找到最頂層包。如果還沒有找到對應的key，最後會從常量struts.custom.i18n.resources指定的資原始檔中尋找。
 
國際化—JSP中直接訪問某個資原始檔
struts2為我們提供了<s:i18n>標籤，使用<s:i18n>標籤我們可以在類路徑下直接從某個資原始檔中獲取國際化資料，而無需任何配置：
  
<s:i18n name="itcast">
    <s:text name=“welcome”/>
</s:i18n>
Itcast為類路徑下資原始檔的基本名。
如果要訪問的資原始檔在類路徑的某個包下，可以這樣訪問
<s:i18n name=“cn/itcast/action/package">
      <s:text name="welcome">
          <s:param>小張</s:param>
      </s:text>
</s:i18n>
上面訪問cn.itcast.action包下基本名為package的資原始檔
 

相關文章