1.1.1 资源文件
使用资源文件来放置标签显示值,提示信息等,如果你的Struts应用有国际化的要求,那么资源文件一定要好好地利用,就算没有国际化需求,使用资源文件也可以统一应用程序用语(例如统一的提示信息,标签信息等),而且当用语发生变化(如“小时”变成“钟头”J),很容易统一进行修改。下面是示例程序所用到的资源文件内容(application.properties):
#System global labels
button_cancel = 取消
button_edit = 修改
button_delete = 删除
button_save = 保存
button_submit = 确认
#lables for project
projectcontroller.title = 管理项目
project.project_create = 添加项目
project.project_modify = 修改项目
project.project_list = 已添加项目列表
project.projectcode = 项目代码
project.projectname = 项目名称
project.discount = 项目分成比例
project.site = 所属小区
# Standard error messages for validator framework checks
errors.required={0} is required.
errors.minlength={0} cannot be less than {1} characters.
errors.maxlength={0} cannot be greater than {2} characters.
errors.invalid={0} is invalid.
errors.byte={0} must be an byte.
errors.short={0} must be an short.
errors.integer={0} must be an integer.
errors.long={0} must be an long.
errors.float={0} must be an float.
errors.double={0} must be an double.
errors.date={0} is not a date.
errors.range={0} is not in the range {1} through {2}.
errors.creditcard={0} is not a valid credit card number.
errors.email={0} is an invalid e-mail address.
那么,如何在Struts应用中引用资源文件呢?
首先需要在Struts配置文件(Struts-config.xml)中指明配置文件的路径,在配置文件中添加如下一行信息:
<message-resources parameter="ApplicationResources_CN" />
parameter所指的就是配置文件,注意,为什么这里指明的是applicationResources_CN,而不是上面提到的application.properties?这是为了能在Struts中正确显示中文,利用jdk自带的native2ascii程序对application.properties作了编码转换,编码转换后的文件名为ApplicationResources_CN.properties,扩展名可以省略。
需要注意的是,改配置文件一定要放在classpath范围内,一般放置在WEB-INF/classes目录下,如果放在classes的子目录下,其指引方式和java包一样,例如在WEB-INF/classes/com目录下,则应该用如下语句指引:
<message-resources parameter="com.ApplicationResources_CN" />
小技巧
进行中文编码转换的命令如下:
native2ascii -encoding gb2312 application.properties ApplicationResources_CN.properties
在配置文件声明了对资源文件的引用之后,就可以在Struts提供的标签以及校验框架等其它地方使用这些资源,具体使用方法请查看相关标签和配置文件说明。
1.1.2 struts-config.xml
该文件定义了Struts应用中的Action,ActionForm,插件,资源引用等信息,示例程序struts-config.xml文件内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">
<struts-config>
<form-beans>
<!--项目增、删、改form定义 begin-->
<form-bean name="projectForm" type="com.ort.strutsdemo.simpledemo.ui.ProjectForm">
</form-bean>
<!--项目增、删、改form定义 结束-->
<!--进入项目增、删、改界面之前参数传递Form begin-->
<form-bean name="projectLoadForm" type="org.apache.struts.action.DynaActionForm">
<form-property name="action" size="10" type="java.lang.String" initial="create"/>
<form-property name="projectCode" size="30" type="java.lang.String" initial=""/>
</form-bean>
<!--进入项目增、删、改界面之前参数传递Form end-->
<!--项目查询Form定义 Begin-->
<form-bean name="projectSearchForm" type="org.apache.struts.action.DynaActionForm">
<form-property name="projectCode" size="10" type="java.lang.String" initial=""/>
<form-property name="projectCodeSign" size="10" type="java.lang.String" initial=""/>
<form-property name="projectName" size="10" type="java.lang.String" initial=""/>
<form-property name="projectNameSign" size="10" type="java.lang.String" initial=""/>
<form-property name="page" size="10" type="java.lang.Integer" initial="1"/>
<form-property name="pageCount" size="10" type="java.lang.Integer" initial="1"/>
</form-bean>
<!--项目查询Form定义 End-->
</form-beans>
<global-forwards>
<forward name="projectlist" path="/projectlist.jsp" />
<forward name="projectform" path="/projectform.jsp" />
<forward name="failed" path="/failed.jsp" />
<forward name="success" path="/success.jsp" />
</global-forwards>
<action-mappings>
<action input="projectform" name="projectForm" path="/projectformsave" scope="request" type="com.ort.strutsdemo.simpledemo.controller.ProjectFormSaveAction" validate="true">
<forward name="success" path="/projectsearch.do" redirect="true" />
<forward name="success.return" path="/projectsearch.do" redirect="true" />
<forward name="cancel" path="/projectsearch.do" redirect="true" />
<forward name="failed" path="/failed.jsp" />
<forward name="failed.return" path="/projectsearch.do" />
</action>
<action input="projectlist" name="projectLoadForm" path="/projectformload" scope="request" type="com.ort.strutsdemo.simpledemo.controller.ProjectFormLoadAction" validate="false">
<forward name="success" path="/projectform.jsp" />
<forward name="failed" path="/failed.jsp" />
<forward name="failed.return" path="/projectsearch.do" redirect="true" />
</action>
<action input="projectlist" name="projectSearchForm" path="/projectsearch" scope="request" type="com.ort.strutsdemo.simpledemo.controller.ProjectListSearchAction" validate="false">
<forward name="success" path="/projectlist.jsp"/>
<forward name="failed" path="/failed.jsp" />
<forward name="failed.return" path="/projectsearch.do" redirect="true" />
</action>
</action-mappings>
<controller>
<set-property property="inputForward" value="true" />
</controller>
<message-resources parameter="ApplicationResources_CN" />
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
<set-property property="pathnames" value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml" />
</plug-in>
</struts-config>