使用Validator校验数据

本文主要是介绍使用Validator校验数据，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

17.3 使用Validator校验数据

跟Struts 1.x一样，Struts 2也提供数据校验。这种数据校验是配置式的，既可以用XML配置，也可以用Java注解（@Annotation）配置。Struts 2提供了许多默认的校验器，例如数字校验器、电子邮件校验器等，配置一下即可使用。

17.3.1 使用XML配置数据校验Validator

使用XML配置时，需要在Action类所在的package内添加一个XML文件，文件名格式为Action类名-validation.xml或者Action类名-Action别名 -validation.xml。如果Action中有多个方法，一般使用后者。例如BookAction-addBook- validation.xml、BookAction-initAdd Book-validation.xml等。支持校验的Action必须实现Validateable接口，一般继承ActionSupport就可以了。

下面对addBook.action进行校验，首先将BookAction继承ActionSupport以支持校验。校验配置XML文件名应为BookAction-addBook- validation.xml，位置与BookAction.class位于同一个包下。添加书籍时，书籍名称与作者必须填写，如果填写了日期，日期格式必须正确，并位于指定的格式内。校验配置代码如下：

代码17.10 BookAction-addBook-validation.xml

<!DOCTYPE validators PUBLIC

"-//OpenSymphony Group//XWork Validator 1.0//EN"

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

<field-validator type="requiredstring">

<message>请输入书籍名称</message>

</field-validator>

</field>

<field-validator type="requiredstring">

<message>请输入书籍作者</message>

</field-validator>

</field>

<field-validator type="date">

</field-validator>

</field>

</validators>

配置完毕后，不需要更改任何的JSP代码。Struts 2的表单标签支持校验错误信息显示（而不用像Struts 1.x那样需要用<html:error />显式地调用）。如果数据校验失败，会转到input页面显示错误信息，因此action配置中要配置名为input的JSP页面。运行效果如图17.2所示。

图17.2 xml配置式校验

17.3.2 配置客户端Validator

以上校验是在服务器端完成的。Struts 2也支持客户端JavaScript校验。方法很简单，再将JSP的<struts:form>标签添加validate="true"属性即可。Struts 2的客户端校验与Struts 1不同，Struts 1使用了提示框显示错误信息，Struts 2抛弃了烦人的提示框，显示错误方式与服务器端校验完全一样。效果同图17.2。

%提示：客户端校验是通过JavaScript实现的，因此Struts 2会自动加载相应的JavaScript类库。

17.3.3 常用的Validator

本次校验只使用了requiredstring与date校验器。Struts 2自带许多的校验器，包括字符串校验器、数字校验器、字符长度校验器、日期校验器、URL校验器、电子邮件校验器等。如果都不能满足，还可以使用正则表达式校验，正则表达式校验基本上可以满足所有的情况。

常用的Struts 2内置的校验器见表17.1。

表17.1 Struts 2常用的校验器

校验器	作用
required	检查被校验域是否为null
requiredstring	检查被校验String是否为null或空，可选参数trim，在验证前对字符串执行trim操作
stringlength	检查被校验String的长度范围，可选参数trim、minLength、maxLength
int/double	检查输入是否为int/double，并且可判断数值范围，可选参数为min、max；minInclusive、maxInclusive、minExclusive、maxExclusive
date	检查date的范围，可选参数为min、max
email	检查输入是否为E-mail格式
url	检查输入是否为url格式
conversion	检查是否将出现数据转换错误
expression/fieldexpression	检查某个布尔表达式的值是否为true，后者绑定到某个字段上，参数为expression
visitor	使用预定义的validators进行验证，参数为context
regex	检查是否能匹配到正则表达式，参数为regex

17.3.4 使用@Java注解配置Validator

Struts 2也支持用Java注解配置数据校验。Action同样需要继承自ActionSupport类，并用@Validation注解，表示该Action需要数据校验。然后在方法上配置@Validations。@Validations可指定多条校验规则，具体的配置见下面的代码：

代码17.11 BookAction.java

package com.helloweenvsfei.struts2.action;

import org.apache.struts2.interceptor.validation.SkipValidation;

import com.opensymphony.xwork2.ActionSupport;

import com.opensymphony.xwork2.validator.annotations.DateRangeFieldValidator;

import com.opensymphony.xwork2.validator.annotations.RequiredStringValidator;

import com.opensymphony.xwork2.validator.annotations.Validation;

import com.opensymphony.xwork2.validator.annotations.Validations;

import com.opensymphony.xwork2.validator.annotations.ValidatorType;

@Validation // 标记为需要数据校验

public class BookAction extends ActionSupport { // 继承自ActionSupport

// 添加书籍页面

@Validations(

requiredStrings = {

@RequiredStringValidator(type = ValidatorType.SIMPLE, trim=true, fieldName = "book.name", message = "请输入书籍名称. _*"),

@RequiredStringValidator(type = ValidatorType.SIMPLE, trim=true, fieldName = "book.author", message = "请输入书籍作者. _*")

dateRangeFields = {@DateRangeFieldValidator(type = Validator Type.SIMPLE, fieldName = "book.publishedDate", min = "1900-01- 01", max = "2200-01-01", message = "日期必须大于 ${min} 小于 ${max}, 当前值为 ${book.publishedDate}.")}

)

public String add() {

bookList.add(book);

title = "<br/><br/>添加书籍成功<br/><br/>";

return "success";

}

@SkipValidation // 书籍列表，@SkipValidation跳过校验

public String list() {

return "list";

}

该配置与上面的XML配置是等价的。因为只对addBook.action进行校验，因此只在方法add()上添加了@Validations以及校验规则。其他不需要校验的方法需要加上@SlipValidation，否则也会被校验。

另外，使用@Validator时Struts 2默认的验证方式是全局验证模式，因此只能配置一种验证方式。如果要对同一个Action的两个方法配置两种不同的验证方式，需要重写Struts 2的默认拦截器。