9．Visitor校验器

Visitor校验器主要用于检测Action里的复合属性，例如一个Action里包含了User类型的属性。假设有下面的Action类。

程序清单：codes\04\4.2\visitor\WEB-INF\src\org\crazyit\app\action\RegistAction.java

1. public class RegistAction extends ActionSupport  
2. {  
3.     //Action里包含了一个User类型的参数  
4.     private User user;  
5.     //user属性的setter和getter方法  
6.     public void setUser(User user)  
7.     {  
8.         this.user = user;   
9.     }  
10.     public User getUser()   
11.     {  
12.         return (this.user);   
13.     }  
14. }  

上面的User类是一个最普通的Java类，仅仅提供了4个属性，以及每个属性的setter和getter方法。该User类的代码片段如下。

程序清单：codes\04\4.2\visitor\WEB-INF\src\org\crazyit\app\domain\User.java

1. public class User  
2. {  
3.     //User类里包含的4个基本数据类型的属性  
4.     private String name;  
5.     private String pass;  
6.     private int age;  
7.     private Date birth;  
8.     //此处省略了4个属性的setter和getter方法  
9.     ...  
10. }  

为了校验上面RegistAction里的User属性，显然不能通过其他校验器完成，因为那些普通校验器都只能校验基本数据类型和字符串类型。此时，为了校验该User类型属性里的其他属性，则应该使用Visitor校验器。

下面给出校验RegistAction的校验规则文件。

程序清单：codes\04\4.2\visitor\WEB-INF\src\org\crazyit\app\action\RegistAction-validation.xml

 

1. <?xml version="1.0" encoding="GBK"?>  
2. <!-- 指定校验规则文件的DTD信息 -->  
3. <!DOCTYPE validators PUBLIC "  
4.     -//OpenSymphony Group//XWork Validator 1.0.3//EN"  
5.     "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">  
6. <!-- 校验规则文件的根元素 -->  
7. <validators>  
8.     <!-- 指定校验user字段 -->  
9.     <field name="user">  
10.         <!-- 使用Visitor校验器 -->  
11.         <field-validator type="visitor">  
12.             <!-- 指定校验规则文件的context -->  
13.             <param name="context">userContext</param>  
14.             <!-- 指定校验失败后提示信息是否添加下面前缀 -->  
15.             <param name="appendPrefix">true</param>  
16.             <!-- 指定校验失败的提示信息前缀 -->  
17.             <message>用户的：</message>  
18.         </field-validator>  
19.     </field>  
20. </validators>  

显然，上面的校验规则并未指定User类里各字段应该遵守怎样的校验规则。因此，我们还必须为User类指定对应的校验规则文件。在默认情况下，该校验文件的规则文件名为User-validation.xml，因为配置Visitor校验器时指定了context为userContext，则该校验文件的文件名为User-userContext-validation.xml（该文件不是放在与Action相同的路径，而是应该放在与User.class相同的路径）。该文件的代码如下。

程序清单：codes\04\4.2\visitor\WEB-INF\src\org\crazyit\app\domain\User-userContext-validation.xml

1. <?xml version="1.0" encoding="GBK"?>  
2. <!-- 指定校验配置文件的DTD信息 -->  
3. <!DOCTYPE validators PUBLIC   
4.     "-//OpenSymphony Group//XWork Validator 1.0.3//EN" 
5.     "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">  
6. <!-- 校验文件的根元素 -->  
7. <validators>  
8.     <!-- 校验User属性的name属性 -->  
9.     <field name="name">  
10.         <!-- 指定name属性必须满足必填规则 -->  
11.         <field-validator type="requiredstring">  
12.             <param name="trim">true</param>  
13.             <!-- 如果校验失败，输出name.requried对应的国际化信息 -->  
14.             <message key="name.requried"/>  
15.         </field-validator>  
16.         <!-- 指定name属性必须匹配正则表达式 -->  
17.         <field-validator type="regex">  
18.             <param name="expression"><![CDATA[(\w{
    4,25})]]></param>  
