1. 代码形式实现输入校验
1.1. struts2执行流程
客户端向服务端发送HTTP请求
Struts2框架通过StrutsPrepareAndExecuteFilter拦截请求
然后扫描struts.xml文件,找到并实例化该请求所对应的Action
对于HTTP请求的参数值进行类型转换以适配于Action中对应的属性类型(内建的类型转换器以及自定义的类型转换器在此时起作用)
类型转换成功的就自动进行赋值,类型转换失败的则不进行赋值(Action会以成员变量默认值为最终值),并且将错误信息写入到FieldError中
执行validate()校验方法
validate()校验方法执行完后,如果发现存在错误不管是Action级别的还是Field级别的,那么都会直接跳转到该Action所对应的input视图中
如果没有存在错误,那么会执行execute方法,并跳转到对应的视图来显示结果
1.2. ActionError与FieldError底层实现
ActionError底层是通过ArrayList<String>来实现的
FieldError底层是通过LinkedHashMap<String, List<String>>来实现的
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标签为:<s:actionerror/>
显示field级别的错误信息的struts2标签为:<s:fielderror></s:fielderror>
具体使用情况可以参考如下代码:
1.6. ActionError与FieldError差异
Action级别的错误信息,通常是我们手动添加的,而Field级别的错误信息,有可能是我们手工加的,也有可能是框架在类型转换失败之后所添加的
2. 配置文件方式实现输入校验
2.1. struts2校验框架简介
struts2的校验框架是一个有效的xml文件,存放在与对应的Action同包下,命名规则为ActionName-validation.xml
,它采用DTD来验证,它可以分为字段优先校验器与校验器优先校验器,为什么校验器分为字段优先与校验器优先两种呢?这是因为DTD中是如下声明元素的<!ELEMENT validators (field|validator)+>
,校验功能最初由xwork提供
2.2. 字段优先校验器实现步骤
- 在对应的Action包下新建一个xml文件,命名为对应的ActionName-validation.xml (如果不知道xml的dtd,那么可以在struts2给我们提供的apps下的项目中去找,有了dtd就知道如何去编写对应的元素了)
- 根据自己的校验规则编写xml,例如下图所示:
我们要知道一点,所谓的校验框架校验其实底层还是用代码来校验的,校验框架中field-validator元素的属性type值是从default.xml中选取的(default.xml位于com.opensymphony.xwork2.validator.validators包下),如下:
其实对应的是一个个的java类,由这些java类最终来校验的,field-validator下的子元素param,其实配置的是这些java类对应的setXXX方法罢了
Tips: 对于stringlength而言,只有当值不为null且不为空格的情况下才会进行校验
2.3. 校验框架之国际化
struts2支持国际化,底层还是使用了JDK给我们提供的国际化API
实现步骤:
- 在校验文件(xml)中,对message元素的属性key指定一个通用的值,例如:
- 在对应的Action包下,创建语言包(资源文件),这些资源文件的命名规则为package_语言名_国家名.properties,例如:
- 在各自的资源文件中设置好key-value,key为message中自定义的key,value为对应语言的value,例如:
这样当浏览器将英文作为首选语言并发送请求的时候,会返回"username can't be blank",若以中文作为首选语言,那么会返回"用户不能为空"
2.4. 校验器优先校验器实现步骤
在对应的Action包下新建一个xml文件,命名为对应的ActionName-validation.xml (如果不知道xml的dtd,那么可以在struts2给我们提供的apps下的项目中去找,有了dtd就知道如何去编写对应的元素了)
根据自己的校验规则编写xml,例如下图所示:
validators根元素下用过了validator元素而不是Field元素,这就是所谓的校验器优先校验器
字段优先校验器是以字段作为基准的,而校验器优先校验器是以校验器作为基准的
根据DTD的规则,我们可以混用这两种校验器,但是不推荐这么做,应该保持一致性
2.5. 代码校验方法与校验框架校验之间的执行顺序
进过Debug测试,struts2是先用校验框架进行校验,然后再执行自定义调用方法的校验方法,接着再执行validate方法,执行完之后如果在Action级别或Field级别中存在错误的话,那么就会跳转到input视图,否则的话就会去执行自定义调用方法,这个流程是把自定义调用方法考虑进去的,如果没有设置自定义调用方法的话,那么相关的方法调用都会被忽略
2.6. 小结
相对于校验框架而言,手写validate方式更加灵活,毕竟是用程序控制,限制没xml那么多,但为了看懂别人的程序,校验框架我们还是需要掌握的
3. 总结
感觉struts2在类型转换和校验器这一块投入了很多精力,但是对于开发者而言用起来还是很勉强,太多的配置文件、太多的命名约定,对于我这种懒人不太友好
4. 引用
<<张龙J2EE视频>>