旅行的意义

 

Struts2 数据输入校验(2) —— XML验证

struts2提供了通过XML方式对输入数据进行验证的校验框架。

在与XXXAction同级的目录下,建立XXXAction-validation.xml，即为该Action的校验逻辑。
该校验XML的dtd格式文件为  http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd，具体内容可以展开下面的代码：

http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd

 
可以看到，数据校验XML的根元素<validator>下面可以包含两种 子元素：field和validator
1、前者field     是针对字段进行的校验；
2、后者validator 是非字段或者说全局范围的校验。
在介绍完校验是怎么回事后，后面会简单比较一下两种校验方式的区别。

一、字段校验:(field)
先看个基本示例

 

<validators>

    <field name="username">
        <field-validator type="requiredstring">
            <message key="error.username.required"/>
        </field-validator>
    </field>
        <field name="password">
               <field-validator type="stringlength">
            <param name="trim">true</param>
            <param name="minLength">4</param>
            <param name="maxLength">10</param>
            <message>password should be ${minLength} to ${maxLength} characters long.</message>
        </field-validator>
        </field>

</validators>

有几个地方需要注意一下的。
1、field-validator的type在哪里定义的？
struts2校验框架预设的类在包com.opensymphony.xwork2.validator.validators中,同一目录下的default.xml中定义了field-validator中type的名称和对应的处理类。

default.xml


其中，name是上面type需要引用的名字，而后面的class则是这些validator对应的类。这些类中大部分都是自解释的，其中fieldexpression比较特殊，它提供了一种多个field之间比较值的机制。

2、param的值又是在哪里找到的呢？
param中的name值在上述类中被定义为属性。譬如说在类com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator中（也就是stringLength对应的处理类），就定义了
boolean trim;
int minLength,maxLength;
及它们的get/set方法。

3、message的注意事项
(1)每个field都必须拥有一个message；message错误信息最后是以addFieldError实现的，也就是说是field一级的错误。
(2)message中可以引用param变量，引用格式为${param1},如上面的例子中对password验证失败的报错信息。
(3)message的内容可以放到全局i18n属性文件中，并在message中以key属性值指定，比如上面例子中对username验证失败的报错信息。

二、非字段校验/全局校验
全局校验和字段校验其实类似，使用的验证器也是那些。区别在于校验的方式和关注点不同：
1、字段校验先指定那个字段要校验，再指定用那些校验器来校验该字段；
2、全局校验不针对特定字段，先指定验证器，再来指定用该校验器校验那些字段。

 

基本示例如下：

<validators>

    <validator type="requiredstring" short-circuit="true">
        <param name="fieldName">username</param>
        <message key="error.field.required"/>
    </validator>
     <validator type="stringlength">
            <param name="trim">true</param>
            <param name="minLength">4</param>
            <param name="maxLength">10</param>
            <param name="fieldName">password</param>
            <message>password should be ${minLength} to ${maxLength} characters long.</message>
     </validator>        

</validators>

示例很简单，第一个validator是校验“不为空的字符串”，校验“用户名字段，第二个校验器校验“字符串长度6-10”，校验“密码两个字段。

很明显，如果页面中存在一些共性的验证要求，用这种方式就比针对字段的验证要方便。但这种方式可能不如前一种方式清晰易读。
上面这段话是错误的。
我原以为第二种验证器优先的方式可以一次验证多个field，但经验证struts(ver2.1.6)并不支持多个field的批量验证，只能一个一个写，比较遗憾。

两种验证方式可以混用。

三、其他问题
1、对多验证和跳转逻辑的支持
和《Struts2 数据输入校验(1) —— 函数验证 》中所说内容一样，校验框架也支持多验证和跳转逻辑。比如说在struts.xml文件中配置了

<action name="XXXAction" class="com.myspace.myname.XXXAction" method="newExcuteName">
      <result>success.jsp</result>
</action>

则校验文件的名字为XXXAction-newExcuteName-validation.xml
当然，在执行了上面的校验之后，如果存在XXXAction-validation.xml，则还会执行这个文件中定义的校验。

同时需要注意的是，如果该Action存在父类，则会先行执行父类的相应校验。


2、客户端校验
客户端校验是不安全的，但struts仍然提供了客户端的校验
方法是在<s:form>中设置validate属性为true,如果该属性被设置，则struts不会在服务器端验证，取而代之的是在客户端生成Javascript代码。但这些Js代码功能较弱，灵活度也比较低，且不会刷新。因此不推荐使用。
其实struts的控件本身和一般的HTML控件一样，如果想做客户端验证，可以触发它们的onXXX()事件，和通常的HTML页面做法一样。

posted on 2009-02-02 10:55 bacon 阅读(4734) 评论(0)  编辑  收藏 所属分类: J2EE


只有注册用户登录后才能发表评论。
网站导航:
 

导航

统计

常用链接

留言簿(1)

随笔分类

随笔档案

文章分类

搜索

最新评论

阅读排行榜

评论排行榜