JSF的國際化(Internnationalization)訊息處理是基於Java對國際化的支援,您可以在一個訊息資源檔中統一管理訊息資源,資源檔的名稱是.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格式,例如您可以先在訊息資源檔中寫下以下的內容:
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>標籤來指定載入訊息資源,一個例子如下:
<%@ 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>
分享到:
相关推荐
3. **jsf-impl.jar**:与jsf-api.jar相对应,这个文件包含了JSF的实现代码。在实际开发中,开发者通常只需要引用api.jar进行编程,而impl.jar则在运行时提供具体的实现细节,执行用户界面的渲染和事件处理等功能。 ...
在Java EE应用中,`jsf-impl.jar` 和 `jsf-api.jar` 是两个至关重要的库文件,它们分别包含了JSF框架的核心实现和API接口。 `jsf-api.jar` 文件是JSF框架的API(Application Programming Interface)部分,它定义了...
在部署包含JSF功能的Web应用到Tomcat时,确保所有必要的库,如`jsf-api.jar`(通常与`jsf-impl.jar`一起使用,提供JSF实现),被正确地添加到Tomcat的类路径(ClassPath)中是至关重要的。如果缺失这些库,应用程序...
JSF的核心组件包括`jsf-api.jar`和`jsf-impl.jar`,这两个jar包在给定的压缩文件中占有重要位置。 1. **jsf-api.jar**: `jsf-api.jar`包含了JSF框架的公共API,它是开发者编写JSF应用时所依赖的接口和类。这些...
"jstl-1.2"指的是JSTL(JavaServer Pages Standard Tag Library),这是一个用于JSP页面的标准标签库,它包含了一系列预定义的标签,可以用来处理常见任务,如迭代、条件判断、XML处理、国际化和URL重写等。...
JavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-apiJavaEE源代码 jsf-...
在开发多语言应用时,尤其是针对中文用户的场景,`jsf-api.jar` 的这一特性显得尤为重要,它确保了本地化资源的正确加载,为用户提供符合语言习惯的错误信息和提示。 JSF框架主要由以下几个关键组件构成: 1. **...
JavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源代码 jsf-implJavaEE源...
《JSF-AV-rules.rar》是一个压缩包文件,包含了航空C++编程规范,这个规范主要针对的是在航空系统开发中使用C++编程时应当遵循的一系列规则和标准。航空系统的软件开发对于安全性、可靠性和可维护性有着极高的要求,...
**jsf-api.jar** 文件包含JSF框架的接口和抽象类,这些定义了JSF应用开发所需的主要API。开发者通常需要这个库来编译他们的JSF项目,因为编译时需要知道JSF提供的公共接口和抽象类。它不包含具体的实现,而是提供了...
这些JAR包在【标题】中提到的"jsf-api.jar"、"jsf-impl.jar"以及【描述】中列出的其他文件,都是与Java Web应用程序开发密切相关的库。现在我们将详细讨论每个JAR包的功能和用途。 1. **jsf-api.jar**:JavaServer ...
jsf-impl-1.2_12 源码 jar
ajax4jsf-1.0.6.jarajax4jsf-1.0.6.jarajax4jsf-1.0.6.jar
`jsf-api.jar` 文件是JSF框架的API库,包含了JSF的接口和类,开发者可以通过这个API来实现对JSF的功能调用。 **jsf-api.jar** 的详细内容: 1. **组件模型**:JSF提供了丰富的UI组件库,如按钮、输入框、表格等,每...
【标题】"jboss-ajax4jsf-1.1.1-src" 是一个开源项目,主要涉及Ajax4jsf框架的源代码版本,版本号为1.1.1。Ajax4jsf是针对JavaServer Faces (JSF) 技术的一个扩展,它允许开发者在JSF应用中无缝集成Ajax功能,提升...
这是jsf-api-2.0.jar,为了使用方便传上来.只是个jar包.
JSF-1_1-API.chm
JSF-API.CHM,JSF-API.CHMJSF-API.CHM,JSF-API.CHM
JSF-api-1.2_14-sources.jar,提供了jsf使用时的多种内部类。