Struts 2 的验证框架（一）

<interceptor-ref name="params"/>
<interceptor-ref name="conversionError"/>
<interceptor-ref name="validation"/>
<interceptor-ref name="workflow"/>
`</pre>

我们需要注意validation拦截器，workflow拦截器调用validate()方法来实施基本验证还没有参与。当validation拦截器触发时，它会通过前一节提到的元数据实施所有已经定义的验证。一下是验证框架的工作流程，数据验证框架在数据转移、类型转换之后，workflow拦截器之前运行：

![验证框架的工作流程.png](http://moodpo.com/usr/uploads/2014/01/2669168693.png)

从图中可以看出整个流程有两个数据验证机制，一种是validation拦截器即数据验证框架的验证，一种是workflow调用validate()方法的验证。我们将会有两种选择，如果能够预测到一个验证逻辑将来还会被重用，那么使用一个自定义验证器来实现会更有意义。然而，如果验证逻辑确实是一个生僻的需求，并且很可能只适用于一次的情况，那么把它放在validate()方法中会更有意义。

### 2.将动作关联到验证框架

#### 2.1 使用ActionClass-validations.xml声明验证元数据

现在，我们呢使用XML文件声明需要验证的元数据，文件名以：动作类名+-+validations.xml为规范，以下是Register-validation.xml:

<pre>`&lt;!DOCTYPE validators PUBLIC &quot;-//OpenSymphony Group//XWork Validator 1.0.2//
    EN&quot; &quot;http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd&quot;&gt;
&lt;validators&gt;
    &lt;field name=&quot;password&quot;&gt;
        &lt;field-validator type=&quot;requiredstring&quot;&gt;
        &lt;message&gt;You must enter a value for password.&lt;/message&gt;
        &lt;/field-validator&gt;
    &lt;/field&gt;
    &lt;field name=&quot;username&quot;&gt;
        &lt;field-validator type=&quot;stringlength&quot;&gt;
        &lt;param name=&quot;maxLength&quot;&gt;8&lt;/param&gt;
        &lt;param name=&quot;minLength&quot;&gt;5&lt;/param&gt;
        &lt;message&gt;While ${username} is a nice name, a valid username must
                be between ${minLength} and ${maxLength} characters long.
        &lt;/message&gt;
        &lt;/field-validator&gt;
    &lt;/field&gt;
    &lt;field name=&quot;portfolioName&quot;&gt;
        &lt;field-validator type=&quot;requiredstring&quot;&gt;
        &lt;message key=&quot;portfolioName.required&quot;/&gt;
        &lt;/field-validator&gt;
    &lt;/field&gt;
    &lt;field name=&quot;email&quot;&gt;
        &lt;field-validator type=&quot;requiredstring&quot;&gt;
        &lt;message&gt;You must enter a value for email.&lt;/message&gt;
        &lt;/field-validator&gt;
        &lt;field-validator type=&quot;email&quot;&gt;
        &lt;message key=&quot;email.invalid&quot;/&gt;
        &lt;/field-validator&gt;
    &lt;/field&gt;
    &lt;validator type=&quot;expression&quot;&gt;
        &lt;param name=&quot;expression&quot;&gt;username != password&lt;/param&gt;
        &lt;message&gt;Username and password can't be the same.&lt;/message&gt;
    &lt;/validator&gt;
