Spring MVC (二) （转）

任何软件系统的开发，都必须考虑输入数据的有效性问题，即要保证非法的数据不被系统接收，又要有较好的用户操作体验。B/S系统的开发更是如此，数据的验证至少都要建立起：客户端和服务器端两道防线。建立客户端验证机制是为了加快验证速度，提高用户交互效率，而服务器端验证将是数据必经之路，这道关卡是必不可少的。
B/S系统中的表现层框架中，struts2是一个即能自动生成客户端，又能生成服务器端数据验证代码的框架，这点非常可贵，但是必须要引用struts2的自定标记库。struts1和struts2的验证，都是通过在xml文件中配置formbean的中每一个字段的验证规则以及出错提示消息，结合相应的标记库，可以显示服务器端的验证结果，并且通过标记库，可以保留（回填）用户之前输入的数据。
因此，我们在开发中要考虑三个问题，一是页面上哪些输入元素用什么样的验证规则，二是出错后如何在页面上显示出错信息，三是用户之前输入的数据回填（避免用户重新再输入）。
我之前在一些小项目中都是不主张引入验证框架的，输入表单不算太复杂，由程序员手工if esle 做验证，并将验证信息放入request中。但对于大、中型项目，这种做法显然并不规范。我们用DTO(VO)接收页面表单数据，之后根据配置的验证规则对表单数据进行验证，如果满足验证规则执行后面的业务处理，否则回填数据，并向用户报告未通过验证的原因。
下面我们一起来看看spring mvc中是如何做的。spring mvc通过JSR 303规范对java bean字段验证定义，通过注解配置来实现对数据的合法性验证。JSR 303目前有jboss和hibernate的两个实现，我们在这里采用hibernate的实现。
先要在项目中导入validation-api-1.0.0.GA.jar和hibernate-validator-4.1.0.Final.jar两个包，之后就在DTO(VO)中对需要验证的字段进行配置了（如果页面字段内容和领域模型中的POJO字段一致，可以不必定义新的DTO(VO)对象，直接使用POJO即可），示例代码如下：

public class Student implements Serializable {	
	//姓名
	@NotEmpty(message="姓名不可以为空！")
	@Length(min=2,max=5)
	private String name;
 
