日期:2014-05-16  浏览次数:20310 次

JSF入门七(国际化信息)

本文转载自:

http://www.javaworld.com.tw/confluence/pages/viewpage.action?pageId=2630

?

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_CN.properties

?

没有指定语言与地区的basename是预定义的资源文件名称,JSF会根据浏览器送来的Accept-Language header中的内容来决定该使用哪一个资源文件名称,例如:
Accept-Language: zh_CN, en-US, en

如果浏览器送来这些header,则预定义会使用简体中文,接着是美式英文,再来是英文语系,如果找不到对应的信息资源文件,则会使用预定义的信息资源文件。
由于信息资源文件必须是ISO-8859-1编码,所以对于非西方语系的处理,必须先将之转换为Java Unicode Escape格式 ,例如您可以先在信息资源文件中写下以下的内容:messages_zh_CN.txt

titleText=JSF示范
hintText=请输入名称与密码
nameText=名称
passText=密码
commandText=送出

?然后使用JDK的工具程序native2ascii来转换,例如:

native2ascii -encoding GB2312 messages_zh_CN.txt messages_zh_CN.properties

?转换后的内容会如下:

titleText=JSF\u793a\u8303
hintText=\u8bf7\u8f93\u5165\u540d\u79f0\u4e0e\u5bc6\u7801
nameText=\u540d\u79f0
passText=\u5bc6\u7801
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=UTF8"%>
<f:view>
	<f:loadBundle basename="basename" 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>
		<p>
			<h:commandButton value="#{msgs.commandText}"
				actionListener="#{user.verify}" action="#{user.outcome}" />
		</p>
	</h:form>
	</body>
	</html>
</f:view>

?如此一来,如果您的浏览器预定义接受zh_CN语系的话,则页面上就可以显示中文,否则预定义将以英文显示,也就是basename.properties的内容,为了能显示多普通话系,我们设定网页编码为UTF8。注意

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

basename="basename_en.properties下划线前面的内容 "

,JSF会根据<f:loadBundle>的basename属性加上<f:view>的locale属性来决定要使用哪一个信息资源文件,就上例而言,就是使用 messages_zh_CN.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_CN</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_CN"
itemLabel="#{msgs.zh_CNText}"/>
<f:selectItem itemValue="en"
itemLabel="#{msgs.enText}"/>
</h:selectOneRadio>