Struts2框架的输入校验是通过XML配置文件或者注解来实现的,当然在Action中进行手动(编码)校验也是允许的,并且可以手动校验和XML配置文件或者注解方式校验一起使用。
数据校验依赖于validation和workflow两个拦截器。validation拦截器进行校验并创建具体字段错误的列表,workflow拦截器检查存在的校验错误,如果有,就返回"input"结果码,返回到包含校验的表单页面。
在基于Struts2框架的Web应用中,输入校验即可以通过在服务端完成,也可以在客户端完成。本文主要记录Struts2在服务端的几种校验方式。
Struts2在服务端的校验方式主要有两种:
(1)基于硬编码的方法:
在业务控制器类中重写validate()方法或者使用形式为validateXxx()形式的校验方法对输入数据进行校验。其中Xxx表示action中不同的方法名称。
package cn.bdx.controller; import cn.bdx.model.Book; import com.opensymphony.xwork2.ActionSupport; public class BookController extends ActionSupport{ private Book book; /** * 添加书籍 * @return */ public String add() { return SUCCESS; } /** * 添加书籍的验证 * @return */ @Override public void validate() { if(book == null) { this.addFieldError("bookError", "book不能为空"); }else if(book.getName().isEmpty()) { this.addFieldError("bookError", "书名不能为空"); }else if(book.getPrice() < 0) { this.addFieldError("bookError", "价格不能为空"); } } public Book getBook() { return book; } public void setBook(Book book) { this.book = book; } }
或者:
package cn.bdx.controller; import cn.bdx.model.Book; import com.opensymphony.xwork2.ActionSupport; public class BookController extends ActionSupport{ private Book book; /** * 添加书籍 * @return */ public String add() { return SUCCESS; } /** * 添加书籍的验证 * @return */ public void validateAdd() { if(book == null) { this.addFieldError("bookError", "book不能为空"); }else if(book.getName().isEmpty()) { this.addFieldError("bookError", "书名不能为空"); }else if(book.getPrice() < 0) { this.addFieldError("bookError", "价格不能为空"); } } public Book getBook() { return book; } public void setBook(Book book) { this.book = book; } }
注:这种方式代码的耦合度比较高。
(2)基于配置文件的方法:
这种方式是吧校验规则保存在特定的XML格式配置文件中,实现输入校验和Action类的分离,以此来降低代码的耦合性。规则结构由xwork-validator-1.0.2.dtd文件定义的,新建BookController-validation.xml
基于字段的校验规则:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE validators PUBLIC "- //OpenSymphony Group//XWork Validator 1.0.2//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> <validators> <field name="book.name"> <field-validator type="requiredstring"> <message>书名不能为空!</message> </field-validator> </field> <field name="book.price"> <field-validator type="required"> <message>请输入单价!</message> </field-validator> <field-validator type="double"> <param name="minExckusive">0</param> <message>单价必须大于${minExclusive}</message> </field-validator> </field> </validators>
基于validator校验器的校验规则:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE validators PUBLIC "- //OpenSymphony Group//XWork Validator 1.0.2//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd"> <validators> <validator type="requiredstring"> <param name="fieldName">book.name</param> <message>书名不能为空!</message> </validator> <validator type="double"> <param name="fieldName">book.price</param> <param name="minExckusive">0</param> <message>单价必须大于${minExclusive}</message> </validator> </validators>
BookController-validation.xml文件在项目中的位置跟BookController处于同一个包中