struts2 validator

---恢复内容开始---

这种方式就是使用validate框架来实现输入校验，这种方式是基于XML的验证。
文件名为XXXAction-validation.xml。
那么校验xml文件格式该如何写呢？
可以使用firefox查看此xml的DTD定义，地址为http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd
在此列出此DTD的内容
<?xml version="1.0" encoding="UTF-8"?>
<!--
XWork Validators DTD.
Used the following DOCTYPE.
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator 1.0.2//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd">
-->
<!ELEMENT validators (field|validator)+>
<!ELEMENT field (field-validator+)>
<!ATTLIST field
name CDATA #REQUIRED
>
<!ELEMENT field-validator (param*, message)>
<!ATTLIST field-validator
type CDATA #REQUIRED
short-circuit (true|false) "false"
>
<!ELEMENT validator (param*, message)>
<!ATTLIST validator
type CDATA #REQUIRED
short-circuit (true|false) "false"
>
<!ELEMENT param (#PCDATA)>
<!ATTLIST param
name CDATA #REQUIRED
>
<!ELEMENT message (#PCDATA)>
<!ATTLIST message
key CDATA #IMPLIED
>
由此DTD的定义可知，此XML文件的根元素为validators。
在根元素下可以有若干个field或validator子元素，即分别代表着字段校验和非字段校验，它们的区别将在后面介绍。

字段校验
字段校验代表着field，标签有个name属性石必填的，它和表单中的name属性值是一样的。
这里我填入username。
<validators>
<field name="username">
</field>
</validators>
field下面有个子元素叫field-validator，代表着要用什么方式来进行校验，其有个属性叫 type，也是必填的。

<validators>
<field name="username">
<field-validator type="">
</field-validator>
</field>
</validators>
type应该填入什么内容呢？
可以查看xwork的源文件，在包 com.opensymphony.xwork2.validator.validators下有个文件default.xml，在这个文件中定义了 type属性值。

<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>

 

还有很多定义好的type值，这里不一一列举
在validator元素中，name属性表示可以定义的type值，class 表示用哪个类来进行校验，这是struts2默认设置好的校验器，我们可以直接使用。
在这个例子中，我们将type设置为requiredstring

<validators>
<field name="username">
<field-validator type="requiredstring">
</field-validator>
</field>
</validators>

 

在field-validator下面有两个子元素，param和message
param可以任意个，可有可无，但是message有且只有一个。
param表示传入的参数，message表示出错时显示的信息。也就是说message可以是任意的字符串，但是param却是特定的。
在继续之前还是看看 com.opensymphony.xwork2.validator.validators.RequiredStringValidator这个类的源代码。首先确定已经下载了源代码，并且在MyEclipse中关联了源代码，这是一个好习惯。
在这个类中有一个成员变量
private boolean doTrim = true;
因此，我们在param中要做的就是，将param元素的name属性设置为doTrim，值为true。

trim表示是否忽略空格，默认是true，因此在此也可以省略掉param元素。
其实在 field-validator元素中还有一个属性short-circuit，其默认值是false，表示的意思是短路，即前面验证失败，后面就不做验证了。
然而这仅仅只是一个校验条件，还是以 username为例，在上次的例子中，还要求username的长度要在6到10之间，因此，继续看default.xml文件
在其中找到这样一个元素
<validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>
从字面上可以看出是限制字符串长度的，因此查看这个实现类
它有3个成员变量：
private boolean doTrim = true;
private int maxLength = -1;
private int minLength = -1;
其中最主要的是maxLength和minLength分别代表最大长度和最小长度
因此在这个校验器中内容应该如下：

<field name="username">
<field-validator type="stringlength">
<param name="minLength">6</param>
<param name="maxLength">10&lr;/param>
<message>username should be between ${minLength} and ${maxLength}</message>
</field-validator>
</field>

 

有个问题就是
<validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>
<validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>
required和requiredstring有什么区别吗？
requiredstring是指这个字符串是必须的，而required表示这个字段是必须的，而没有指明这个字段是否必须是字符串。
因此对于字符串，可以使用requiredstring，而对于非字符串类型就必须使用required了。如在这个示例中的age，birthday。注意birthday是Date类型的，不是String。
还是回顾一下register2.jsp的页面内容。
body中的内容为：
<s:actionerror />
<s:form action="register2" theme="simple">
……
……
</s:form>
但是输入数据提交后，仍然显示的是以前的出错信息，并不是今天所设置的信息。
这就涉及到一些知识点了，因为校验框架产生的错误是fielderror，不会在actionerror中显示。
因此，需要将 theme="simple"去掉，并把那些表格标签页去掉，然后执行时会看到在username上方的错误信息。
还有一个问题就是validate校验框架和Action中validate方法是否冲突。
实际上虽然会使用框架验证，但是也会调用Action的validate方法，通过上面的显示结果应该可以清楚的看到，在表单上面集中的显示了actionerror。
但是如果把Action中的validate方法的出错信息add到field中会有什么效果呢？？
修改RegisterAction中validate方法，将 addActionError改为addFieldError。
当没有输入用户名时，会显示如下错误信息：
username should not be blank!
username invalid
为什么会显示这样的结果呢？？？
首先肯定的是在validate中增加的fielderror，和xml中不会冲突
即错误信息不会被覆盖，而是两者都有，而且先显示xml中定义的错误信息，然后才是validate中定义的错误信息。实际上是所有的xml执行完毕后，在执行validate。
为什么会产生这样的效果呢？？？那么你就必须知道fielderror到底是什么！继续查看源代码。
因为RegisterAction是继承的 ActionSupport，addFieldError是继承自ActionSupport，所以先看看ActionSupport中 addFieldError的实现方法。
在 ActionSupport中addFieldError是这么实现的，
public void addActionError(String anErrorMessage) {
validationAware.addActionError(anErrorMessage);
}
即通过调用validationAware对象的addActionError，而validationAware是 ValidationAwareSupport的一个实例，在ValidationAwareSupport中定义了fielderror是什么。

private Map>String, List<String>> fieldErrors;
public synchronized void addFieldError(String fieldName, String errorMessage) {
final Map<String, List<String>> errors = internalGetFieldErrors();
List<String> thisFieldErrors = errors.get(fieldName);
if (thisFieldErrors == null) {
thisFieldErrors = new ArrayList<String>();
errors.put(fieldName, thisFieldErrors);
}
thisFieldErrors.add(errorMessage);
}

 

通过源代码，可以看到fieldErrors实际上是一个Map>String, List<String>>。key是String类型的，而value是List<String>
而实际上这个List是通过ArrayList<String>来实现的，也就是说，key是String类型的，而value是ArrayList<String>。
虽然一个key只能对应一个value，但是在这里value并不是一个字符串，而是一个数组。所以错误信息不会被覆盖掉。
在ActionSupport类中存在一个方法getFieldErrors，按照方法名可以猜的出该方法返回的是fieldError这个数组，既然如此那么是否可以通过 getFieldErrors直接添加呢？？
List<String> list = new ArrayList<String>();
list.add("username should be between 6 and 10");
this.getFieldErrors().put("username",list);
虽然编译器没有报错，但是实际上是不行的。查看API文档：
getFieldErrors，其解释如下：
public Map<String,List<String>> getFieldErrors()
Description copied from interface: ValidationAware
Get the field specific errors associated with this action. Error messages should not be added directly here, as implementations are free to return a new Collection or an
Unmodifiable Collection.
注释：
这个方法返回与这个action相关的具体的fielderrors，错误信息不能直接从这里添加，执行结果返回一个新的集合或一个不可修改的集合
这是什么意思呢？看源代码，这个方法同样是在 ValidationAwareSupport中实现的。
public synchronized Map<String, List<String>> getFieldErrors() {
return new LinkedHashMap<String, List<String>>(internalGetFieldErrors());
}
由此可以看到该方法返回的是一个新的LinkedHashMap，只是一个拷贝，而不是原集合，所以这样直接添加是无法显示出来的。
那么何时使用validate验证框架，什么时候使用action中的 validate方法呢？
一般来说，简单验证可以使用 xml，复杂时用validate
前面讲到了 struts2的数据校验，那么为什么要有服务器校验？？拥有了客户端校验不是也行吗？？
服务端校验是必须的，即使有客户端校验。因为可以不通过browser访问web服务器！！强健的web应用要有客户端和服务器端的验证。
当然，struts2同样支持客户端验证。
要使用struts2的客户端校验，必须满足一下条件：
1.form的主题（theme）一定不能设置为simple
2.将struts2 form标签中validate属性设置为true
但是看到小时效果后就会发现，struts2生成的也是js代码，但是效果却很差，所以一般来说，使用struts2的服务器端校验，而客户端校验自己写。
struts2标签支持事件，可以像使用html标签一样使用。
同样用validate校验框架也应该可以使用局部校验：
当action中有多个方法时，需要在和action同目录下新建文件 XXXAction-XXX（方法名）-validation.xml
在实例化子类对象时，会先执行父类的全局校验，然后是局部校验，接着是子类的全局校验，然后是子类的局部校验，因此不要提供全局校验。
字段校验和非字段校验的区别
通俗点讲：
字段校验：校验谁，用什么方法
非字段校验：用什么校验，校验谁
非字段校验示例：

<validator type="requiredstring">
<param name="fieldName">username</param>
<message></message>
</validator>

 

其中tyoe="fieldName"是不变的。至于其他细节不在这里详细叙述。

 

 

 

 

*****************************************************