铁手剑谱

第2.6式. 使用多个资源束

问题

你可能想要将你的应用资源分解到多个文件中，以改善应用的组织和维护性，特别是在团队开发的环境中。

动作要领

创建单独的属性文件并且在struts-config.xml中为每一个文件声明一个message-resources元素。

<message-resources
  parameter="com.oreilly.strutsckbk.MessageResources"/>
<message-resources 
  parameter="com.oreilly.strutsckbk.LabelResources"
  key="labels">
</message-resources>
<message-resources 
  parameter="com.oreilly.strutsckbk.HeaderResources"
  key="headers">
</message-resources>

动作变化

Struts 使用消息资源来提供对错误消息、字段标注、以及其他静态文本的存储机制。对于默认的Struts 实现，你可以将消息存储为属性文件（.properties文件）中的名称（关键字）/值对。消息资源集基本上相当于Java ResourceBundle（资源束）。

你可以将你的消息资源束性文件通过message-resources元素来配置。元素的parameter属性指示了属性文件的相对于classpath的名称。你可以通过将文件路径中的分隔符替换为点号，以及删除文件名中的.properties扩展名来产生这个属性的值。比如，如果你的属性文件位于/WEB-INF/classes/com/oreilly/strutsckbk/MessageResources.properties，你可以将消息资源元素设置为：

<message-resources
  parameter="com.oreilly.strutsckbk.MessageResources"/>

在应用启动时， Struts将创建消息资源的运行时表达（一个对象实例），然后将其保存在servlet context中。

你并不限于只使用一个消息资源。然而，和使用多Struts配置文件不同，如果你使用多个消息资源文件，它们并不时合并成一个文件。相反，你需要定义消息资源的不同的集合。每一个集合使用一个key属性指定的唯一的值来标识。如果这个属性没被使用，那么该消息资源就会被设置为默认的消息集。只有一个默认消息集存在。同时，只有一个消息资源集对应于同一模块中的每一个唯一关键字。如果你使用同一关键字定义了多个消息资源束，则最后一个指定的将被使用。

key属性的值是作为servlet context 属性的名称，从属性文件创建的消息资源束就保存在它之下。key值被用在Struts标签之中，比如bean:message，来标识消息资源集，并引用到来自于属性文件的资源束。下面是你可以如何从labels消息资源来访问一个消息的方法：

<bean:message bundle="labels" key="label.url"/>

bundle属性的值对应于struts-config.xml文件中的message-resources元素的key属性。bean:message标签也有一个key属性，但它和message-resources元素的key属性的含义完全不同。它指定一个特定的属性来访问消息资源中的消息。

Struts 并不关心你如何分解你的消息资源属性文件。一种办法是按照消息类型分解。比如，你可以将你的消息资源分解为下面的几组：

• 错误消息
• 提示性消息
• 字段标注
• 表头单元个文本

虽然这样分解消息资源是合乎逻辑和合理的，但在团队环境中则倾向于按照功能进行分解。比如，考虑一个人力资源应用，它有薪酬、福利和管理功能区。你可以为每一个功能区创建一个消息资源属性文件。每一个属性文件都包含该功能区域所特定的错误消息、提示消息、字段标注和其他信息。如果你的开发团队是按照这些业务功能区进行分组的，按照相同的分组原则对消息资源进行分组则更加合理。相同的方法和原则也适用于Struts 配置文件的分解。

如果你熟悉Struts module，上述的每一个功能区都是一个很好的Struts module的候选。如果你使用module，那么你在struts-config文件中为某一个模块所定义的消息资源就仅适用于该模块。事实上，你可以在不同的模块中定义具有相同key属性的message-resource元素。回想一下， Struts 是使用key值将MessageResources保存在servlet context中。更准确地说，实际的值将用于模块名称（通常引用为模块的前缀），以及消息资源的key属性值的串联。

相关招式

第2.4式提供了关于分解应用组件的技术。Struts 用户指南提供了定义消息资源的文档，其地址为：http://jakarta.apache.org/struts/userGuide/configuration.html#resources_config.

Struts MessageResources的JavaDoc API可以在http://jakarta.apache.org/struts/api/org/apache/struts/util/MessageResources.html处找到。

Struts 文档中关于bean:message标签的文档可以在http://jakarta.apache.org/struts/userGuide/struts-bean.html#message处找到。