《研磨struts2》第十章 验证框架 之 10.4 内建验证器

10.4  内建验证器

10.4.1概述

Struts2的验证框架已经为我们建立了足够多的内建验证器，以满足不同的验证要求，接下来就来逐一学习这些内建的验证器。

       Struts2的内建验证器的声明文件被放置在xwork-core-2.1.6.jar文件中，其位置为/com/opensymphony/xwork2/validator/validators/default.xml，内容为：

 

java代码：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
        "-//OpenSymphony Group//XWork Validator Config 1.0//EN"
        "http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">

<!-- START SNIPPET: validators-default -->
<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>
<!--  END SNIPPET: validators-default -->

在这个文件中，每个内建验证器都以一个<validator>元素出现，其name属性为验证器的名字，而class属性为这个验证器的实现类。注意：在前面的配置中也接触到了<validator>元素，但是此<validator>元素是在定义一个验证器，而不是像前面那样，是在引用一个验证器。

10.4.2类型转换错误验证器(conversion)

conversion验证器用来验证类型转换时是否出错。如果一个类型为int的参数接到了“18a”这个字符串，conversion验证器就会报错。

       conversion验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.3整数验证器(int)

int验证器用来验证一个整数型参数是否在指定的范围内。如果一个已经被成功转换为int的属性不在验证器指定的范围内，int验证器就会报错。

       int验证器可以有两个参数：

• min用来指定可接受范围的最小值。
• max用来指定可接收范围的最大值。

注意：conversion验证器验证的是参数能不能被正确转化为整数，int验证器是在参数已经被正确的转化为整数之后，再考察它的范围。因此，如果想限制年龄文本框填入整数类型的数字，并且在18岁以上，需要先引用conversion验证器检查用户填入的是否是一个整数，然后再引用int验证器来检查用户填入的年龄是否大于等于18。

int验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.4短整数验证器(short)和长整数验证器(long)

short验证器和long验证器与int验证器非常相似，都是用来验证参数是否在指定范围之内，就不去赘述了。

       short验证器和long验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.5日期验证器(date)

date验证器用来验证一个日期型参数是否在指定的范围内。如果一个已经被成功转换为date的属性不在验证器指定的范围内，date验证器就会报错。

       date验证器可以有两个参数：

• min用来指定可接受范围的最小值。
• max用来指定可接收范围的最大值。

注意：指定日期范围的时候，需要使用统一的格式，比如用MM/DD/YYYY的格式等。

date验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.6双精度浮点验证器(double)

double验证器用来验证一个双精度浮点型参数是否在指定的范围内。如果一个已经被成功转换为double的属性不在验证器指定的范围内，double验证器就会报错。

       double验证器可以有四个参数：

• minInclusive用来指定可接受范围的最小值，包含给定值。
• maxInclusive用来指定可接收范围的最大值，包含给定值。
• minExclusive用来指定可接受范围的最小值，不包含给定值。
• maxExclusive用来指定可接收范围的最大值，不包含给定值。

double验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.7邮件验证器(email)

email验证器用来验证一个参数是否为邮箱地址。

email验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.8 URL验证器(url)

url验证器用来验证一个参数是否为合法的URL。

       url验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.9必填验证器(required)

required验证器用来验证一个参数是否不为null。

       required验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.10必填字符串验证器(requiredstring)

requiredstring验证器用来验证一个字符串参数是否非空，既不为null，且长度大于0。

       requiredstring验证器只有一个参数：

• trim：是否去掉字符串两边的空白，默认为true。

requiredstring验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.11字符串长度验证器(stringlength)

stringlength验证器用来验证一个字符串的长度是否在指定范围内。

stringlength验证器有三个参数：

• maxLength：字符串长度的最大值。
• minLength：字符串长度的最小值。
• trim：是否去掉字符串两边的空白，默认为true。

stringlength验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.12正则表达式验证器(regex)

regex验证器用来验证一个字符串是否符合一个正则表达式的要求。

       regex验证器有三个参数：

• expression：必填参数，正则表达式。
• caseSensitive：是否检查大小写。
• trim：是否去掉字符串两边的空白，默认为true。

regex验证器既可以用于字段验证器，又可以用于动作验证器。

10.4.13字段表达式验证器(fieldexpression)和表达式验证器(expression)

fieldexpression验证器中必须指定一个返回布尔值的ognl表达式，根据这个表达式的值来确定是否符合条件。

       fieldexpression验证器只有一个参数：

• expression：返回布尔值的ognl表达式，可以在这个ognl表达式中访问当前的值栈。

regex验证器既可以用于字段验证器，又可以用于动作验证器。

       表达式验证器(expression)与字段表达式验证器(fieldexpression)类似，同样使用expression参数来指定返回布尔值的ognl表达式，但是，只能用于动作验证器。

10.4.14访问者验证器(visitor)

visitor验证器用于验证Action中的复合属性，可以直接把验证信息放到域对象中去注册，这样就使得同包内的不同Action在验证同一个域对象时，不用注册重复的验证信息。

       vistior验证器有两个属性：

• context：引用的域对象验证信息文件上下文名。
• appendPrefix：是否在错误信息中添加<message>元素指定的前缀。

来示例一下，仍然要检查user.age大于等于18岁。保持Action不变，修改一下原来的验证信息文件，示例如下：

 

java代码：

<validators>
    <field name="user">
        <field-validator type="visitor">
            <param name="context">c1</param>
            <param name="appendPrefix">true</param>
            <message>用户</message>
        </field-validator>
    </field>
</validators>

上面的示例，在user字段上指定了一个visitor验证器，设置上下文的名称为c1，设置前缀为true，也就是说在发生错误的时候，要在c1上下文返回的错误信息前加上“用户”这个前缀。

       接下来新添一个上下文验证文件，其文件名为“字段的简单类名-上下文名-validation.xml”，比如现在要为user属性指定一个名为c1的上下文，所以文件名为UserModel-c1-validation.xml，放在与域对象同级的包内，即UserModel所在的包内，注意：不再是与Action同级的包内了，其内容示例为：

 

java代码：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
        "-//OpenSymphony Group//XWork Validator 1.0//EN"        "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">

<validators>
    <field name="age">
        <field-validator type="int">
            <param name="min">18</param>
            <message>年龄要大于等于18</message>
        </field-validator>
    </field>
</validators>

它的本质也是一个验证文件，与之前直接在RegisterAction-validation.xml直接写出对user.age的验证相比，没有本质上的区别，只是这个文件以UserModel类为验证的根，所以<field>元素的name属性直接写age就可以了，而不再是原来的user.age。至于使用验证器的方式和配置都不变，就不去赘述了。

 

私塾在线网站原创《研磨struts2》系列

转自请注明出处：【http://sishuok.com/forum/blogPost/list/0/4093.html】

欢迎访问http://sishuok.com获取更多内容