struts2输入校验详解

1. 代码形式实现输入校验

1.1. struts2执行流程

  1. 客户端向服务端发送HTTP请求

  2. Struts2框架通过StrutsPrepareAndExecuteFilter拦截请求

  3. 然后扫描struts.xml文件,找到并实例化该请求所对应的Action

  4. 对于HTTP请求的参数值进行类型转换以适配于Action中对应的属性类型(内建的类型转换器以及自定义的类型转换器在此时起作用)

  5. 类型转换成功的就自动进行赋值,类型转换失败的则不进行赋值(Action会以成员变量默认值为最终值),并且将错误信息写入到FieldError中

  6. 执行validate()校验方法

  7. validate()校验方法执行完后,如果发现存在错误不管是Action级别的还是Field级别的,那么都会直接跳转到该Action所对应的input视图中

  8. 如果没有存在错误,那么会执行execute方法,并跳转到对应的视图来显示结果

1.2. ActionError与FieldError底层实现

ActionError底层是通过ArrayList来实现的

FieldError底层是通过LinkedHashMap>来实现的

1.3. clearErrors()方法的作用

在validate()校验方法中执行该方法,可以将Action级别以及Field级别中的错误进行清除,这样可以让执行流程转向execute而不是跳转到input所对应的视图

1.4. 自定义类型转换错误信息

当类型转换出错的时候,struts2框架会向Field级别中添加错误信息,这些信息通常不符合我们的品味,因此我们需要自定义它

类型转换错误信息自定义方法:

在关联的Action包下新建一个配置文件,命名规则为Action.properties,内容为invalid.fieldvalue.字段名=自定义错误描述,例如:

invalid.fieldvalue.age=age invalid!

1.5. struts2标签库之表单使用

使用struts2提供的表单标签的话默认是post提交方式,传统的html表单默认是get提交方式

struts2提供的表单标签,默认支持回显功能,这可以大大减轻开发者的工作

struts2提供的表单标签中有一个重要属性theme,该属性通常设置为simple,这样struts2在后台帮我们生成的html代码就会比较干净,不会附带其它的td等html标记,并且不会将Field级别的错误信息自动显示出来

如果没有设置theme属性值的话,那么最终生成的html代码会比较复杂,并且会自动将Field级别的错误显示出来

显示action级别的错误信息的struts2标签为:

显示field级别的错误信息的struts2标签为:

具体使用情况可以参考如下代码:

struts2输入校验详解_第1张图片
struts标签库的使用.png
struts2输入校验详解_第2张图片
显示表单提交结果.png

1.6. ActionError与FieldError差异

Action级别的错误信息,通常是我们手动添加的,而Field级别的错误信息,有可能是我们手工加的,也有可能是框架在类型转换失败之后所添加的

2. 配置文件方式实现输入校验

2.1. struts2校验框架简介

struts2的校验框架是一个有效的xml文件,存放在与对应的Action同包下,命名规则为ActionName-validation.xml,它采用DTD来验证,它可以分为字段优先校验器与校验器优先校验器,为什么校验器分为字段优先与校验器优先两种呢?这是因为DTD中是如下声明元素的,校验功能最初由xwork提供

2.2. 字段优先校验器实现步骤

  1. 在对应的Action包下新建一个xml文件,命名为对应的ActionName-validation.xml (如果不知道xml的dtd,那么可以在struts2给我们提供的apps下的项目中去找,有了dtd就知道如何去编写对应的元素了)
  2. 根据自己的校验规则编写xml,例如下图所示:
struts2输入校验详解_第3张图片
sruts2字段优先校验.png

我们要知道一点,所谓的校验框架校验其实底层还是用代码来校验的,校验框架中field-validator元素的属性type值是从default.xml中选取的(default.xml位于com.opensymphony.xwork2.validator.validators包下),如下:

struts2输入校验详解_第4张图片
default.xml.png

其实对应的是一个个的java类,由这些java类最终来校验的,field-validator下的子元素param,其实配置的是这些java类对应的setXXX方法罢了

Tips: 对于stringlength而言,只有当值不为null且不为空格的情况下才会进行校验

2.3. 校验框架之国际化

struts2支持国际化,底层还是使用了JDK给我们提供的国际化API

实现步骤:

  1. 在校验文件(xml)中,对message元素的属性key指定一个通用的值,例如:
校验框架之国际化.png
  1. 在对应的Action包下,创建语言包(资源文件),这些资源文件的命名规则为package_语言名_国家名.properties,例如:
语言包.png
  1. 在各自的资源文件中设置好key-value,key为message中自定义的key,value为对应语言的value,例如:
package_en_US.png
package_zh_CN.properties.png

这样当浏览器将英文作为首选语言并发送请求的时候,会返回"username can't be blank",若以中文作为首选语言,那么会返回"用户不能为空"

2.4. 校验器优先校验器实现步骤

  1. 在对应的Action包下新建一个xml文件,命名为对应的ActionName-validation.xml (如果不知道xml的dtd,那么可以在struts2给我们提供的apps下的项目中去找,有了dtd就知道如何去编写对应的元素了)

  2. 根据自己的校验规则编写xml,例如下图所示:

struts2输入校验详解_第5张图片
校验器优先.png

validators根元素下用过了validator元素而不是Field元素,这就是所谓的校验器优先校验器

字段优先校验器是以字段作为基准的,而校验器优先校验器是以校验器作为基准的

根据DTD的规则,我们可以混用这两种校验器,但是不推荐这么做,应该保持一致性

2.5. 代码校验方法与校验框架校验之间的执行顺序

进过Debug测试,struts2是先用校验框架进行校验,然后再执行自定义调用方法的校验方法,接着再执行validate方法,执行完之后如果在Action级别或Field级别中存在错误的话,那么就会跳转到input视图,否则的话就会去执行自定义调用方法,这个流程是把自定义调用方法考虑进去的,如果没有设置自定义调用方法的话,那么相关的方法调用都会被忽略

2.6. 小结

相对于校验框架而言,手写validate方式更加灵活,毕竟是用程序控制,限制没xml那么多,但为了看懂别人的程序,校验框架我们还是需要掌握的

3. 总结

感觉struts2在类型转换和校验器这一块投入了很多精力,但是对于开发者而言用起来还是很勉强,太多的配置文件、太多的命名约定,对于我这种懒人不太友好

4. 引用

<<张龙J2EE视频>>

你可能感兴趣的:(struts2输入校验详解)