Struts2数据校验（2）--使用XWork检验框架实现校验

2．使用XWork检验框架实现校验

通过XWork的validator框架也可以进行Struts2的数据校验，使用XWork的validator框架实现数据校验，只需编写一个验证文件便可。

1.验证文件

验证文件由两种：一种是actionName-validation.xml，actionName是需要校验的Action的类名，且需要放到和该类相同的路径下，这种校验和validate()方法的作用相同；另一种是

actionName-methodName-validation.xml，actionName是需要校验的Action的类名，methodName是Action中某个业务处理方法的方法名，且需要放到和该类相同的路径下，这种校验和validateX()方法的作用相同。

2.校验配置

（1）字段校验方式（Field-validator）

采用字段验证方式时，field是作为基本的子元素。

l  validators：校验文件的根元素；

l  field：是validators元素下的元素，name属性指定了被校验的字段；

l  field-validator：field元素下的元素，type属性用来指定校验器的名称，每个field-validator元素都可以指定一个校验规则且每个field-validator属性都必须包含一个message元素；

l  message：field-validator元素下的必备元素，该元素指出校验出错后的提示信息；

l  param：field-validator元素下的元素，该元素指定了校验过程中使用到的参数。

示例如下：

<?xml version="1.0" encoding="GBK"?> <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"     "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">   <validators>     <field name="name">         <field-validator type="requiredstring">             <message>the name is requred!</message>         </field-validator>     </field>     <field name="age">         <field-validator type="int">             <param name="min">1</param>             <param name="max">150</param>             <message>the age must be from 1 to 150!</message>         </field-validator>     </field> </validators>

（2）非字段校验方式（Non-Field validator）

采用非字段校验方式时，validator元素是它的基本单位，每个validator元素指定一个校验规则。

l  validators：校验文件的根元素；

l  validator：validators元素下的元素，type属性指定了校验器的名称。一般情况下，该元素应该包含子元素<param name=”filedName”>以指定被校验的Action名。

l  param：validator元素下的元素。

示例如下：

<?xml version="1.0" encoding="GBK"?> <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.2//EN"     "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">   <validators>     <validator type="int">         <param name="fieldName">age</param>         <param name="min">1</param>         <param name="max">150</param>         <message>the age must be from 1 to 150!</message>     </validator>     <validator type="email">         <param name="fieldName">email_address</param>         <message>The eamil address you entered is not valid.</message>     </validator> </validators>

上面介绍的两种校验方式都可以达到同样的效果，只是格式针对的对象不同。字段校验方式主要针对字段和属性，使用这种方式在校验时，对任何一个字段都能够返回一个明确的消息；而非子段校验方式则是将字段有效的组合在一起，这种方式不能对一个字段返回一个明确的消息。

3.校验器（validator）

字段校验方式和非字段校验方式校验方式，都需要用到校验器，下面就介绍一些常用的校验器。

（1）      required校验器：要求指定的字段必须是非空的；

required字符校验方式：

<validators>     <field name="name">         <field-validator type="required">             <message>the name is required!</message>         </field-validator>     </field> </validators>

 

required非字符校验方式：

<validators> <validator type="required">         <param name="fieldName">name</param>         <message>the name is required!</message>     </validator> </validators>

 

（2）      requiredstring校验器：要求字段值必须非空且长度必须大于0；

requiredstring字符校验方式：

<validators>     <field name="name">         <field-validator type="requiredstring">             <message>the name is required!</message>         </field-validator>     </field> </validators>

 

requiredstring非字符校验方式：

<validators> <validator type="requiredstring">         <param name="fieldName">name</param>         <message>the name is required!</message>     </validator> </validators>

 

（3）      int校验器：整数校验器，可以指定字段的整数值必须在指定的范围内，需要标注min和max参数。（注：long、short和浮点数等校验器和int校验器类型）

int字符校验方式：

<validators>        <field name="age">         <field-validator type="int">             <param name="min">1</param>             <param name="max">150</param>             <message>the age must be from 1 to 150!</message>         </field-validator>     </field> </validators>

 

int非字符校验方式：

<validators>     <validator type="int">         <param name="fieldName">age</param>         <param name="min">1</param>         <param name="max">150</param>         <message>the age must be from 1 to 150!</message>     </validator> </validators>

 

（4）      date校验器：要求指定字段的日期在指定的范围内；

date字符校验方式：

<validators>     <field name="birthday">         <field-validator type="date">             <message>The date you entered is not valid.</message>         </field-validator>     </field> </validators>

 

date非字符校验方式：

<validators> <validator type="date">         <param name="fieldName">birthday</param>         <message>the name is requred!</message>     </validator> </validators>

 

（5）      email校验器：用来校验邮箱地址是否合法；

email字符校验方式：

<validators>     <field name=" email_address ">         <field-validator type=" email ">             <message> The eamil address you entered is not valid.</message>         </field-validator>     </field> </validators>

 

email非字符校验方式：

<validators>     <validator type="email">         <param name="fieldName">email_address</param>         <message>The eamil address you entered is not valid.</message>     </validator> </validators>

 

（6）      stringlength校验器：校验字段的长度必须在指定的范围内。

stringlength字符校验方式：

<validators>        <field name="name">         <field-validator type="stringlength">             <param name="minLength">6</param>             <param name="maxLength">20</param>             <message>the name must be from 6 to 20 char!</message>         </field-validator>     </field> </validators>

 

stringlength非字符校验方式：

<validators>     <validator type="stringlength">         <param name="fieldName">name</param>         <param name="minLength">6</param>         <param name="maxLength">20</param>         <message>the age must be from 6 to 20 char!</message>     </validator> </validators>

 

注释：如果想知道更多的校验器，可以找到位于xwork-2.0.4.jar压缩包中（ com.opensymphony.xwork2.validator.validators）有个文件default.xml ，该文件中定义了Struts2框架内建的校验器。default.xml文件定义了常用的校验器类型，如下：

<validators>     <validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>     <validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>     <validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/>     <validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>     <validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>     <validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/>     <validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/>     <validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/>     <validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/>     <validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/>     <validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/>     <validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/>     <validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/>     <validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>     <validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/>     <validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/> </validators>