J2EE系列之Struts2学习笔记（二十）--Struts2验证框架（自定义验证）

玩游戏的时候，我们说的脏话对方是看不到的；评论的时候如果评语中有敏感词汇也会评论失败；

上面的这种对于是否含有关键词的验证是无法用Struts自带的验证方法来实现的。好在Struts设计了自定义验证框架，使得我们可以自己定义验证器来验证含有关键词的语句。

首先看一下Struts2自带的验证器：打开Struts安装包里面的\src\xwork-core\src\test\resources下的validators.xml文件：

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE validators PUBLIC        "-//Apache Struts//XWork Validator Config 1.0//EN"        "http://struts.apache.org/dtds/xwork-validator-config-1.0.dtd"><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="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>

上面就是Struts2自带的验证器，看到这些应该不会感到陌生。上一篇博客RegisterAction-validation.xml文件中用到的验证器<field-validator>标签的type属性的取证就是上面的name属性值，这个值代表验证器的名称，后面class属性代表验证器的实体类。下面我们也会自定义一个验证器。

对于需要验证的输入，系统会首先到项目的根目录下的validators.xml文件中寻找对应的验证器，如果根目录下面没有找到就会到系统的validators.xml文件中去寻找。所以定义验证器的时候，一般把自定义的验证器放在工程的根目录下。

下面以一个例子来看一下自定义验证器的用法。

1.在上一个工程的基础上继续添加文件。

2.新建一个com.test.validators包，在这个包里面定义一个验证器类SensitiveWordValidators：

package com.test.validators;import com.opensymphony.xwork2.validator.ValidationException;import com.opensymphony.xwork2.validator.validators.FieldValidatorSupport;public class SensitiveWordValidators extends FieldValidatorSupport{@Overridepublic void validate(Object object) throws ValidationException {String fieldName = this.getFieldName();//得到系统输入的用户字段String value = (String) this.getFieldValue(fieldName, object);//获取用户输入的值if(!check(value)){this.addFieldError(fieldName, object);//添加错误信息}}public boolean check(String value){String sensitiveWords[] = {"操","你妈"};for(int i=0; i<sensitiveWords.length; i++){if(value.indexOf(sensitiveWords[i])>-1){return false;}}return true;}}

注意：验证器类要集成自FieldValidatorSupport这个类，并且实现validate方法。validate方法中首先获取到系统输入的用户字段，然后获取到用户输入的值value；通过check函数来判断用户的输入是否包含我们定义的敏感词汇。如果包含敏感词汇，则输出错误信息。

3.拷贝一个validators.xml文件到工程的根目录下，把我们自定义的拦截器添加到validators.xml文件中：

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE validators PUBLIC        "-//Apache Struts//XWork Validator Config 1.0//EN"        "http://struts.apache.org/dtds/xwork-validator-config-1.0.dtd"><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="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"/><validator name="sensitive" class="com.test.validators.SensitiveWordValidators"/></validators>

我们这里给我们自定义的拦截器取名为sensitive。

4.定义一个新的Action：ValidationAction

package com.test.action;import com.opensymphony.xwork2.ActionSupport;import com.test.model.User;public class ValidationAction extends ActionSupport{/** *  */private static final long serialVersionUID = 1L;private String name;public String getName() {return name;}public void setName(String name) {this.name = name;}@Overridepublic String execute() throws Exception {System.out.println("姓名："+name);return SUCCESS;}}

这里我们只是简单的定义了一个变量name；

5.定义这个Action要使用的验证规则文件：ValidationAction-validation.xml

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE validators PUBLIC "-//Apache Struts//XWork Validator 1.0.2//EN" "http://struts.apache.org/dtds/xwork-validator-1.0.2.dtd"><validators>    <field name="name">        <field-validator type="requiredstring">            <message>请输入姓名</message>        </field-validator>        <field-validator type="sensitive">        <message>有敏感词汇</message>        </field-validator>    </field>    </validators>

这里对ValidationAction的name变量使用的验证器包括requiredstring和我们自定义的sensitive。requiredstring验证器用于验证输name变量的值是否为空，如果为空则提示用户输入姓名；sensitive验证器用于验证用户输入的值是否包含敏感词汇。

6.修改struts.xml文件：

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE struts PUBLIC    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"    "http://struts.apache.org/dtds/struts-2.0.dtd"><struts><package name="manager" extends="struts-default"><action name="registerAction" class="com.test.action.RegisterAction"><result name="input">/register.jsp</result><result name="success">/success.jsp</result></action><action name="validationAction" class="com.test.action.ValidationAction"><result name="input">/validation.jsp</result><result name="success">/success.jsp</result></action></package></struts>

如果包含请求validationAction验证失败，则停留在validation.jsp页面。

7.运行程序：

输入“你妈的”，并点击提交：

可以看到，我们自定义的验证器成功了。