http://terryjs.iteye.com/blog/805537
http://quicker.iteye.com/blog/1225471
五、 内建校验器
Struts 2 提供了大量的内建校验器,可以满足大部分应用校验需求。如果应用需要特别复杂的校验需求,开发者可以开发自己的校验器
1. 注册校验器
xwork-2.1.2.jar 文件 , com/opensymphony/xwork2/validator/validators 路径下有个 default.xml ,这个是 Struts 2 默认 的校验器注册文件
Xml代码
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
<!-- START SNIPPET: validators-default -->
<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="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<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>
<!-- END SNIPPET: validators-default -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
<!-- START SNIPPET: validators-default -->
<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="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<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>
<!-- END SNIPPET: validators-default -->
如果开发者开发了一个自己的校验器,则可以通过添加一个 validators.xml 文件 (放在 WEB-INF/classes 路径下) 来注册校验器。 validators.xml 内容 与 default.xml 相似。
注意: 如果 Struts 2 在 WEB-INF/classes 路径下 找到一个 validators.xml,则不会再加载系统默认的 default.xml 。因此,如果开发者提供了自己的校验器注册文件(validators.xml),一定要把 default.xml 文件里的内容全部复制到 validators.xml 中
2. 必填校验器
必填校验器名字是 required ,指定字段必须有值(非空)。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
非字段校验器风格:
Xml代码
<validators>
<validator type="required">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators>
<validators>
<validator type="required">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators> 字段校验器风格:
Xml代码
<validators>
<field name="username">
<field-validator type="required">
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
<validators>
<field name="username">
<field-validator type="required">
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
3. 必填字符串校验器
必填字符串校验器名字是: requiredstring ,要求字段值必须是非空且长度大于0,即不能是""。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
trim :是否在校验前截去前后空白,默认 true。
非字段校验器风格:
Xml代码
<validators>
<validator type="requiredstring">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators>
<validators>
<validator type="requiredstring">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="username">
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
<validators>
<field name="username">
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
4. 整数校验器
整数包括 int ,long 和 short ,该校验器要求字段的整数值必须在指定范围内。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
min :指定该属性最小值,可选,如果没有指定,则不检验最小值
max :指定该属性的最大值,可选,如果没有指定,则不检验最大值。
非字段校验器风格:
Xml代码
<validators>
<validator type="int">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">age</param>
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</validator>
</validators>
<validators>
<validator type="int">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">age</param>
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="age">
<field-validator type="int">
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</field-validator>
</field>
</validators>
<validators>
<field name="age">
<field-validator type="int">
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</field-validator>
</field>
</validators>
5. 日期校验器
日期校验器是 date ,要求字段的日期值必须在指定范围内。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
min :指定该属性最小值,可选,如果没有指定,则不检验最小值
max :指定该属性的最大值,可选,如果没有指定,则不检验最大值。
注意: 如果系统没有指定日期转换器,则默认使用 XWorkBasicConverter 完成日期转换。默认使用 struts.properties 里指定的 Locale,或者系统默认的 Locale 的 Date.SHORT 格式来进行日期转换
非字段校验器风格:
Xml代码
<validators>
<validator type="date">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">birth</param>
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</validator>
</validators>
<validators>
<validator type="date">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">birth</param>
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="birth">
<field-validator type="date">
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</field-validator>
</field>
</validators>
<validators>
<field name="birth">
<field-validator type="date">
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</field-validator>
</field>
</validators>
6. 表达式校验器
名字 expression ,它是个非字段校验器,即不可用在字段校验器风格的配置中。 该表达式校验器要求 OGNL 表达式返回 true,当返回 true 时,该校验通过;否则,就算校验没通过
参数:
expression : 该参数指定一个逻辑表达式,该逻辑表达式基于 ValueStack
进行求职,最后返回一个 boolean 值;当返回 true 时 通过,
否则校验失败
非字段校验器风格:
Xml代码
<validators>
<validator type="expression">
<!-- 指定校验表达式 -->
<param name="expression">....</param>
<!-- 指定校验失败的提示信息 -->
<message>Failed to meet Ognl Expression ....</message>
</validator>
</validators>
<validators>
<validator type="expression">
<!-- 指定校验表达式 -->
<param name="expression">....</param>
<!-- 指定校验失败的提示信息 -->
<message>Failed to meet Ognl Expression ....</message>
</validator>
</validators>
7. 字段表达式校验器
名字是 fieldexpression , 它要求指定字段满足一个逻辑表达式。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
expression : 该参数指定一个逻辑表达式,该逻辑表达式基于 ValueStack
进行求职,最后返回一个 boolean 值;当返回 true 时 通过,
否则校验失败
非字段校验器风格:
Xml代码
<validators>
<validator type="fieldexpression">
<param name="fieldName">pass</param>
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<!-- 指定校验失败的提示信息 -->
<message>密码必须和确认密码相等</message>
</validator>
</validators>
<validators>
<validator type="fieldexpression">
<param name="fieldName">pass</param>
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<!-- 指定校验失败的提示信息 -->
<message>密码必须和确认密码相等</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="pass">
<field-validator type="fieldexpression">
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<message>密码必须和确认密码相等</message>
</field-validator>
</field>
</validators>
<validators>
<field name="pass">
<field-validator type="fieldexpression">
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<message>密码必须和确认密码相等</message>
</field-validator>
</field>
</validators>
8. 邮件地址校验器
名字是 email ,它要求被检查字段的字符如果非空,则必须是合法的邮件地址。不过这个校验器其实就是基于正则表达式进行校验的,
系统的邮件地址正则表达式是 :
\\b(^[_A-Za-z0-9-](\\.[_A-Za-z0-9-])*@([A-Za-z0-9-])+((\\.com)|(\\.net)|(\\.org)|(\\.info)|(\\.edu)|(\\.mil)|(\\.gov)|(\\.biz)|(\\.ws)|(\\.us)|(\\.tv)|(\\.cc)|(\\.aero)|(\\.arpa)|(\\.coop)|(\\.int)|(\\.jobs)|(\\.museum)|(\\.name)|(\\.pro)|(\\.travel)|(\\.nato)|(\\..{2,3})|(\\..{2,3}\\..{2,3}))$)\\b
注意: 上面的正则表达式可能不能完全覆盖
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
非字段校验器风格:
Xml代码
<validators>
<validator type="email">
<param name="fieldName">email</param>
<!-- 指定校验失败的提示信息 -->
<message>邮件必须有效地址</message>
</validator>
</validators>
<validators>
<validator type="email">
<param name="fieldName">email</param>
<!-- 指定校验失败的提示信息 -->
<message>邮件必须有效地址</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="email">
<field-validator type="email">
<message>邮件必须有效地址</message>
</field-validator>
</field>
</validators>
<validators>
<field name="email">
<field-validator type="email">
<message>邮件必须有效地址</message>
</field-validator>
</field>
</validators>
9. 网址校验器
名称是 url , 它要求被检查字段的字符如果非空,则必须是合法的 URL 地址。这个也是基于正则表达式进行校验的。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
非字段校验器风格:
Xml代码
<validators>
<validator type="url">
<param name="fieldName">url</param>
<!-- 指定校验失败的提示信息 -->
<message>您的主页地址必须是有效的网址</message>
</validator>
</validators>
<validators>
<validator type="url">
<param name="fieldName">url</param>
<!-- 指定校验失败的提示信息 -->
<message>您的主页地址必须是有效的网址</message>
</validator>
</validators> 字段校验器风格:
Xml代码
<validators>
<field name="url">
<field-validator type="url">
<message>您的主页地址必须是有效的网址</message>
</field-validator>
</field>
</validators>
<validators>
<field name="url">
<field-validator type="url">
<message>您的主页地址必须是有效的网址</message>
</field-validator>
</field>
</validators>
10. Visitor 校验器
Visitor 校验器主要用于校验 Action 里的复合属性 ,例如:一个 Action 里包含了 User 类型的属性。
假设有下面的 Action 类:
Java代码
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class RegistAction extends ActionSupport
{
//Action里包含了一个User类型的参数
private User user;
//user属性的setter和getter方法
public void setUser(User user)
{
this.user = user;
}
public User getUser()
{
return (this.user);
}
}
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class RegistAction extends ActionSupport
{
//Action里包含了一个User类型的参数
private User user;
//user属性的setter和getter方法
public void setUser(User user)
{
this.user = user;
}
public User getUser()
{
return (this.user);
}
}
这种方式非常类似于前面介绍的驱动模型,即 User 类是一个最普通的 java 类,仅仅提供 4 个属性。
User 类
Java代码
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class User
{
private String name;
private String pass;
private int age;
private Date birth;
public void setName(String name)
{
this.name = name;
}
public void setPass(String pass)
{
this.pass = pass;
}
public void setAge(int age)
{
this.age = age;
}
public void setBirth(Date birth)
{
this.birth = birth;
}
public String getName()
{
return (this.name);
}
public String getPass()
{
return (this.pass);
}
public int getAge() {
return (this.age);
}
public Date getBirth()
{
return (this.birth);
}
}
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class User
{
private String name;
private String pass;
private int age;
private Date birth;
public void setName(String name)
{
this.name = name;
}
public void setPass(String pass)
{
this.pass = pass;
}
public void setAge(int age)
{
this.age = age;
}
public void setBirth(Date birth)
{
this.birth = birth;
}
public String getName()
{
return (this.name);
}
public String getPass()
{
return (this.pass);
}
public int getAge() {
return (this.age);
}
public Date getBirth()
{
return (this.birth);
}
}
为了 校验上面 RegistAction 的 User 属性 ,显然不能通过其他校验器完成,因为那些普通校验器都只能校验基本数据类型和字符串类型。此时,为了校验该 User 类型属性里的其他属性,则应该使用 Vistior 校验器
RegistAction-validation.xml
Xml代码
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验规则文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验规则文件的根元素 -->
<validators>
<!-- 指定校验user字段 -->
<field name="user">
<!-- 使用visitor校验器 -->
<field-validator type="visitor">
<!-- 指定校验规则文件的context -->
<param name="context">userContext</param>
<!-- 指定校验失败后提示信息是否添加下面前缀 -->
<param name="appendPrefix">true</param>
<!-- 指定校验失败的提示信息前缀 -->
<message>用户的:</message>
</field-validator>
</field>
</validators>
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验规则文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验规则文件的根元素 -->
<validators>
<!-- 指定校验user字段 -->
<field name="user">
<!-- 使用visitor校验器 -->
<field-validator type="visitor">
<!-- 指定校验规则文件的context -->
<param name="context">userContext</param>
<!-- 指定校验失败后提示信息是否添加下面前缀 -->
<param name="appendPrefix">true</param>
<!-- 指定校验失败的提示信息前缀 -->
<message>用户的:</message>
</field-validator>
</field>
</validators> 上面并未指定 User 类里各字段的校验规则。因此,必须为 User 类指定对应校验规则文件。
注意: 如果 appendPrefix = true 则表示校验失败的 message 中 ,会加上 “用户的:” 前缀 ,否则将不会添加前缀
默认情况下 ,该校验文件的规则文件名为 User-validation.xml ,因为配置了 Visitor 校验器时指定了 context 为 userContext,则该校验文件的文件名为 User-userContext-validation.xml。
User-userContext-validation.xml
Xml代码
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验配置文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验文件的根元素 -->
<validators>
<!-- 校验User属性的name属性 -->
<field name="name">
<!-- 指定name属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出name.requried对应的国际化信息 -->
<message key="name.requried"/>
</field-validator>
<!-- 指定name属性必须匹配正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出name.regex对应的国际化信息 -->
<message key="name.regex"/>
</field-validator>
</field>
<!-- 校验User属性的pass属性 -->
<field name="pass">
<!-- 指定pass属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出pass.requried对应的国际化信息 -->
<message key="pass.requried"/>
</field-validator>
<!-- 指定pass属性必须满足匹配指定的正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出pass.regex对应的国际化信息 -->
<message key="pass.regex"/>
</field-validator>
</field>
<!-- 指定User属性的age属性必须在指定范围内-->
<field name="age">
<field-validator type="int">
<param name="min">1</param>
<param name="max">150</param>
<!-- 如果校验失败,输出age.range对应的国际化信息 -->
<message key="age.range"/>
</field-validator>
</field>
<!-- 指定User属性的birth属性必须在指定范围内-->
<field name="birth">
<field-validator type="date">
<!-- 下面指定日期字符串时,必须使用本Locale的日期格式 -->
<param name="min">1900-01-01</param>
<param name="max">2050-02-21</param>
<!-- 如果校验失败,输出birth.range对应的国际化信息 -->
<message key="birth.range"/>
</field-validator>
</field>
</validators>
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验配置文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验文件的根元素 -->
<validators>
<!-- 校验User属性的name属性 -->
<field name="name">
<!-- 指定name属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出name.requried对应的国际化信息 -->
<message key="name.requried"/>
</field-validator>
<!-- 指定name属性必须匹配正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出name.regex对应的国际化信息 -->
<message key="name.regex"/>
</field-validator>
</field>
<!-- 校验User属性的pass属性 -->
<field name="pass">
<!-- 指定pass属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出pass.requried对应的国际化信息 -->
<message key="pass.requried"/>
</field-validator>
<!-- 指定pass属性必须满足匹配指定的正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出pass.regex对应的国际化信息 -->
<message key="pass.regex"/>
</field-validator>
</field>
<!-- 指定User属性的age属性必须在指定范围内-->
<field name="age">
<field-validator type="int">
<param name="min">1</param>
<param name="max">150</param>
<!-- 如果校验失败,输出age.range对应的国际化信息 -->
<message key="age.range"/>
</field-validator>
</field>
<!-- 指定User属性的birth属性必须在指定范围内-->
<field name="birth">
<field-validator type="date">
<!-- 下面指定日期字符串时,必须使用本Locale的日期格式 -->
<param name="min">1900-01-01</param>
<param name="max">2050-02-21</param>
<!-- 如果校验失败,输出birth.range对应的国际化信息 -->
<message key="birth.range"/>
</field-validator>
</field>
</validators>
从上面配置文件中可以看出,这个 User-userContext-validation.xml 文件的内容与之前校验 Action 的校验文件完全相同,通过这种方式就可以对 Action 里复合类型的属性进行校验了。
因为 Action 里的属性不再是基本数据类型,而是 User 类型的属性,则将 JSP 页面进行简单的修改:
regist.jsp
Html代码
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %>
<%@taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>请输入您的注册信息</title>
<meta name="website" content="http://www.crazyit.org" />
<s:head/>
</head>
<body>
<h3>请输入您的注册信息</h3>
<!-- 使用Struts 2标签库生成表单 -->
<s:form action="regist">
<!-- 使用s:textfield标签生成文本输入框 -->
<s:textfield label="用户名" name="user.name"/>
<s:password label="密码" name="user.pass"/>
<s:textfield label="年龄" name="user.age"/>
<s:textfield label="生日" name="user.birth"/>
<s:submit/>
</s:form>
</body>
</html>
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %>
<%@taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>请输入您的注册信息</title>
<meta name="website" content="http://www.crazyit.org" />
<s:head/>
</head>
<body>
<h3>请输入您的注册信息</h3>
<!-- 使用Struts 2标签库生成表单 -->
<s:form action="regist">
<!-- 使用s:textfield标签生成文本输入框 -->
<s:textfield label="用户名" name="user.name"/>
<s:password label="密码" name="user.pass"/>
<s:textfield label="年龄" name="user.age"/>
<s:textfield label="生日" name="user.birth"/>
<s:submit/>
</s:form>
</body>
</html>
11. 转换校验器
名称: conversion , 它检查被校验字段在类型转换过程中是否出现错误
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
repopulateField :指定当类型转换失败后,返回 input 页面时,类型转换
失败的表单域是否保留原来的错误输入。
非字段校验器风格:
Xml代码
<validators>
<validator type="conversion">
<param name="fieldName">age</param>
<param name="repopulateField">false</param>
<!-- 指定校验失败的提示信息 -->
<message>fail</message>
</validator>
</validators>
<validators>
<validator type="conversion">
<param name="fieldName">age</param>
<param name="repopulateField">false</param>
<!-- 指定校验失败的提示信息 -->
<message>fail</message>
</validator>
</validators> 字段校验器风格:
Xml代码
<validators>
<field name="age">
<field-validator type="conversion">
<param name="repopulateField">true</param>
<message>fail</message>
</field-validator>
</field>
</validators>
<validators>
<field name="age">
<field-validator type="conversion">
<param name="repopulateField">true</param>
<message>fail</message>
</field-validator>
</field>
</validators>
12. 字符串长度校验器
名称: stringlength ,它要求被校验字段的长度必须在指定范围内,否则校验失败。
参数
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
maxLength : 指定字段的最大长度。参数可选,不指定时,
最大长度不受 限制
minLength : 指定字段的最小长度。参数可选,不指定时,
最小长度不受限制
trim : 指定校验字段之前是否截断该字段前后空白。该参数可选,默认 true
非字段校验器风格:
Xml代码
<validators>
<validator type="stringlength">
<param name="fieldName">user</param>
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</validator>
</validators>
<validators>
<validator type="stringlength">
<param name="fieldName">user</param>
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="user">
<field-validator type="stringlength">
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</field-validator>
</field>
</validators>
<validators>
<field name="user">
<field-validator type="stringlength">
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</field-validator>
</field>
</validators>
13. 正则表达式校验器
名称: regex , 它检查被校验字段是否匹配一个正则表达式。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
expression :该参数是必须的,该参数指定匹配用的正则表达式
caseSensitive :该参数指明进行正则表达式匹配时,是否区分大小写。
参数可选,默认 true
非字段校验器风格:
Xml代码
<validators>
<validator type="regex">
<param name="fieldName">user</param>
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</validator>
</validators>
<validators>
<validator type="regex">
<param name="fieldName">user</param>
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="user">
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</field-validator>
</field>
</validators>
<validators>
<field name="user">
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</field-validator>
</field>
</validators>
14. 基于 Annotation 校验器
基于 Annotation 的输入校验实际上是 Struts 2 “零配件”特性的部分,它允许使用 Annotation 来定义每个字段应该满足的规则 ,Struts 2 在 com.opensymphony.xwork2.validator.annotations 包下提供了大量验证器 Annotation ,这些 Annotation 和前面介绍的验证器大致上一一对应 ,可以自行查看 API 文档
配置
1. 使用 @Validation()Annotation 修饰 Action 类
2. 使用验证器 Annotation 修饰 Action 里各属性对应的 setter 方法 。
下面我们在前面 I18NValidate 应用的基础上进行修改,将该应用的 WEB-INF\src\lee 路径下的校验规则文件删除 ,修改该路径下的 RegistAction.java 文件,通过注释指定各属性应该满足的规则 。修改后的 Action 如下:
Java代码
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.validator.annotations.*;
import java.util.*;
import java.util.regex.*;
import java.text.*;
//使用@Validation修饰Action类
@Validation()
public class RegistAction extends ActionSupport
{
private String name;
private String pass;
private int age;
private Date birth;
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "name.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "name.regex",message = "")
public void setName(String name)
{
this.name = name;
}
public String getName()
{
return (this.name);
}
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "pass.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "pass.regex",message = "")
public void setPass(String pass)
{
this.pass = pass;
}
public String getPass()
{
return (this.pass);
}
//使用Annotation指定整数范围校验规则
@IntRangeFieldValidator(message = "",
key = "age.range", min = "1", max = "150")
public void setAge(int age)
{
this.age = age;
}
public int getAge() {
return (this.age);
}
//使用Annotation指定日期范围校验规则
@DateRangeFieldValidator(message = "",
key = "birth.range", min = "1900/01/01", max = "2050/01/21")
public void setBirth(Date birth)
{
this.birth = birth;
}
public Date getBirth()
{
return (this.birth);
}
}
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.validator.annotations.*;
import java.util.*;
import java.util.regex.*;
import java.text.*;
//使用@Validation修饰Action类
@Validation()
public class RegistAction extends ActionSupport
{
private String name;
private String pass;
private int age;
private Date birth;
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "name.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "name.regex",message = "")
public void setName(String name)
{
this.name = name;
}
public String getName()
{
return (this.name);
}
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "pass.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "pass.regex",message = "")
public void setPass(String pass)
{
this.pass = pass;
}
public String getPass()
{
return (this.pass);
}
//使用Annotation指定整数范围校验规则
@IntRangeFieldValidator(message = "",
key = "age.range", min = "1", max = "150")
public void setAge(int age)
{
this.age = age;
}
public int getAge() {
return (this.age);
}
//使用Annotation指定日期范围校验规则
@DateRangeFieldValidator(message = "",
key = "birth.range", min = "1900/01/01", max = "2050/01/21")
public void setBirth(Date birth)
{
this.birth = birth;
}
public Date getBirth()
{
return (this.birth);
}
}
上面代码使用了验证器 Annotation 修饰了各属性的 setter 方法 。通过在 Action 中使用 Annotation 指定各字段应该满足的校验规则,就可以避免书写 XML 校验规则文件。
但是所有内容都被写入 java 代码中,会给后期维护带来一定困难
http://quicker.iteye.com/blog/1225471
五、 内建校验器
Struts 2 提供了大量的内建校验器,可以满足大部分应用校验需求。如果应用需要特别复杂的校验需求,开发者可以开发自己的校验器
1. 注册校验器
xwork-2.1.2.jar 文件 , com/opensymphony/xwork2/validator/validators 路径下有个 default.xml ,这个是 Struts 2 默认 的校验器注册文件
Xml代码
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
<!-- START SNIPPET: validators-default -->
<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="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<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>
<!-- END SNIPPET: validators-default -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
<!-- START SNIPPET: validators-default -->
<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="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<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>
<!-- END SNIPPET: validators-default -->
如果开发者开发了一个自己的校验器,则可以通过添加一个 validators.xml 文件 (放在 WEB-INF/classes 路径下) 来注册校验器。 validators.xml 内容 与 default.xml 相似。
注意: 如果 Struts 2 在 WEB-INF/classes 路径下 找到一个 validators.xml,则不会再加载系统默认的 default.xml 。因此,如果开发者提供了自己的校验器注册文件(validators.xml),一定要把 default.xml 文件里的内容全部复制到 validators.xml 中
2. 必填校验器
必填校验器名字是 required ,指定字段必须有值(非空)。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
非字段校验器风格:
Xml代码
<validators>
<validator type="required">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators>
<validators>
<validator type="required">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators> 字段校验器风格:
Xml代码
<validators>
<field name="username">
<field-validator type="required">
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
<validators>
<field name="username">
<field-validator type="required">
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
3. 必填字符串校验器
必填字符串校验器名字是: requiredstring ,要求字段值必须是非空且长度大于0,即不能是""。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
trim :是否在校验前截去前后空白,默认 true。
非字段校验器风格:
Xml代码
<validators>
<validator type="requiredstring">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators>
<validators>
<validator type="requiredstring">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">username</param>
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="username">
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
<validators>
<field name="username">
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 指定校验失败的提示信息 -->
<message>username must not be null</message>
</field-validator>
</field>
</validators>
4. 整数校验器
整数包括 int ,long 和 short ,该校验器要求字段的整数值必须在指定范围内。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
min :指定该属性最小值,可选,如果没有指定,则不检验最小值
max :指定该属性的最大值,可选,如果没有指定,则不检验最大值。
非字段校验器风格:
Xml代码
<validators>
<validator type="int">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">age</param>
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</validator>
</validators>
<validators>
<validator type="int">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">age</param>
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="age">
<field-validator type="int">
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</field-validator>
</field>
</validators>
<validators>
<field name="age">
<field-validator type="int">
<param name="min">20</param>
<param name="max">50</param>
<!-- 指定校验失败的提示信息 -->
<message>age needs to bo between ${min} and ${max}
</message>
</field-validator>
</field>
</validators>
5. 日期校验器
日期校验器是 date ,要求字段的日期值必须在指定范围内。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定 该参数
min :指定该属性最小值,可选,如果没有指定,则不检验最小值
max :指定该属性的最大值,可选,如果没有指定,则不检验最大值。
注意: 如果系统没有指定日期转换器,则默认使用 XWorkBasicConverter 完成日期转换。默认使用 struts.properties 里指定的 Locale,或者系统默认的 Locale 的 Date.SHORT 格式来进行日期转换
非字段校验器风格:
Xml代码
<validators>
<validator type="date">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">birth</param>
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</validator>
</validators>
<validators>
<validator type="date">
<!-- 指定需要校验的字段名 -->
<param name="fieldName">birth</param>
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="birth">
<field-validator type="date">
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</field-validator>
</field>
</validators>
<validators>
<field name="birth">
<field-validator type="date">
<param name="min">1990-01-01</param>
<param name="max">2010-01-01</param>
<!-- 指定校验失败的提示信息 -->
<message>Birthday must to bo between ${min} and ${max}</message>
</field-validator>
</field>
</validators>
6. 表达式校验器
名字 expression ,它是个非字段校验器,即不可用在字段校验器风格的配置中。 该表达式校验器要求 OGNL 表达式返回 true,当返回 true 时,该校验通过;否则,就算校验没通过
参数:
expression : 该参数指定一个逻辑表达式,该逻辑表达式基于 ValueStack
进行求职,最后返回一个 boolean 值;当返回 true 时 通过,
否则校验失败
非字段校验器风格:
Xml代码
<validators>
<validator type="expression">
<!-- 指定校验表达式 -->
<param name="expression">....</param>
<!-- 指定校验失败的提示信息 -->
<message>Failed to meet Ognl Expression ....</message>
</validator>
</validators>
<validators>
<validator type="expression">
<!-- 指定校验表达式 -->
<param name="expression">....</param>
<!-- 指定校验失败的提示信息 -->
<message>Failed to meet Ognl Expression ....</message>
</validator>
</validators>
7. 字段表达式校验器
名字是 fieldexpression , 它要求指定字段满足一个逻辑表达式。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
expression : 该参数指定一个逻辑表达式,该逻辑表达式基于 ValueStack
进行求职,最后返回一个 boolean 值;当返回 true 时 通过,
否则校验失败
非字段校验器风格:
Xml代码
<validators>
<validator type="fieldexpression">
<param name="fieldName">pass</param>
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<!-- 指定校验失败的提示信息 -->
<message>密码必须和确认密码相等</message>
</validator>
</validators>
<validators>
<validator type="fieldexpression">
<param name="fieldName">pass</param>
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<!-- 指定校验失败的提示信息 -->
<message>密码必须和确认密码相等</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="pass">
<field-validator type="fieldexpression">
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<message>密码必须和确认密码相等</message>
</field-validator>
</field>
</validators>
<validators>
<field name="pass">
<field-validator type="fieldexpression">
<param name="expression"><![CDATA[(pass == rpass) ]]></param>
<message>密码必须和确认密码相等</message>
</field-validator>
</field>
</validators>
8. 邮件地址校验器
名字是 email ,它要求被检查字段的字符如果非空,则必须是合法的邮件地址。不过这个校验器其实就是基于正则表达式进行校验的,
系统的邮件地址正则表达式是 :
\\b(^[_A-Za-z0-9-](\\.[_A-Za-z0-9-])*@([A-Za-z0-9-])+((\\.com)|(\\.net)|(\\.org)|(\\.info)|(\\.edu)|(\\.mil)|(\\.gov)|(\\.biz)|(\\.ws)|(\\.us)|(\\.tv)|(\\.cc)|(\\.aero)|(\\.arpa)|(\\.coop)|(\\.int)|(\\.jobs)|(\\.museum)|(\\.name)|(\\.pro)|(\\.travel)|(\\.nato)|(\\..{2,3})|(\\..{2,3}\\..{2,3}))$)\\b
注意: 上面的正则表达式可能不能完全覆盖
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
非字段校验器风格:
Xml代码
<validators>
<validator type="email">
<param name="fieldName">email</param>
<!-- 指定校验失败的提示信息 -->
<message>邮件必须有效地址</message>
</validator>
</validators>
<validators>
<validator type="email">
<param name="fieldName">email</param>
<!-- 指定校验失败的提示信息 -->
<message>邮件必须有效地址</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="email">
<field-validator type="email">
<message>邮件必须有效地址</message>
</field-validator>
</field>
</validators>
<validators>
<field name="email">
<field-validator type="email">
<message>邮件必须有效地址</message>
</field-validator>
</field>
</validators>
9. 网址校验器
名称是 url , 它要求被检查字段的字符如果非空,则必须是合法的 URL 地址。这个也是基于正则表达式进行校验的。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
非字段校验器风格:
Xml代码
<validators>
<validator type="url">
<param name="fieldName">url</param>
<!-- 指定校验失败的提示信息 -->
<message>您的主页地址必须是有效的网址</message>
</validator>
</validators>
<validators>
<validator type="url">
<param name="fieldName">url</param>
<!-- 指定校验失败的提示信息 -->
<message>您的主页地址必须是有效的网址</message>
</validator>
</validators> 字段校验器风格:
Xml代码
<validators>
<field name="url">
<field-validator type="url">
<message>您的主页地址必须是有效的网址</message>
</field-validator>
</field>
</validators>
<validators>
<field name="url">
<field-validator type="url">
<message>您的主页地址必须是有效的网址</message>
</field-validator>
</field>
</validators>
10. Visitor 校验器
Visitor 校验器主要用于校验 Action 里的复合属性 ,例如:一个 Action 里包含了 User 类型的属性。
假设有下面的 Action 类:
Java代码
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class RegistAction extends ActionSupport
{
//Action里包含了一个User类型的参数
private User user;
//user属性的setter和getter方法
public void setUser(User user)
{
this.user = user;
}
public User getUser()
{
return (this.user);
}
}
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class RegistAction extends ActionSupport
{
//Action里包含了一个User类型的参数
private User user;
//user属性的setter和getter方法
public void setUser(User user)
{
this.user = user;
}
public User getUser()
{
return (this.user);
}
}
这种方式非常类似于前面介绍的驱动模型,即 User 类是一个最普通的 java 类,仅仅提供 4 个属性。
User 类
Java代码
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class User
{
private String name;
private String pass;
private int age;
private Date birth;
public void setName(String name)
{
this.name = name;
}
public void setPass(String pass)
{
this.pass = pass;
}
public void setAge(int age)
{
this.age = age;
}
public void setBirth(Date birth)
{
this.birth = birth;
}
public String getName()
{
return (this.name);
}
public String getPass()
{
return (this.pass);
}
public int getAge() {
return (this.age);
}
public Date getBirth()
{
return (this.birth);
}
}
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import java.util.*;
import java.util.regex.*;
import java.text.*;
public class User
{
private String name;
private String pass;
private int age;
private Date birth;
public void setName(String name)
{
this.name = name;
}
public void setPass(String pass)
{
this.pass = pass;
}
public void setAge(int age)
{
this.age = age;
}
public void setBirth(Date birth)
{
this.birth = birth;
}
public String getName()
{
return (this.name);
}
public String getPass()
{
return (this.pass);
}
public int getAge() {
return (this.age);
}
public Date getBirth()
{
return (this.birth);
}
}
为了 校验上面 RegistAction 的 User 属性 ,显然不能通过其他校验器完成,因为那些普通校验器都只能校验基本数据类型和字符串类型。此时,为了校验该 User 类型属性里的其他属性,则应该使用 Vistior 校验器
RegistAction-validation.xml
Xml代码
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验规则文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验规则文件的根元素 -->
<validators>
<!-- 指定校验user字段 -->
<field name="user">
<!-- 使用visitor校验器 -->
<field-validator type="visitor">
<!-- 指定校验规则文件的context -->
<param name="context">userContext</param>
<!-- 指定校验失败后提示信息是否添加下面前缀 -->
<param name="appendPrefix">true</param>
<!-- 指定校验失败的提示信息前缀 -->
<message>用户的:</message>
</field-validator>
</field>
</validators>
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验规则文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验规则文件的根元素 -->
<validators>
<!-- 指定校验user字段 -->
<field name="user">
<!-- 使用visitor校验器 -->
<field-validator type="visitor">
<!-- 指定校验规则文件的context -->
<param name="context">userContext</param>
<!-- 指定校验失败后提示信息是否添加下面前缀 -->
<param name="appendPrefix">true</param>
<!-- 指定校验失败的提示信息前缀 -->
<message>用户的:</message>
</field-validator>
</field>
</validators> 上面并未指定 User 类里各字段的校验规则。因此,必须为 User 类指定对应校验规则文件。
注意: 如果 appendPrefix = true 则表示校验失败的 message 中 ,会加上 “用户的:” 前缀 ,否则将不会添加前缀
默认情况下 ,该校验文件的规则文件名为 User-validation.xml ,因为配置了 Visitor 校验器时指定了 context 为 userContext,则该校验文件的文件名为 User-userContext-validation.xml。
User-userContext-validation.xml
Xml代码
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验配置文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验文件的根元素 -->
<validators>
<!-- 校验User属性的name属性 -->
<field name="name">
<!-- 指定name属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出name.requried对应的国际化信息 -->
<message key="name.requried"/>
</field-validator>
<!-- 指定name属性必须匹配正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出name.regex对应的国际化信息 -->
<message key="name.regex"/>
</field-validator>
</field>
<!-- 校验User属性的pass属性 -->
<field name="pass">
<!-- 指定pass属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出pass.requried对应的国际化信息 -->
<message key="pass.requried"/>
</field-validator>
<!-- 指定pass属性必须满足匹配指定的正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出pass.regex对应的国际化信息 -->
<message key="pass.regex"/>
</field-validator>
</field>
<!-- 指定User属性的age属性必须在指定范围内-->
<field name="age">
<field-validator type="int">
<param name="min">1</param>
<param name="max">150</param>
<!-- 如果校验失败,输出age.range对应的国际化信息 -->
<message key="age.range"/>
</field-validator>
</field>
<!-- 指定User属性的birth属性必须在指定范围内-->
<field name="birth">
<field-validator type="date">
<!-- 下面指定日期字符串时,必须使用本Locale的日期格式 -->
<param name="min">1900-01-01</param>
<param name="max">2050-02-21</param>
<!-- 如果校验失败,输出birth.range对应的国际化信息 -->
<message key="birth.range"/>
</field-validator>
</field>
</validators>
<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验配置文件的DTD信息 -->
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<!-- 校验文件的根元素 -->
<validators>
<!-- 校验User属性的name属性 -->
<field name="name">
<!-- 指定name属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出name.requried对应的国际化信息 -->
<message key="name.requried"/>
</field-validator>
<!-- 指定name属性必须匹配正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出name.regex对应的国际化信息 -->
<message key="name.regex"/>
</field-validator>
</field>
<!-- 校验User属性的pass属性 -->
<field name="pass">
<!-- 指定pass属性必须满足必填规则 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 如果校验失败,输出pass.requried对应的国际化信息 -->
<message key="pass.requried"/>
</field-validator>
<!-- 指定pass属性必须满足匹配指定的正则表达式 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,25})]]></param>
<!-- 如果校验失败,输出pass.regex对应的国际化信息 -->
<message key="pass.regex"/>
</field-validator>
</field>
<!-- 指定User属性的age属性必须在指定范围内-->
<field name="age">
<field-validator type="int">
<param name="min">1</param>
<param name="max">150</param>
<!-- 如果校验失败,输出age.range对应的国际化信息 -->
<message key="age.range"/>
</field-validator>
</field>
<!-- 指定User属性的birth属性必须在指定范围内-->
<field name="birth">
<field-validator type="date">
<!-- 下面指定日期字符串时,必须使用本Locale的日期格式 -->
<param name="min">1900-01-01</param>
<param name="max">2050-02-21</param>
<!-- 如果校验失败,输出birth.range对应的国际化信息 -->
<message key="birth.range"/>
</field-validator>
</field>
</validators>
从上面配置文件中可以看出,这个 User-userContext-validation.xml 文件的内容与之前校验 Action 的校验文件完全相同,通过这种方式就可以对 Action 里复合类型的属性进行校验了。
因为 Action 里的属性不再是基本数据类型,而是 User 类型的属性,则将 JSP 页面进行简单的修改:
regist.jsp
Html代码
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %>
<%@taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>请输入您的注册信息</title>
<meta name="website" content="http://www.crazyit.org" />
<s:head/>
</head>
<body>
<h3>请输入您的注册信息</h3>
<!-- 使用Struts 2标签库生成表单 -->
<s:form action="regist">
<!-- 使用s:textfield标签生成文本输入框 -->
<s:textfield label="用户名" name="user.name"/>
<s:password label="密码" name="user.pass"/>
<s:textfield label="年龄" name="user.age"/>
<s:textfield label="生日" name="user.birth"/>
<s:submit/>
</s:form>
</body>
</html>
<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %>
<%@taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>请输入您的注册信息</title>
<meta name="website" content="http://www.crazyit.org" />
<s:head/>
</head>
<body>
<h3>请输入您的注册信息</h3>
<!-- 使用Struts 2标签库生成表单 -->
<s:form action="regist">
<!-- 使用s:textfield标签生成文本输入框 -->
<s:textfield label="用户名" name="user.name"/>
<s:password label="密码" name="user.pass"/>
<s:textfield label="年龄" name="user.age"/>
<s:textfield label="生日" name="user.birth"/>
<s:submit/>
</s:form>
</body>
</html>
11. 转换校验器
名称: conversion , 它检查被校验字段在类型转换过程中是否出现错误
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
repopulateField :指定当类型转换失败后,返回 input 页面时,类型转换
失败的表单域是否保留原来的错误输入。
非字段校验器风格:
Xml代码
<validators>
<validator type="conversion">
<param name="fieldName">age</param>
<param name="repopulateField">false</param>
<!-- 指定校验失败的提示信息 -->
<message>fail</message>
</validator>
</validators>
<validators>
<validator type="conversion">
<param name="fieldName">age</param>
<param name="repopulateField">false</param>
<!-- 指定校验失败的提示信息 -->
<message>fail</message>
</validator>
</validators> 字段校验器风格:
Xml代码
<validators>
<field name="age">
<field-validator type="conversion">
<param name="repopulateField">true</param>
<message>fail</message>
</field-validator>
</field>
</validators>
<validators>
<field name="age">
<field-validator type="conversion">
<param name="repopulateField">true</param>
<message>fail</message>
</field-validator>
</field>
</validators>
12. 字符串长度校验器
名称: stringlength ,它要求被校验字段的长度必须在指定范围内,否则校验失败。
参数
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
maxLength : 指定字段的最大长度。参数可选,不指定时,
最大长度不受 限制
minLength : 指定字段的最小长度。参数可选,不指定时,
最小长度不受限制
trim : 指定校验字段之前是否截断该字段前后空白。该参数可选,默认 true
非字段校验器风格:
Xml代码
<validators>
<validator type="stringlength">
<param name="fieldName">user</param>
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</validator>
</validators>
<validators>
<validator type="stringlength">
<param name="fieldName">user</param>
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="user">
<field-validator type="stringlength">
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</field-validator>
</field>
</validators>
<validators>
<field name="user">
<field-validator type="stringlength">
<param name="minLength">4</param>
<param name="maxLength">20</param>
<message>fail</message>
</field-validator>
</field>
</validators>
13. 正则表达式校验器
名称: regex , 它检查被校验字段是否匹配一个正则表达式。
参数:
fieldName : 指定校验的 Action 属性名,如果采用校验器风格,
则无需指定该参数
expression :该参数是必须的,该参数指定匹配用的正则表达式
caseSensitive :该参数指明进行正则表达式匹配时,是否区分大小写。
参数可选,默认 true
非字段校验器风格:
Xml代码
<validators>
<validator type="regex">
<param name="fieldName">user</param>
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</validator>
</validators>
<validators>
<validator type="regex">
<param name="fieldName">user</param>
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</validator>
</validators>
字段校验器风格:
Xml代码
<validators>
<field name="user">
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</field-validator>
</field>
</validators>
<validators>
<field name="user">
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{4,20})]]></param>
<message>你的用户名长度必须在4到20之间,且必须是字母和数字</message>
</field-validator>
</field>
</validators>
14. 基于 Annotation 校验器
基于 Annotation 的输入校验实际上是 Struts 2 “零配件”特性的部分,它允许使用 Annotation 来定义每个字段应该满足的规则 ,Struts 2 在 com.opensymphony.xwork2.validator.annotations 包下提供了大量验证器 Annotation ,这些 Annotation 和前面介绍的验证器大致上一一对应 ,可以自行查看 API 文档
配置
1. 使用 @Validation()Annotation 修饰 Action 类
2. 使用验证器 Annotation 修饰 Action 里各属性对应的 setter 方法 。
下面我们在前面 I18NValidate 应用的基础上进行修改,将该应用的 WEB-INF\src\lee 路径下的校验规则文件删除 ,修改该路径下的 RegistAction.java 文件,通过注释指定各属性应该满足的规则 。修改后的 Action 如下:
Java代码
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.validator.annotations.*;
import java.util.*;
import java.util.regex.*;
import java.text.*;
//使用@Validation修饰Action类
@Validation()
public class RegistAction extends ActionSupport
{
private String name;
private String pass;
private int age;
private Date birth;
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "name.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "name.regex",message = "")
public void setName(String name)
{
this.name = name;
}
public String getName()
{
return (this.name);
}
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "pass.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "pass.regex",message = "")
public void setPass(String pass)
{
this.pass = pass;
}
public String getPass()
{
return (this.pass);
}
//使用Annotation指定整数范围校验规则
@IntRangeFieldValidator(message = "",
key = "age.range", min = "1", max = "150")
public void setAge(int age)
{
this.age = age;
}
public int getAge() {
return (this.age);
}
//使用Annotation指定日期范围校验规则
@DateRangeFieldValidator(message = "",
key = "birth.range", min = "1900/01/01", max = "2050/01/21")
public void setBirth(Date birth)
{
this.birth = birth;
}
public Date getBirth()
{
return (this.birth);
}
}
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.validator.annotations.*;
import java.util.*;
import java.util.regex.*;
import java.text.*;
//使用@Validation修饰Action类
@Validation()
public class RegistAction extends ActionSupport
{
private String name;
private String pass;
private int age;
private Date birth;
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "name.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "name.regex",message = "")
public void setName(String name)
{
this.name = name;
}
public String getName()
{
return (this.name);
}
//使用Annotation指定必填、正则表达式两个校验规则
@RequiredStringValidator(type = ValidatorType.FIELD,
key = "pass.requried",message = "")
@RegexFieldValidator(type = ValidatorType.FIELD,
expression = "\\w{4,25}",key = "pass.regex",message = "")
public void setPass(String pass)
{
this.pass = pass;
}
public String getPass()
{
return (this.pass);
}
//使用Annotation指定整数范围校验规则
@IntRangeFieldValidator(message = "",
key = "age.range", min = "1", max = "150")
public void setAge(int age)
{
this.age = age;
}
public int getAge() {
return (this.age);
}
//使用Annotation指定日期范围校验规则
@DateRangeFieldValidator(message = "",
key = "birth.range", min = "1900/01/01", max = "2050/01/21")
public void setBirth(Date birth)
{
this.birth = birth;
}
public Date getBirth()
{
return (this.birth);
}
}
上面代码使用了验证器 Annotation 修饰了各属性的 setter 方法 。通过在 Action 中使用 Annotation 指定各字段应该满足的校验规则,就可以避免书写 XML 校验规则文件。
但是所有内容都被写入 java 代码中,会给后期维护带来一定困难