msg子元素支持三个属性,DTD定义如下:
<!ATTLIST msg name CDATA #IMPLIED
key CDATA #IMPLIED
resource CDATA #IMPLIED >
name 属性指定了msg将使用的校验规则名称,属性值必须是在validation-rules.xml 文件中定义的校验规则。
key 属性指定了一个资源文件的关键字,当校验失败是,该关键字所代表的信息将会添加到ActionError中。如果你想设置一个明确的文本而不是资源文件的关键字,则可以将resource属性设置位false,这种情况下,可以将key属性设置为一个明确的文本,如“电话格式不正确!”。
field元素可以包含至多四个额外的子元素,它们分别命名为arg0, arg1, arg2和arg3,它们用来向提示信息中添加额外的信息,arg0定义了第一个可替换的值,arg1定义了第二个可替换的值,以此类推。每个arg元素支持三个属性,name, key和resource,其含义和之前我们看到的msg元素的同名属性含义一致。下面是一段应用arg元素的示例:
<field property="phone" depends="required,mask,minLength">
<arg0 key="registrationForm.firstname.displayname"/>
<arg1 name="minlength" key="${var:minLength}" resource="false"/>
<var>
<var-name>mask</var-name>
<var-value>${phone}</var-value>
</var>
<var>
<var-name>minLength</var-name>
<var-value>5</var-value>
</var>
</field>
field元素包含的最后一个子元素是var元素,field元素可以包含0到多个var元素,var 元素可以设置该field所用到的校验规则的参数,var-name参数名,var-value指定参数值。例如设置mask规则的具体的正则表达式:
<var-name>mask</var-name>
<var-value>${phone}</var-value>
设置minLength规则的最小长度:
<var-name>minLength</var-name>
<var-value>5</var-value>
当然,这个参数可以被arg元素应用,应用语法为:${var:var-name}。
1.1.1.1.1.1 插入Validator
每一个Struts应用需要知道是否使用了Validator框架,可以通过PlugIn(插件)机制将Validator框架配置到Struts应用中。
下面的代码演示了如何将Validator作为一个插件加入到Struts应用中,在Struts应用的配置文件Struts-config.xml中加入如下代码片段:
<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
<set-property
property="pathnames"
value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml"/>
</plug-in>
粗体部分pathnames属性的值用来指定Validator框架所使用的配置文件,多个配置文件之间用逗号分隔。
当应用启动的时候,Struts框架将调用ValidatorPlugIn的init()方法。Validator框架的配置文件将会加载到内存中供应用使用。在init()方法被调用之前,pathnames所指定的值将会传递给ValidatorPlugIn的实例,ValidatorPlugIn实例将会依据这个值去加载配置文件。
1.1.1.2 使用带校验的ActionForm
你不能使用标准的Struts ActionForm去和Validator配合使用。你必须使用专门为Validator框架设计的ActionForm的子类。现在有两个子类可以选择,取决于你是否打算使用动态ActionForms。下面的图直观地显示了ActionForm以及它的后代:
如果你打算使用动态ActionForm,为了和Validator框架配合使用,你可以使用DynaValidatorForm,否则,可以使用ValidatorForm。从图上看出,DynaValidatorForm有个子类叫做DynaValidatorActionForm,ValidatorForm有个子类叫做ValidatorActionForm,这两个子类在其父类的名字中间加了个“Action”,这两个类有什么作用呢?
同样,根据你是否打算使用动态ActionForm,你可以使用DynaValidatorActionForm或ValidatorActionForm,来配合使用Validator框架,当使用这两个类时,它们将action的path属性传递给Validator,Validator使用action的名字去查找使用的校验规则。而使用DynaValidatorForm和ValidatorForm,则是使用的ActionForm 的name属性去查找匹配校验规则。(???)