19.             <!-- 如果校验失败，输出name.regex对应的国际化信息 -->  
20.             <message key="name.regex"/>  
21.         </field-validator>  
22.     </field>  
23.     <!-- 校验User属性的pass属性 -->  
24.     <field name="pass">  
25.         <!-- 指定pass属性必须满足必填规则 -->  
26.         <field-validator type="requiredstring">  
27.             <param name="trim">true</param>  
28.             <!-- 如果校验失败，输出pass.requried对应的国际化信息 -->  
29.             <message key="pass.requried"/>  
30.         </field-validator>  
31.         <!-- 指定pass属性必须满足匹配指定的正则表达式 -->  
32.         <field-validator type="regex">  
33.             <param name="expression"><![CDATA[(\w{
    4,25})]]></param>  
34.             <!-- 如果校验失败，输出pass.regex对应的国际化信息 -->  
35.             <message key="pass.regex"/>  
36.         </field-validator>  
37.     </field>  
38.     <!-- 指定User属性的age属性必须在指定范围内-->  
39.     <field name="age">  
40.         <field-validator type="int">  
41.             <param name="min">1</param>  
42.             <param name="max">150</param>  
43.             <!-- 如果校验失败，输出age.range对应的国际化信息 -->  
44.             <message key="age.range"/>  
45.         </field-validator>  
46.     </field>  
47.     <!-- 指定User属性的birth属性必须在指定范围内-->  
48.     <field name="birth">  
49.         <field-validator type="date">  
50.             <!-- 下面指定日期字符串时，必须使用本Locale的日期格式 -->  
51.             <param name="min">1900-01-01</param>  
52.             <param name="max">2050-02-21</param>  
53.             <!-- 如果校验失败，输出birth.range对应的国际化信息 -->  
54.             <message key="birth.range"/>  
55.         </field-validator>  
56.     </field>  
57. </validators>  

从上面的配置文件中可以看出，这个User-userContext-validation.xml文件的内容与之前校验Action的校验文件完全相同，通过这种方式就可以对Action里复合类型的属性进行校验了。

因为Action里的属性不再是基本数据类型，而是User类型的属性，则将JSP页面进行简单的修改：将表单域直接绑定到user属性的属性。修改后JSP页面的表单部分代码如下：

1. <s:form action="registPro">  
2.     <s:textfield name="user.name" label="用户名"/>  
3.     <s:textfield name="user.pass" label="密码"/>  
4.     <s:textfield name="user.age" label="年龄"/>  
5.     <s:textfield name="user.birth" label="生日"/>  
6.     <s:submit value="注册"/>  
7. </s:form>  

在上面表单域的name属性中，指定了这些表单域的名字为user.pass、user.age等，这就意味着将这些属性直接绑定到Action实例的user属性的pass、age属性。

如果浏览者的输入不能通过输入校验，将看到如图4.18所示的页面。

 

 在图4.18中看到校验提示信息是：“用户名：必须输入名字”等。其中“用户的：”字符串是在配置Visitor校验器时指定的<message .../>元素的内容，如果我们指定appendPrefix属性值为true，则会在提示信息中增加该前缀，否则将不会添加该前缀。

10．转换校验器

转换校验器的名称是conversion，它检查被校验字段在类型转换过程中是否出现错误。它可以接受如下两个参数。

Ø  fieldName：该参数指定校验的Action属性名，如果采用字段校验器风格，则无须指定该参数。

Ø  repopulateField：该参数指定当类型转换失败后，返回input页面时，类型转换失败的表单域是否保留原来的错误输入。

采用非字段校验器配置风格时，该校验器的配置示例如下：

 

1. <validators>  
2.     <!-- 使用非字段校验器风格来配置转换校验器 -->  
3.     <validator type="conversion">  
4.         <!-- 指定需要校验的字段名:age -->  
5.         <param name="fieldName">age</param>  
6.         <!-- 指定类型转换失败后，返回输入页面不保留原来的错误输入 -->  
7.         <param name="repopulateField">false</param>  
8.         <!-- 指定校验失败的提示信息 -->  
9.         <message>你的年龄必须是一个整数</message>  
10.     </validator>  
11.     ..  
12. <validators>  

采用字段校验器配置风格时，该校验器的配置示例如下：

 

