使用Validator包括如下三步:1、启用Validator插件;2、生成Form Bean类;3、修改配置文件。下面将详细说明如何配置和使用Validator。
一、启用Validator插件
虽然在Struts工具包中包含了Validator,但默认情况下Validator是没有被启用的。若要启用Validator,必须在struts-config.xml文件中添加入下的代码:
<!-- Validator Configuration -->
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
<set-property property="pathnames"
value="/WEB-INF/validator-rules.xml,
/WEB-INF/validation.xml"/>
</plug-in>
其中,指定的两个配置文件的路径应为相对于所在模块的路径,以上代码应按照和stuts-config.xml配置文件相对应的DTD文件所要求的格式,放到合适的位置。
二、生成Form Bean类
为了使用Validator,生成的Form Bean类必须继承ActionForm的子类ValidatorForm。
在Form Bean类中要包含和Form表单中各字段相对应的成员变量,然后公开各成员变量的get及set方法。
示例代码如下:
package com.my;
import org.apache.struts.validator.ValidatorForm;
public class MyForm extends ValidatorForm{
public String getAge() {
return age;
}
public void setAge(String age) {
this.age = age;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
private String name;
private String age;
}
三、修改配置文件
在struts-config.xml文件中指定Form Bean。
示例代码如下:
<form-beans>
<form-bean name="MyForm"
type="com.my.MyForm"/>
</form-beans>
Struts开发包中存在validatotr-rules.xml文件,将其拷贝到应用模块的WEB-INF目录下(当然也可以自己新建并编写此文件)。在同一目录下新建validation.xml文件,并编写验证内容。为了方便编写,引入相应的DTD文件(推荐validator_1_1_3.dtd)。
示例代码如下:
<form-validation>
<formset>
<form name="MyForm">
<field property="name"
depends="required,minlength,maxlength">
<arg0 key="name" resource="false"/>
<arg1 name="minlength"
key="${var:minlength}"
resource="false"/>
<arg1 name="maxlength"
key="${var:maxlength}"
resource="fasle"/>
<var>
<var-name>minlength</var-name>
<var-value>4</var-value>
</var>
<var>
<var-name>maxlength</var-name>
<var-value>16</var-value>
</var>
</field>
<field property="age"
depends="required,integer,intRange">
<arg0 key="age" resource="false"/>
<arg1 name="intRange"
key="${var:min}"
resource="false"/>
<arg2 name="intRange"
key="${var:max}"
resource="false"/>
<var>
<var-name>min</var-name>
<var-value>1</var-value>
</var>
<var>
<var-name>max</var-name>
<var-value>100</var-value>
</var>
</field>
</form>
</formset>
</form-validation>
由于Validator要从资源文件中读取Error Messages,所以还要配置资源文件。在com.my包中新建一资源文件,取名为application.properties(扩展名必须为propertyies),其内容如下:
# Struts Validator Error Messages
errors.required={0} is required.
errors.minlength={0} can not be less than {1} characters.
errors.maxlength={0} can not be greater than {1} characters.
errors.invalid={0} is invalid.
errors.byte={0} must be a byte.
errors.short={0} must be a short.
errors.integer={0} must be an integer.
errors.long={0} must be a long.
errors.float={0} must be a float.
errors.double={0} must be a double.
errors.date={0} is not a date.
errors.range={0} is not in the range {1} through {2}.
errors.creditcard={0} is an invalid credit card number.
errors.email={0} is an invalid e-mail address.
为了使容器能够加载资源文件,还要在struts-config.xml文件中进行设置,在适当位置添加如下代码:
<message-resources parameter="com.my.application"/>
四、至此,Validator配置工作已经完成。若要测试Validator,还需要编写表单(JSP)页面,建立Action以及配置ActionMapping等工作,请查看相关章节。