validation.xml文件是Validator框架需要的另一个配置文件。该文件是特定于应用程序的,由开发人员自己来创建。它描述了那些具体应用中的ActionForm所使用的validator-rules.xml文件中的有效性验证规则。通过ActionForm在validation.xml文件中配置所需要的验证规则,开发人员就不必将验证逻辑硬编码放在ActionForm的内部。一个简单的validation.xml文件如例程5-7所示。
例程5-7 validation.xml实例
|
validation.xml文件中包含form-validation、global、formset、form、field、msg、arg、var等元素。下面对它们一一进行介绍。
1.form-validation元素
2.global元素
global元素允许开发人员配置可以用在文件其他部分中的constant元素,也就是全局常量。这与在Java文件中定义一个常量,然后在类中使用该常量的方式相似。constant元素以名字和值的方式出现。例如:
|
在以上代码中,在
3.formset元素
4.form元素
form元素定义了一套将要进行有效性验证的域(field),其name属性指定对应表单的名字,并且name属性与Struts配置文件中的form-bean元素的name属性一致。
form元素可以包含多个field元素。
5.field元素
一个field元素对应于一个表单中需要验证的字段。它的属性如表5-3所示。
表5-3 field元素的属性
属 性 |
描 述 |
property |
将要进行有效性验证的ActionForm的属性名 |
depends |
指定字段的验证规则,多个规则之间以逗号分开 |
page |
如果对应的ActionForm是一个跨页表单,可能包括一个page属性与表单中的page属性相对应,用户指定该字段应该在哪一页被处理 |
indexedListProperty |
后循环列表,执行该域的有效性验证 |
6.msg元素
field元素的msg子元素指定验证规则对应的消息文本。该消息文本将替代默认的消息文本,即validator-rules.xml中定义的消息文本。msg元素的值必须是应用程序消息资源包中的某个消息资源的关键字。例如:
|
当lastName字段有效性验证失败时,显示的错误消息是消息资源中registerForm. lastname.masking键所指的消息文本。
msg元素的属性如表5-4所示。
表5-4 msg元素的属性
属 性 |
描 述 |
key |
指定绑定的消息资源中的消息文本或直接指定消息文本 |
name |
指定验证规则的名字 |
bundle |
指定绑定的消息资源的名称 |
resource |
当该属性值为true时,表示使用来自消息资源的消息文本;当该属性值为false时,表示直接在key属性中设置消息文本。默认值为true。 |
7.arg元素
arg元素可以用来向消息文本中传递参数。它有name、key、resource和position等几个属性,name、key、resource属性的含义与msg元素的属性相当。position属性用来指定消息文本中的替换位置。
例如,例程5-8是关于minlength验证规则的配置文件。
例程5-8 minlength验证规则的配置文件
|
在validator-rules.xml文件中,minlength验证规则的默认消息文本是:
{0} can not be less than {1} characters.
在例程5-8中,position属性的值为1的arg元素定义中,name属性的值为minlength,表示仅适用于minlength验证规则,resource属性的值为false,表示可直接在key属性中设定消息文本,即key属性的值为${var:minlength},在这里是3。把以上代码中两个arg的key值分别放入minlength验证规则的默认消息文本中的相应位置,最后返回的消息文本应该是:
password can not be less than 3 characters. |
8.var元素
var元素用来向验证规则传递参数。例如在例程5-7中,定义了maxlength和minlength两个参数,分别传递给maxlength和minlength验证规则。
arg元素也可以访问var元素,语法形式是${var:var-name}。例如,在例程5-7中的${var:maxlength}和${var:minlength}的使用。
9.
Action 中 :
ActionMessages message = new ActionMessages();
message.add(" 消息句柄 ",new ActionMessage(" 资源文件中 Key 值 ",String 类型描述信息 ));
this.addMessages(request,message);
return ActionForward;
JSP 页面中 :
例如:
Action方法中:
saveMessage(request,"页面要显示的消息");
Action的调用的方法,可以写真Action实现类的父类 BaseDispatchAction中:
public ActionMessages saveMessage(HttpServletRequest request, String key) {
ActionMessages messages = new ActionMessages();
return saveMessage(messages, request, key);
}
protected ActionMessages saveMessage(ActionMessages messages,
HttpServletRequest request, String key) {
messages.add(ActionMessages.GLOBAL_MESSAGE, new ActionMessage(key));
saveMessages(request, messages);
return messages;
}
页面:
Action 中 :
ActionMessages message = new ActionMessages();
message.add(" 消息句柄 ",new ActionMessage(" 资源文件中 Key 值 ",String 类型描述信息 ));
this.saveErrors(request,message);
return ActionForward;
JSP 页面中 :
如果Action中这样设定(false),页面的提示信息将不从资源文件里读取:
ActionMessages message = new ActionMessages();
message.add("消息句柄",new ActionMessage("String类型描述信息));",false));
this.saveErrors(request,message);
return ActionForward;
JSP页面:
10.