1. <validators>  
2.     <!-- 使用字段校验器风格来配置转换校验器，校验age属性 -->  
3.     <field name="age">  
4.         <field-validator type="conversion">  
5.             <!-- 指定类型转换失败后，返回输入页面依然保留原来的错误输入 -->  
6.             <param name="repopulateField">true</param>  
7.             <!-- 指定校验失败的提示信息 -->  
8.             <message>你的年龄必须是一个整数</message>  
9.         </ field-validator>  
10.         ...  
11.     </field>  
12.     ..  
13. <validators>  

11．字符串长度校验器

字符串长度校验器的名称是stringlength，它要求被校验字段的长度必须在指定的范围之内，否则就算校验失败。该校验器可以接受如下几个参数。

Ø  fieldName：该参数指定校验的Action属性名，如果采用字段校验器风格，则无须指定该参数。

Ø  maxLength：该参数指定字段值的最大长度，该参数可选，如果不指定该参数，则最大长度不受限制。

Ø  minLength：该参数指定字段值的最小长度，该参数可选，如果不指定该参数，则最小长度不受限制。

Ø  trim：指定校验该字段之前是否截断该字段值前后的空白。该参数可选，默认是true。

采用非字段校验器配置风格时，该校验器的配置示例如下：

1. <validators>  
2.     <!-- 使用非字段校验器风格来配置字符串长度校验器 -->  
3.     <validator type="stringlength">  
4.         <!-- 指定需要校验的字段名:user -->  
5.         <param name="fieldName">user</param>  
6.         <!-- 指定user属性字符串的最小长度 -->  
7.         <param name="minLength">4</param>  
8.         <!-- 指定user属性字符串的最大长度 -->  
9.         <param name="maxLength">20</param>  
10.         <!-- 指定校验失败的提示信息 -->  
11.         <message>你的用户名长度必须在4到20之间</message>  
12.     </validator>  
13.     ..  
14. <validators>  

采用字段校验器配置风格时，该校验器的配置示例如下：

1. <validators>  
2.     <!-- 使用字段校验器风格来配置字符串长度校验器，校验user属性 -->  
3.     <field name="user">  
4.         <field-validator type="stringlength">  
5.             <!-- 指定user属性字符串的最小长度 -->  
6.             <param name="minLength">4</param>  
7.             <!-- 指定user属性字符串的最大长度 -->  
8.             <param name="maxLength">20</param>  
9.             <!-- 指定校验失败的提示信息 -->  
10.             <message>你的用户名长度必须在4到20之间</message>  
11.         </ field-validator>  
12.         ...  
13.     </field>  
14.     ..  
15. <validators>  

12．正则表达式校验器

正则表达式校验器的名称是regex，它检查被校验字段是否匹配一个正则表达式。该校验器可以接受如下几个参数。

Ø  fieldName：该参数指定校验的Action属性名，如果采用字段校验器风格，则无须指定该参数。

Ø  expression：该参数是必需的，该参数指定匹配用的正则表达式。

Ø  caseSensitive：该参数指明进行正则表达式匹配时，是否区分大小写。该参数是可选的，默认是true。

采用非字段校验器配置风格时，该校验器的配置示例如下：

1. <validators>  
2.     <!-- 使用非字段校验器风格来配置正则表达式校验器 -->  
3.     <validator type="regex">  
4.         <!-- 指定需要校验的字段名:user -->  
5.         <param name="fieldName">user</param>  
6.         <!--指定匹配的正则表达式-->  
7.         <param name="expression"><![CDATA[(\w{
   4,20})]]></param>  
8.         <!-- 指定校验失败的提示信息 -->  
9.         <message>你的用户名长度必须在4到20之间，且必须是字母和数字</message>  
10.     </validator>  
11.     ...  
12. <validators>  

采用字段校验器配置风格时，该校验器的配置示例如下：

 

1. <validators>  
2.     <!-- 使用字段校验器风格来配置正则表达式校验器，校验user属性 -->  
3.     <field name="user">  
4.         <field-validator type="regex">  
5.             <!-- 指定匹配的正则表达式 -->  
6.             <param name="expression"><![CDATA[(\w{
   4,20})]]></param>  
7.             <!-- 指定校验失败的提示信息 -->  
8.             <message>你的用户名长度必须在4到20之间，且必须是字母和数字</message>  
9.         </ field-validator>  
10.         ...  
11.     </field>  
12.     ...  
13. <validators>