	//出生日期
	@Past(message="生日输入不正确，请核对！")
	private Date birthday; 

 

先来看上面代码中的name字段，我们用了@NotEmpty注解，标明此字段不能为空，如果为空将显示由message指定的消息，如果想指定资源文件中的消息key，可以用NotEmpty.modelname.fieldname指定，modelname是DTO对象在spring mvc作用域中的名称，fieldname是字段属性名。
@Length指定该字段的长度区间，在这里我没有指定默认消息，系统将使用内置的默认消息（英文的），当然你可以在资源文件中指定消息key，比如，在资源文件中定义：Length.student.name = 用户的姓名长度必须在 2 到 5之间!。
@Past注解标明该日期必须在今天以后。
更多更复杂的验证规则配置，大家可参考下面表格的描述（转自hiberante validator官网）：

 

Annotation Part of Bean Validation Specification Apply on Use Hibernate Metadata impact

@AssertFalse	yes	field/property	check that the annotated element is false.	none
@AssertTrue	yes	field/property	check that the annotated element is true.	none
@DecimalMax	yes	field/property. Supported types are BigDecimal, BigInteger, String, byte, short, int, long and the respective wrappers of the primitive types.	The annotated element must be a number whose value must be lower or equal to the specified maximum. The parameter value is the string representation of the max value according to the BigDecimal string representation.	none
@DecimalMin	yes	field/property. Supported types are BigDecimal, BigInteger, String, byte, short, int, long and the respective wrappers of the primitive types.	The annotated element must be a number whose value must be higher or equal to the specified minimum. The parameter value is the string representation of the min value according to the BigDecimal string representation.	none
@Digits(integer=, fraction=)	yes	field/property. Supported types are BigDecimal, BigInteger, String, byte, short, int, long and the respective wrappers of the primitive types.	Check whether the property is a number having up to integer digits and fraction fractional digits.	Define column precision and scale.
@Email	no	field/property. Needs to be a string.	Check whether the specified string is a valid email address.	none
@Future	yes	field/property. Supported types are java.util.Date and java.util.Calendar.	Checks whether the annotated date is in the future.	none
@Length(min=, max=)	no	field/property. Needs to be a string.	Validate that the annotated string is between min and max included.	none
@Max	yes	field/property. Supported types are BigDecimal, BigInteger, String, byte, short, int, long and the respective wrappers of the primitive types.	Checks whether the annotated value is less than or equal to the specified maximum.	Add a check constraint on the column.
@Min	yes	field/property. Supported types are BigDecimal, BigInteger, String, byte, short, int, long and the respective wrappers of the primitive types.	Check whether the annotated value is higher than or equal to the specified minimum.	Add a check constraint on the column.
@NotNull	yes	field/property	Check that the annotated value is not null.	Column(s) are not null.
@NotEmpty	no	field/property. Needs to be a string.	Check if the string is not null nor empty.	none
@Null	yes	field/property	Check that the annotated value is null.	none
@Past	yes	field/property. Supported types are java.util.Date and java.util.Calendar.	Checks whether the annotated date is in the past.	none
@Pattern(regex=, flag=)	yes	field/property. Needs to be a string.	Check if the annotated string match the regular expression regex.	none
@Range(min=, max=)	no	field/property. Supported types are BigDecimal, BigInteger, String, byte, short, int, long and the respective wrappers of the primitive types.	Check whether the annotated value lies between (inclusive) the specified minimum and maximum.	none
@Size(min=, max=)	yes	field/property. Supported types are String, Collection, Map and arrays.	Check if the annotated element size is between min and max (inclusive).	Column length will be set to max.
@Valid	yes	field/property	Perform validation recursively on the associated object.

 

再来看看action中新增学生的代码中，是如何进行数据验证的：

	/**
	 * 添加学生信息
	 * @return String
	 */
	@RequestMapping(params="add")
	public String addStudent(ModelMap model,
			@RequestParam(value="pno",defaultValue="1")int pno,
			@ModelAttribute("student") @Valid Student stu, 
			BindingResult result) {
 
		if (result.hasErrors()) {	
			return "add_student";
		}
 
		Student student = new Student();
		//将页面属性拷贝到student中
		BeanUtils.copyProperties(stu, student, new String[]{});
 
		try {
			studentService.addStudent(student);
		} catch (BizException e) {
			model.put("error_key", e.getMessage());
			return "error";
		}
 
		return "redirect:student.action?page&pno=" + pno;
	} 

 

上面的代码@ModelAttribute(“student”) @Valid Student stu中，我们用@Valid注解标明，页面传入的 Student stu必须要验证，规则当然是我们前面用注解定义过的了。
如果验证没有通过，我们怎么能够知道呢？BindingResult result，看到这个参数了么，这个里面有验证是否通过的信息，我们用result.hasErrors()就可以知道验证是否通过，如果没有通过，则转到出错的页面。
最后一个问题，页面中如果显示这个错误信息呢？需要引入

<!--taglib uri="/WEB-INF/spring-form.tld" prefix="form"-->

标记库，这个是spring mvc定义的。比如对姓名的错误显示，我们通过

 

<form:errors path="student.name"/> 

 

就可以显示这个字段的验证出错信息了。
有人说，引入spring mvc的标签库，似乎在jsp中产生了和spring mvc的耦合。确实如此，天下没有免费的午餐，你想想，其它的mvc验证框架，不是也要引入相应的视图标签库么。spring mvc将org.springframework.validation.BindingResult.modelAttributeName名作为key保存出错的信息，本例中用org.springframework.validation.BindingResult.student为key保存了一个org.springframework.validation.BeanPropertyBindingResult的错误对象，如果用EL表达式来取出错的信息，还真取不出来。
数据的回填问题非常简单，直接访问作用域中的modelAttributeName的对象就可以了，本例中是studnet，姓名的页面元素，就可以写成：

 

<input type='text' name="name" value="${student.name}"/>