Struts2的输入验证

时间:2025-04-26 09:37:20

一、概述:

① Struts2的输入验证
–基于 XWorkValidation Framework的声明式验证:Struts2提供了一些基于
XWork Validation Framework的内建验证程序.使用这些验证程序不需要编程,
只要在一个 XML
文件里对验证程序应该如何工作作出声明就可以了.需要声明的内容包括:
  •哪些字段需要进行验证
  •使用什么验证规则
  •在验证失败时应该把什么样的出错消息发送到浏览器端
–编程验证:通过编写代码来验证用户输入

二、Struts2的声明式验证:

①  声明式验证程序可以分为两类:
–字段验证: 判断某个字段属性的输入是否有效
–非字段验证:
 不只针对某个字段,而是针对多个字段的输入值之间的逻辑关系进行校验。例如:对再次输入密码的判断。
②  使用一个声明式验证程序需要3
个步骤:
      –1. 确定哪些Action字段需要验证
      –2. 编写一个验证程序配置文件.它的文件名必须是以下两种格式之一:
            •若一个 Action类的多个action使用同样的验证规则:ActionClassName-validation.xml
            •若一个 Action类的多个action使用不同的验证规则:ActionClass-alias-validation.xml,例如
UserAction-User_create-validation.xml
      –3. 确定验证失败时的响应页面:在
struts.xml 文件中定义一个
<result name=“input”>的元素.

③ Struts2的一些内建验证规则:

      •conversion validator:转换验证器
      •date validator:日期验证器
      •double validator:浮点验证器
      •email validator:email验证器
      •expression validator:表达式验证器
      •fieldexpressionvalidator:字段表达式验证器
      •intvalidator:整型验证器
      •regexvalidator:正则表达式验证器
      •required validator:非空验证器
      •requiredstringvalidator:非空字符串验证器
      •stringlengthvalidator:字符串长度验证器
      •urlvalidator:url格式验证器
     •visitor validator:复合属性验证器

④  一个简单的字段验证声明:

<!-- 待验证字段名称为username -->
<field name="username">
<!-- 使用非空验证器 -->
<field-validator type="requiredstring">
<param name="trim">true</param>
<!-- 错误提示消息 -->
<message>必须输入用户名</message>
</field-validator>
<!-- 使用正则验证器 -->
<field-validator type="regex">
<param name="expression"><![CDATA[(\w{6,20})]]></param>
<message>用户名长度必须在6到20字符之间</message>
</field-validator>
</field>

⑤ 显示错误消息

a、若使用的是struts2的非simple主题,则自动显示错误消息

b、若使用的是simple主题,则需要 s:fielderror 标签或直接使用 EL 表达式(使用 OGNL)

${fieldErrors.age[0] }

     或者

    <s:fielderror fieldName="age"></s:fielderror>   推荐使用此方法

⑥  Struts2声明式验证的原理:

> Struts2 默认的拦截器栈中提供了一个 validation 拦截器

     > 每个具体的验证规则都会对应具体的一个验证器. 有一个配置文件把验证规则名称和验证器关联起来了. 而实际上验证的是那个验证器.

        该文件位于 com.opensymphony.xwork2.validator.validators 下的 default.xml

        <validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>

⑦  短路验证

若对一个字段使用多个验证器, 默认情况下会执行所有的验证. 若希望前面的验证器验证没有通过, 后面的就不再验证, 可以使用短路验证

<validator …/>元素和
<field-validator …/>元素可以指定一个可选的
short-circuit属性,该属性指定该验证器是否是短验证器,默认值为false。

<!-- 设置短路验证: 若当前验证没有通过, 则不再进行下面的验证 -->
<field-validator type="conversion" short-circuit="true">
<message>Conversion Error Occurred</message>
</field-validator> <field-validator type="int">
<param name="min">20</param>
<param name="max">60</param>
<message key="error.int"></message>
</field-validator>

⑧  不同的字段使用同样的验证规则, 而且使用同样的响应消息 ?

将错误消息配置在国际化资源文件中:

error.int=${getText(fieldName)} needs to be between ${min} and ${max}

age=年龄

count=数量

⑨  自定义验证器:

I.   定义一个验证器的类

    > 自定义的验证器都需要实现 Validator.

    > 可以选择继承 ValidatorSupport 或 FieldValidatorSupport 类

    > 若希望实现一个一般的验证器, 则可以继承 ValidatorSupport

    > 若希望实现一个字段验证器, 则可以继承 FieldValidatorSupport

    > 若验证程序需要接受一个输入参数, 需要为这个参数增加一个相应的属性,并提供对应的setter与getter方法

public class IDCardValidator extends FieldValidatorSupport {

	@Override
public void validate(Object object) throws ValidationException {
//1. 获取字段的名字和值
String fieldName = getFieldName();
Object value = this.getFieldValue(fieldName, object); //2. 验证
IDCard idCard = new IDCard();
boolean result = idCard.Verify((String)value); //3. 若验证失败, 则 ...
if(!result){
addFieldError(fieldName, object);
} } }

II.  在配置文件中配置验证器



    > 默认情况下下, Struts2 会在 类路径的根目录下加载 validators.xml 文件. 在该文件中加载验证器.

         该文件的定义方式同默认的验证器的那个配置文件: 位于 com.opensymphony.xwork2.validator.validators 下的 default.xml

         

    > 若类路径下没有指定的验证器, 则从 com.opensymphony.xwork2.validator.validators 下的 default.xml 中的验证器加载     



III. 使用: 和目前的验证器一样.

三、Struts2的编程式验证

Struts2提供了一个Validateable接口,可以使Action类实现这个接口以提供编程验证功能.
ActionSupport 类已经实现了Validateable接口