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

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

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

在与XXXAction同级的目录下,建立XXXAction-validation.xml，即为该Action的校验逻辑。

该校验XML的dtd格式文件

为https://www.360docs.net/doc/9512820575.html,/xwork/xwork-validator-1.0.2.dtd，具体内容可以展开下面的代码：

https://www.360docs.net/doc/9512820575.html,/xwork/xwork-validator-1.0.2.dtd

可以看到，数据校验XML的根元素下面可以包含两种子元素：field和validator

1、前者field 是针对字段进行的校验；

2、后者validator 是非字段或者说全局范围的校验。

在介绍完校验是怎么回事后，后面会简单比较一下两种校验方式的区别。

一、字段校验:(field)

先看个基本示例

true

4

10

password should be ${minLength} to ${maxLength} characters lon g.

有几个地方需要注意一下的。

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、全局校验不针对特定字段，先指定验证器，再来指定用该校验器校验那些字段。

基本示例如下：

username

true

4

10

password

password should be ${minLength} to ${maxLength} characters lon g.

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

很明显，如果页面中存在一些共性的验证要求，用这种方式就比针对字段的验证要方便。但这种方式可能不如前一种方式清晰易读。

上面这段话是错误的。

我原以为第二种验证器优先的方式可以一次验证多个field，但经验证struts(ver2.1.6)并不支持多个field的批量验证，只能一个一个写，比较遗憾。

两种验证方式可以混用。

三、其他问题

1、对多验证和跳转逻辑的支持

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

success.jsp

则校验文件的名字为XXXAction-newExcuteName-validation.xml

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

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

2、客户端校验

客户端校验是不安全的，但struts仍然提供了客户端的校验

方法是在中设置validate属性为true,如果该属性被设置，则struts不会在服务器端验证，取而代之的是在客户端生成Javascript代码。但这些Js代码功能较弱，灵活度也比较低，且不会刷新。因此不推荐使用。

其实struts的控件本身和一般的HTML控件一样，如果想做客户端验证，可以触发它们的onXXX()事件，和通常的HTML页面做法一样。