本教程假设你已完成Form Validation教程,可以在Google Code -http://code.google.com/p/struts2-examples/downloads/list下载 Message_Resource_Struts2_Ant或者Message_Resource_Struts2_Mvn。 |
引言
本课学习使用Struts 2消息资源功能(也叫资源bundles)。消息资源提供了一个简单的在view页面中放置文本的方式,文本可以用来完成用户本地化。
消息资源属性文件
在Struts 2 web application中可以创建跟struts2 action相应的消息资源属性文件,这个文件和action同名,以.properties为后缀,本文件要与action类在同一个包目录下,本课用properties文件放置表单标签的label值,以实现不同语言之间的转换。
如果你完成了Form Validation ,可在原项目中改写。
在org.apache.struts.register.action包下建立Register.properties文件,并加入以下文本:
personBean.firstName=First namepersonBean.lastName=Last namepersonBean.age=AgepersonBean.email=Emailthankyou=Thank you for registering %{personBean.firstName}.
以上是一个标准的Java properties文件。等号左边是key,右边是value,当Register action执行时,这些属性对view页面来说就是可用的。(通过对key的引用)
Struts 2 Key属性
Struts 2 的key属性可以用在textfield标签,value作为textfield的label,key作为name。
register.jsp页面有如下Struts 2 textfield标签:
<s:textfield name="personBean.firstName" label="First name" />
用key属性可以取代name和label
<s:textfield key="personBean.firstName" />
key使得Struts 2 framework使用相同的值作为name属性,对于label的值,key的值可以使Struts 2 framework在properties文件中找到与其同名的key,将其对应的值作为label的值。
为了使key属性能找到properties文件,view页面必须是action类的result页面。我们看index.jsp中register的链接,只是一个标准的url:
<p><a href="register.jsp">Please register</a> for our prize drawing.</p>
我们要改写一下上面的链接使得他可以通过Struts 2 的Action类Register.java,换成下面的内容:
<s:url action="registerInput" var="registerInputLink" /><p><a href="${registerInputLink}">Please register</a> for our prize drawing.</p>
我们用struts2 url标签创建一个到registerInput action的链接。然后在struts.xml中配置该action。加入下面内容:
<action name="registerInput" class="org.apache.struts.register.action.Register" method="input" > <result name="input">/register.jsp</result></action>
以上配置告诉Struts 2 framework执行Register类的input方法,该方法继承自ActionSupport,默认返回input。
通过以上步骤,view页面可以使用Register.properties的内容。Struts 2 framework会使Register.properties中定义的properties可用,因为view页面是在Register.java执行后返回的。
发布应用,转到home页面,会看到一个到registerInput.action的超链接。
点击register,出现register.jsp页面,代表域的label将会是Register.properties文件相应key的value值。
Struts 2 Text标签
Struts 2 text标签也可以使用properties文件,在thankyou.jsp加入以下内容取代h3标签。
<h3><s:text name="thankyou" /></h3>
因为thankyou.jsp也是Register.java Action类执行后返回,所以key和value是可用的。
那么在thankyou.jsp中怎样使用用户的输入呢?像personBean.firstName。回头看看Register.properties文件的thankyou key。
thankyou=Thank you for registering %{personBean.firstName}.
%{personBean.firstName}告诉Struts 2通过调用getPersonBean取得返回值,然后调用getFirstName方法返回firstName,替换它。
包级别的Properties
如果想让properties文件中的内容被不同action类返回的view页面使用怎么办呢?Struts 2提供了包级别的properties文件来解决这个问题。
将下面内容写入package.properties文件并放在org.apache.struts包下。
greeting=Welcome to The Wonderful World of Struts 2
现在org.apache.struts...包下的action返回的view页面都可以使用了。例如在helloworld.jsp的h2标签前加入如下内容:
<h1><s:text name="greeting" /></h1>
重新部署,转到index.jsp,点击Hello World链接,会看到:
全局的Properties
你也可以在struts.xml中配置一个全局的properties文件。这个property文件中定义的key和value值对所有action执行后返回的view页面都是可用的。
加入如下global.properties文件(文件名不强制要求为global)。
contact=For assistance contact <a href='mailto:contact@email.com'>contact@email.com</a>
在src目录下保存global.properties文件。
为了让Struts 2 framework了解global.properties文件,在struts.xml的name="struts.devmode"的constant节点后加入下面节点。
<constant name="struts.custom.i18n.resources" value="global" />
为了在view页面中使用contact键,在index.jsp中加入以下标签。
<hr /><s:text name="contact" />
重新部署,转到index.action,会看到:
Struts 2会先从匹配action类的properties文件中查找,如找不到,则在包级别的properties文件中查找,最后在struts.xml文件中配置的文件中查找。这里会在global文件中找到。
也可以在所有jsp页面中加入上述text标签。
国际化
使用属性资源文件可以提供不同语言的文本,默认情况下,struts 2 会使用用户的本地语言。如果本地语言为英语,则struts 2会找到没有地区标记的文件,例如Register.properties。如果本地语言非英语,例如西班牙语,则struts 2会查找Register_es.properties。
为了说明,我们创建一个Register_es.properties文件并加入以下内容(value为西班牙语)。
personBean.firstName=NombrepersonBean.lastName=ApellidospersonBean.age=EdadpersonBean.email=Correothankyou=Gracias por registrarse, %{personBean.firstName}.
将Register_es.properties文件保存在与Register.properties相同的目录下。
例子中,我们要告诉Struts 2使用西班牙地区语言代替英语,在index.jsp中加入以下标记。
<h3>Registro espa?ol</h3><s:url action="registerInput" var="registerInputLinkES"> <s:param name="request_locale">es</s:param></s:url><p><a href="${registerInputLinkES}">Por favor, regístrese</a> para nuestro sorteo</p>
上述标记我们在url中加入了一个request_locale参数,值为es,action发现这个参数,会查找es结尾的properties文件,例如Register_es.properties文件,会使用这个文件中的内容。
点击注册链接后,会看到西班牙语label的表单。
带_es的文件对于包级别的properties文件和全局的properties文件都是一样的,使用这些,我们可以建立全页面都是西班牙语的应用。
总结
学习了消息资源文件和国际化,想了解更多请参考官方文档http://struts.apache.org。
下篇
下篇教程学习配置Struts 2来处理未捕获异常。