4. 使用界面4.1. 配置文件下面是验证规则 xml 文件的元素关系图,我将挑选一些重要而又相对复杂的元素进行讲解。
图 1. 验证规则 xml 文件的元素关系图1. 元素 constant
"constant" 元素定义了"field"元素所使用的替换型参数的静态值。 "constant-name" 和 "constant-value" 元素分别表示这个静态值的引用标识和值
2. 元素 validator
这个"validator"元素定义了 formset 元素字段所能使用的 validatoraction 对象。
子元素javascript属性属性名可选性注释与缺省值namerequired验证对象的标识classnamerequired验证对象的完全类名methodrequired用来实现这个验证的方法名methodParamsrequired验证方法的逗号隔开的参数类型列表msgrequired验证失败时使用的消息键depends.逗号隔开的这个验证所依赖的其他验证列表jsFunctionname3. 元素 formset
"formset" 定义了一个针对 locale 的 form 集 . "form"元素定义了有待验证的"field" 集,名字属性是应用程序分配给这个"form"的引用标识。
子元素constant form属性属性名可选性注释与缺省值language.locale 对象的语言部分country.locale 对象的国家部分variant.locale 对象的语言变种部分
4. 元素 field
"field" 元素定义了需要验证的属性,在 web 应用中,一个"field"对应于一个 HTML 表单控件。验证系统通过验证一个 JavaBean 来验证这个"field" 元素,这个元素可以接受 4 个属性:
子元素msg arg0 arg1 arg2 arg3 var属性属性名可选性注释与缺省值propertyrequired这个"field" 元素对应的 JavaBean 属性。depends.逗号隔开的 validatoraction 对象列表,所有的 validatoraction 对象验证通过,这个"field"才验证有效。page.JavaBean 可能有一个 page 属性,只有"page"属性小于或等于 JavaBean page 属性的"field" 元素才会被处理。这个机制对"向导"性的应用非常有用。
缺省值 [0] indexedListProperty."indexedListProperty"是一个返回数组或集合的方法。
5. 元素 msg
"msg" 元素定义了一个定制消息键,用来为验证失败的"field"提供消息文本。 当"field"没有子元素"msg" 元素时,每个 validatoraction 对象则使用自己的消息属性。
属性名可选性注释与缺省值name.对应于这个消息的 validatoraction 对象。key.消息资源文件中的消息键。resource.如果这个值为 "false","key"属性将是直接的消息文本。缺省值 [true]
6. 元素 arg0|arg1|arg2|arg3
这是 4 个参数元素,定义了 validator 或 field 消息模版中的 4 个替换值。比如 validator 的 msg 对应的消息资源是"必须提供 {0} 字段,而且字段的长度不能小于 {1} 字符! ",在显示错误的时候,其中 {0} 将被 arg0 的消息文本替换,而 {1} 将被 arg1 的消息文本替换。
属性名可选性注释与缺省值name.对应于这个消息的 validatoraction 对象。key.消息资源文件中的消息键。resource.如果这个值为 "false","key"属性将是直接的消息文本。缺省值 [true]
7. 元素 var
"field"能通过这个元素向某个 validatoraction 对象传递参数,这些参数也能被 arg? 元素通过语法 ${var:var-name} 引用。它的子元素 var-name 和 var-value 分别为变量标识和变量的值。 |