`
zhouxing
  • 浏览: 210841 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

jsf-國際化訊息

    博客分类:
  • JSF
阅读更多
JSF的國際化(Internnationalization)訊息處理是基於Java對國際化的支援,您可以在一個訊息資源檔中統一管理訊息資源,資源檔的名稱是.properties,而內容是名稱與值的配對,例如:
  • messages.properties
 
titleText=JSF Demo
hintText=Please input your name and password
nameText=name
passText=password
commandText=Submit

 

資源檔名稱由basename加上語言與地區來組成,例如:
  • basename.properties
  • basename_en.properties
  • basename_zh_TW.properties

 

沒有指定語言與地區的basename是預設的資源檔名稱,JSF會根據瀏覽器送來的Accept-Language header中的內容來決定該使用哪一個資源檔名稱,例如:

 

Accept-Language: zh_TW, en-US, en

 

如果瀏覽器送來這些header,則預設會使用繁體中文,接著是美式英文,再來是英文語系,如果找不到對應的訊息資源檔,則會使用預設的訊息資源檔。

 

由於訊息資源檔必須是ISO-8859-1編碼,所以對於非西方語系的處理,必須先將之轉換為Java Unicode Escape格式,例如您可以先在訊息資源檔中寫下以下的內容:
  • messages_zh_TW.txt
 
titleText=JSF示範
hintText=請輸入名稱與密碼
nameText=名稱
passText=密碼
commandText=送出

 

然後使用JDK的工具程式native2ascii來轉換,例如:

 

native2ascii -encoding Big5 messages_zh_TW.txt messages_zh_TW.properties

 

轉換後的內容會如下:
  • messages_zh_TW.properties
 
titleText=JSF\u793a\u7bc4
hintText=\u8acb\u8f38\u5165\u540d\u7a31\u8207\u5bc6\u78bc
nameText=\u540d\u7a31
passText=\u5bc6\u78bc
commandText=\u9001\u51fa

 

接下來您可以使用<f:loadBundle>標籤來指定載入訊息資源,一個例子如下:
  • index.jsp
 
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@page contentType="text/html;charset=UTF-8"%>

<f:view>
<f:loadBundle basename="messages" var="msgs"/>

<html>
<head>
<title><h:outputText value="#{msgs.titleText}"/></title>
</head>
<body>

<h:form>
<h3><h:outputText value="#{msgs.hintText}"/></h3>
<h:outputText value="#{msgs.nameText}"/>:
<h:inputText value="#{user.name}"/><p>
<h:outputText value="#{msgs.passText}"/>:
<h:inputSecret value="#{user.password}"/><p>
<h:commandButton value="#{msgs.commandText}"
actionListener="#{user.verify}"
action="#{user.outcome}"/>
</h:form>

</body>
</html>

</f:view>

 

如此一來,如果您的瀏覽器預設接受zh_TW語系的話,則頁面上就可以顯示中文,否則預設將以英文顯示,也就是messages.properties的內容,為了能顯示多國語系,我們設定網頁編碼為UTF8。

 

<f:view>可以設定locale屬性,直接指定所要使用的語系,例如:
 
<f:view locale="zh_TW">
<f:loadBundle basename="messages" var="msgs"/>

 

直接指定以上的話,則會使用繁體中文來顯示,JSF會根據<f:loadBundle>的basename屬性加上<f:view>的locale屬性來決定要使用哪一個訊息資源檔,就上例而言,就是使用 messages_zh_TW.properties,如果設定為以下的話,就會使用messages_en.properties:
 
<f:view locale="en">
<f:loadBundle basename="messages" var="msgs"/>

 

您也可以在faces-config.xml中設定語系,例如:
 
<faces-config>
<application>
<local-config>
<default-locale>en</default-locale>
<supported-locale>zh_TW</supported-locale>
</local-config>
</application>

.....
</faces-config>

 

在<local-config>一定有一個<default-locale>,而<supported- locale>可以有好幾個,這告訴JSF您的應用程式支援哪些語系。

 

當然,如果您可以提供一個選項讓使用者選擇自己的語系會是更好的方式,例如根據user這個Bean的locale屬性來決定頁面語系:
 
<f:view locale="#{user.locale}">
<f:loadBundle basename="messages" var="msgs"/>

 

在頁面中設定一個表單,可以讓使用者選擇語系,例如設定單選鈕:
 
<h:selectOneRadio value="#{user.locale}">
<f:selectItem itemValue="zh_TW"
itemLabel="#{msgs.zh_TWText}"/>
<f:selectItem itemValue="en"
itemLabel="#{msgs.enText}"/>
</h:selectOneRadio>

分享到:
评论

相关推荐

    JSF入门级教程

    6. 国际化讯息 JSF支持资源包(resource bundle)机制,用于提供不同语言的文本。通过修改资源包,你可以轻松地为应用添加多语言支持。 7. Managed Beans Managed Beans是JSF中的核心组件,负责存储和处理业务逻辑...

    JSF基础教程 简体中文

    o 国际化讯息 Managed Beans JSF 使用 Bean 来达到逻辑层与表现层分离的目的,Bean 的管理集中在组态档案中,您只要修改组态档案,就可以修改 Bean 之间的相依关系。 o Backing Beans o Beans 的组态与设定 o Beans...

    JSF入门精通超级好的教程

    - **国际化讯息**:展示了如何在JSF应用程序中实现国际化支持。 - **ManagedBeans**: - **BackingBeans**:介绍用于存储页面数据的Bean类型,它们通常与特定的UI组件关联。 - **Beans的组态与设定**:描述了...

    jsf 简易教程....

    - **1.1.6 国际化讯息** JSF支持多语言和地域性的消息显示,通过资源束文件实现。这使得应用能够根据用户的语言偏好动态显示适当的消息,增强了用户体验。 #### 二、ManagedBeans - **1.2 ManagedBeans** ...

    java server face 教程

    **国际化讯息** - **国际化支持**:介绍JSF中如何支持多种语言,确保应用程序能够适应不同的地区和文化背景。 - **资源文件**:解释如何创建和使用资源文件来存储不同语言的文字内容。 #### 二、Managed Beans **...

Global site tag (gtag.js) - Google Analytics