&lt;/validators&gt;
`</pre>

**1.字段验证器**

字段验证器是用来操作一个独立字段的验证器。这里的字段(field)与数据属性意思相同，字段验证器中的“字段”的含义是它们来源于请求的HTML表单的字段。

例如第一个字段password字段，一旦为数据声明了一个field元素，我们只需在field元素内部放入field-validator元素来声明哪些验证器用来验证此数据。对于password，我们只声明了一个requiredstring验证器。message元素包含验证失败时显示的消息的文本。一个field元素可以声明任意多个验证器。

**2.非字段验证器**

你也可以声明验证逻辑不是适用在某个特定字段的验证器，这些验证器适用于整个动作，通常包含对多个字段值的检查。例如：expression验证器就是如此。这个验证器使用OGNL比较其他两个字段是否相等，如果不相等表达式返回true，验证通过，否则，验证失败最终用户会返回输入页面并显示message元素中的内容。

**3.消息元素的选择**

message元素用来指定验证错误的情况下用户应该看到的消息，我们可以使用OGNL动态的组织消息。例如username字段的声明那样。XML中OGNL使用$作为转义字符，而不是OGNL通常使用的%符号。

message元素的另一个选择是将这些消息抽出到外部的资源文件中以实现验证错误的提示信息的国际化，portfolioName字段的验证方式是一个很好的示例，message 的 key 属性指向的正式国际化文件中的引用。如下：

<pre>`user.exists=This user ${username} already exists.
portfolioName.required=You must enter a name for your initial portfolio.
email.invalid=Your email address was not a valid email address.
`</pre>

#### 2.2 内建的验证器

框架自带了一系列功能强大的验证器以满足常见的验证需求，以下列出了全部的内建验证器：

<table class="table table-bordered table-striped table-condensed">
  <tr>
    <td>
      数据验证器
    </td>
    <td>
      参数
    </td>
    <td>
      功能
    </td>
    <td>
      类型
    </td>
  </tr>
  <tr>
    <td>
      required
    </td>
    <td>
      没有
    </td>
    <td>
      检验值非空
    </td>
    <td style="width:50px;">
      字段
    </td>
  </tr>
  <tr>
    <td>
      requiredstring
    </td>
    <td>
      trim(默认为true)
    </td>
    <td>
      验证值非空，并且不是空字符串
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      stringlength
    </td>
    <td>
      trim(默认值为true)、minLenth、maxLength
    </td>
    <td>
      验证字符床的长度在参数指定的范围内。不指定的参数不做检查。
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      int
    </td>
    <td>
      min、max
    </td>
    <td>
      验证这个证书值在参数指定的最小值和最大值之间
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      double
    </td>
    <td>
      minInclusive、maxInclusive、minExclusive、maxExclusive
    </td>
    <td>
      验证浮点值在参数指定的范围内
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      date
    </td>
    <td>
      min、max
    </td>
    <td>
      验证日期值在指定的最小值和最大值之间。日期格式MM/DD/YYYY
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      email
    </td>
    <td>
      没有
    </td>
    <td>
      验证电子邮件地址格式
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      url
    </td>
    <td>
      没有
    </td>
    <td>
      验证URL格式
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      fieldexpression
    </td>
    <td>
      expression(必须)
    </td>
    <td>
      根据当前ValueStack解析OGNL表达式。表达式必须返回true或者false以决定验证是否成功
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      expression
    </td>
    <td>
      expression(必须)
    </td>
    <td>
      与fieldexpression相同，但用在动作级别
    </td>
    <td>
      动作
    </td>
  </tr>
  <tr>
    <td>
      visitor
    </td>
    <td>
      context、appendPrefix
    </td>
    <td>
      将域对象属性的验证转交给域对象本地的验证声明
    </td>
    <td>
      字段
    </td>
  </tr>
  <tr>
    <td>
      regx
    </td>
    <td>
      expression(必须)、caseSensitive、trim
    </td>
    <td>
      验证String遵循给定的正则表达式
    </td>
    <td>
      字段
    </td>
  </tr>
</table>

这些数据验证器中的大部分功能都很简单，唯一需要深入讨论的是visitor验证器，这个验证器允许你为每一个域模型(ModelDriven)类定义验证元素据。

### 3.编写自定义验证器

编写自定义验证器与编写任何其他的Struts 2组件都不同，下面我们将通过编写一个检查密码完整性的自定义验证器。

#### 3.1 检查密码强度的自定义验证器

所有验证器必须实现Validator接口或者FieldValidator接口，前者将实现非字段验证器，后者将实现字段验证器。通常情况下我们会扩展对应的ValidatorSupport或者FieldValidatorSupport这两个类。

我们设计的密码验证器将做一下3项检查：