Struts 2之校验器
validate()方法
支持校验的Action必须实现Validateable接口,一般直接继承ActionSupport就可以了
public void validate() {//会对所有的Action起作用 if(username == null ||"".equals(this.username.trim())){ this.addFieldError("username", "用户名不能为空"); } if(mobile == null ||"".equals(this.mobile.trim())){ this.addFieldError("mobile","手机号不能为空") ; }else{ if(!Pattern.compile( "^1[3,5,8]\\d{9}$").matcher(this.mobile).matches()){ this.addFieldError("mobile", "手机号格式不正确"); } } super.validate(); } public void validateUpdate(){ //假设此Action有个名为update()的方法 //只对update()方法进行校验validateXxx,方法名第一个必须大写 if(username == null ||"".equals(this.username.trim())){ this.addFieldError("username", "用户名不能为空"); } if(mobile == null ||"".equals(this.mobile.trim())){ this.addFieldError("mobile", "手机号不能为空"); }else{ if(!Pattern.compile("^1[3,5,8]\\d{9}$").matcher(this.mobile).matches()){ this.addFieldError("mobile","手机号格式不正确") ; } } super.validate() ; }
对这些错误信息,在JSP页面可以使用标签<s:fielderror/>来显示
基于XML的校验方式
基于XML方式实现校验时,Action类也需要继承ActionSupport类,并且提供校验文件,校验文件同Action类放在一个包内,文件的取名格式为:ActionClassName-validation.xml,其中ActionClassName为Action类的简单名字
<!DOCTYPEvalidators PUBLIC "-//OpenSymphony Group//XWorkValidator 1.0.3//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd"> <validators> <fieldname="username"> <field-validatortype="requiredstring"> <paramname="trim">true</param> <message>用户名不能为空</message> </field-validator> </field> <field name="mobile"> <field-validator type="requiredstring"> <paramname="trim">true</param> <message>手机号不能为空</message> </field-validator> <field-validatortype="regex"> <paramname="expression"><![CDATA[^1[358]\d{9}$]]></param> <message>手机号格式不正确</message> </field-validator> </field> </validators>
Struts 2常用内置校验器
位于xwork-2.0.4.jar压缩包中(com.opensymphony.xwork2.validator.validators)有个文件default.xml ,该文件中定义了Struts2框架内建的校验器。default.xml文件定义了常用的校验器类型。
1、类型转换检验器:
(1)非字段校验:
<validator type="conversion"> <param name="fieldName">myField</param> <message>类型转换错误</message> <param name="repopulateField">true</param> </validator>
(2)字段校验:
<field name="myField"> <field-validator type="conversion"> <message>类型转换错误</message> <param name="repopulateField">true</param> </field-validator> </field>
fieldName:该参数指定检查是否存在转换异常的字段名称,如果是字段校验,则不用指定该参数。
repopulateField:该参数指定当类型转换失败后,返回input页面时,类型转换失败的表单是否保留原来的错误输入。true为保留,false为不保留。
2、日期校验器:
(1)非字段校验:
<validator type="date"> <param name="fieldName">birthday</param> <param name="min">1990-01-02</param> <param name="max">2010-07-28</param> <message>生日数据错误</message> </validator>
(2)字段校验:
<field name="birthday"> <field-validatortype="date"> <param name="min">1990-01-01</param> <param name="max">2010-07-28</param> <messagekey="error.birthday"></message> </field-validator> </field>
min:指定字段日期值的最小值,该参数为可选参数。
max:指定字段日期值的最大值,该参数为可选参数。
3、浮点数值校验器:
(1)非字段校验:
<validator type="double"> <param name="fieldName">percentage</param> <param name="minInclusive">20.1</param> <param name="maxInclusive">50.1</param> <message>生日数据错误</message> </validator>
(2)字段校验:
<field name="percentage"> <field-validatortype="double"> <param name="minInclusive">20.1</param> <param name="maxInclusive">50.1</param> <message key="error.percentage"></message> </field-validator> </field>
minInclusive|minExclusive:指定字段的最小值,包含该值|不包含该值。
maxInclusive|maxExclusive:指定字段的最大值, 包含该值|不包含该值。
4、邮件地址校验器:
(1)非字段校验:
<validator type="email"> <param name="fieldName">MyEmail</param> <message>非法的邮件地址</message> </validator>
(2)字段校验:
<field name="MyEmail"> <field-validator type="email"> <message>非法的邮件地址</message> </field-validator> </field>
5、表达式校验器:
<validator type="expression"> <param name="expression">.......</param> <message>Failed to meet OgnlExpression...</message> </validator>
expression:该参数为一个逻辑表达式,该参数使用OGNL表达式,并基于值栈计算,返回一个Boolean类型值。
6、字段表达式校验器:
(1)非字段校验:
<validator type="fieldexpression"> <param name="fieldName">myField</param> <param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param> <message>My credit limit shouldbe MORE than my girlfriend</message> </validator>
(2)字段校验:
<field name="myField"> <field-validatortype="fieldexpression"> <param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param> <message>My credit limitshould be MORE than my girlfriend</message> </field-validator> </field>
7、整数校验器:
(1)非字段校验:
<validator type="int"> <param name="fieldName">age</param> <param name="min">10</param> <param name="max">100</param> <message>年龄必须在在${min}到${max}之间</message> </validator>
(2)字段校验:
<field name="age"> <field-validator type="int"> <param name="min">10</param> <param name="max">100</param> <message>年龄必须在在${min}到${max}之间</message> </field-validator> </field>
8、正则表达式校验器:
(1)非字段校验:
<validator type="regex"> <param name="fieldName">myStrangePostcode</param> <param name="expression"><![CDATA[([aAbBcCdD][123][eEfFgG][456])]></param> </validator>
(2)字段校验:
<field name="myStrangePostcode"> <field-validator type="regex"> <param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param> <message>My credit limitshould be MORE than my girlfriend</message> </field-validator> </field>
expression:为必选参数,指定匹配有的表达式。
caseSensitive:指明进行匹配时,是否区分大小写,为可选参数,默认为true。
9、必填校验器:
(1)非字段校验:
<validator type="required"> <param name="fieldName">username</param> <message>用户名不能为空</message> </validator>
(2)字段校验:
<field name="username"> <field-validator type="required"> <message>用户名不能为空</message> </field-validator> </field>
10、必填字符串校验器:
(1)非字段校验:
<validator type="requiredstring"> <param name="fieldName">username</param> <param name="trim">true</param> <message>用户名不能为空</message> </validator>
(2)字段校验:
<field name="username"> <field-validato rtype="requiredstring"> <param name="trim">true</param> <message>用户名不能为空</message> </field-validator> </field>
trim:可选参数,用于指定是否在校验之前对字符串进行整理,默许为true。
11、字符串长度校验器:
(1)非字段校验:
<validator type="stringlength"> <param name="fieldName">username</param> <param name="minLength">4</param> <param name="maxLength">10</param> <message>用户名长度在${minLength}到${maxLength}之间</message> </validator>
(2)字段校验:
<field name="username"> <field-validato rtype="stringlength"> <param name="minLength">4</param> <param name="maxLength">10</param> <param name="trim">true</param> <message key="error.length.username"></message> </field-validator> </field>
12、网址校验器:
(1)非字段校验:
<validator type="url"> <param name="fieldName">myHomePage</param> <message>Invalid homepageurl</message> </validator>
(2)字段校验:
<field name="myHomePage"> <field-validator type="url"> <message>Invalid homepageurl</message> </field-validator> </field>
13、visitor校验器:
该校验器名称为:visitor,用来校验Action中定义的复合类型属性,支持简单的复合类型、数组类型、Map等集合类型。
(1)非字段校验:
<validator type="visitor"> <param name="fieldName">user</param> <param name="context">myContext</param> <param name="appendPrefix">true</param> </validator>
(2)字段校验:
<field name="user"> <field-validator type="visitor"> <param name="context">myContext</param> <param name="appendPrefix">true</param> </field-validator> </field>
如果想自定义一个自己的校验器,可以在Web工程的WEB-LIB\lib目录下增加一个validators.xml配置文件,在该文件中定义自己的校验器。
注意:如果使用validators.xml配置文件,则系统默认的default.xml配置文件不会加载,所以需要将default.xml的内容复制到validators.xml配置文件中。否则不能使用系统内建的校验器。