6.校验，数据绑定和类型转换(6.1 - 6.3)

最新推荐文章于 2020-10-04 17:48:09 发布

百里马

最新推荐文章于 2020-10-04 17:48:09 发布

阅读量1.1k

点赞数 2

分类专栏： J2EE 文章标签： Spring

J2EE 专栏收录该内容

42 篇文章 2 订阅

订阅专栏

6.校验，数据绑定和类型转换

6.1 介绍

关于是否把数据校验看做业务逻辑，有支持也有反对。Spring设计了一套校验规则（包括数据绑定）并没有否定任何一种观点。特定地校验不应该依赖于web层，而是应该易于局部化而且可以嵌入到任何可用的校验器（validator）中。考虑到以上几点，Spring提出了一个校验器（Validator）接口，它是校验的基础并且非常出众，而最关键的是它在每一层中都可以使用。

数据绑定对于将用户的输入动态绑定到实体上非常有用。Spring提供数据绑定器（DataBinder）来准确地完成这项任务。校验器（Validator）和数据绑定器（DataBinder）构成了validation这个包，它是MVC框架中主要使用的包，但是并不是局限于MVC。

在Spring中，Bean包装类（BeanWrapper）是一个基本概念并且被广泛用于很多地方。也许你并不需要直接使用BeanWrapper，但因为这是说明文档，我们觉得需要按顺序来介绍。所以这一章会介绍BeanWrapper。当你在将数据绑定到对象的过程中最有可能会使用到它。

Spring的DataBinder和低级的BeanWrapper都使用属性编辑器（PropertyEditors）来解析和格式化属性值。属性编辑器（PropertyEditors）的概念在本章中也有提到，它是JavaBeans规定的一部分。Spring3引入了“core.convert”包和一个高级的“format”包。前者提供了一个通用的类型转换工具，而后者则用来格式化UI（显示）域值。这些新的包可以被当做PropertyEditors的简单替代来使用，当然也会在本章中讨论。

6.2 使用Spring的校验器接口来做校验

Spring的一个特点就是使用校验器（Validator）接口来校验对象。校验器接口使用Errors对象来配合校验工作，校验过程中的校验失败都会被绑定到Errors对象上。

考虑一个简单的数据对象：

public class Person {
	
	private String name;
	private int age;
	
	// the usual getters and setters...
}

我们尝试通过实现org.springframework.validation.Validator接口的两个方法来为Person类提供校验：

• supports(Class)- 用来校验器是否可以校验给定的类

• validate(Object, org.springframework.validation.Errors) - 用来校验给定的对象，万一发生校验错误，那么把这些错误绑定到Errors对象上

当你知道Spring框架还提供了ValidationUtils这个帮助类，你会发现实现一个Validator是多么的简单。

public class PersonValidator implements Validator {
	
	/**
	* This Validator validates just Person instances
	*/
	
	public boolean supports(Class clazz) {
		return Person.class.equals(clazz);
	}
	
	public void validate(Object obj, Errors e) {
		ValidationUtils.rejectIfEmpty(e, "name", "name.empt");
		Person p = (Person) obj;
		if(p.getAge() < 0) {
			e.rejectValue("age", "negativevalue");
		} else if(p.getAge() > 110) {
			e.rejectValue("age", "too.darn.old");
		}
	}
}

如上所示，ValidationUtils类的静态方法rejectIfEmpty(..)是用来校验'name'这个属性，确保其不为null或空字符串。查看ValidationUtils类的Javadoc，可以找到它提供的除了上面例子显示之外的其他功能。

当需要实现一个验证器类来验证一个“富对象”（也就是说成员变量中还有自定义的引用变量）时，更好的方式是为每个嵌套的类都提供一个各自的校验器实现类。举个例子，Customer是一个“富对象”，它由2个String属性（姓和名）和一个复杂的Address对象组成。Address对象也可能脱离Customer而独立使用，所以一个AddressValidator已经被实现了。如果你想要CustomerValidator重用AddressValidator的逻辑，当然你并不想依靠“复制粘贴”这种手段，那么可以在你的CustomerValidator中依赖注入或是实例化一个AddressValidator，比如：

public class CustomerValidator implements Validator {
	private final Validator addressValidator;

	public Customer Validator(Validator addressValidator) {
		if (addressValidator == null) {
			throw new IllegalArgumentException(
					"The supplied [Validator] is required and must not be null.");
		}
		if (!addressValidator.supports(Address.class)) {
			throw new IllegalArgumentException(
					"The supplied [Validator] must support the validation of [Address] instances.");
		}
		this.addressValidator = addressValidator;
	}

	/**
	 * This Validatorvalidates Customerinstances, and any subclasses of
	 * Customertoo
	 */
	public boolean supports(Class clazz) {
		return Customer.class.isAssignableFrom(clazz);
	}

	public void validate(Object target, Errors errors) {
		ValidationUtils.rejectIfEmptyOrWhitespace(errors, "firstName",
				"field.required");
		ValidationUtils.rejectIfEmptyOrWhitespace(errors, "surname",
				"field.required");
		Customer customer = (Customer) target;
		try {
			errors.pushNestedPath("address");
			ValidationUtils.invokeValidator(this.addressValidator,
					customer.getAddress(), errors);
		} finally {
			errors.popNestedPath();
		}
	}
}

校验中产生的错误会被绑定到Errors对象上并被传递给校验器。在Spring Web MVC中你可以使用<spring:bind/>标签来检查这些错误信息，你也可以自己检查这些错误对象。更多关于这些方法的信息可以参考Javadoc。

6.3 把错误代码解析成错误消息

前面说了数据绑定和校验。那么最后，我们需要对校验错误输出相应的错误信息。在上面我们给出的例子中，'name'和'age'这两个字段没有通过校验（被reject掉了）。如果我们想要通过MessageSource来输出错误信息，那么当某个字段没有通过校验的时候（在例子中是'name'和'age'字段），需要给定一个错误代码。当我们调用（不管是直接地，间接地，或者是ValidationUtils类）rejectValue方法或是Errors接口的其他reject方法时，底层的实现不仅会注册你传入的错误代码，而且还会注册几个额外的错误代码。具体注册什么代码主要是由MessageCodesResolver决定的。默认会使用DefaultMessageCodesResolver，它不仅会注册一个你提供的错误代码，并且还会注册你传入reject方法的字段名。所以在例子中你使用rejectValue("age", "too.darn.old")reject一个字段，那么除了too.darn.old这个代码以外，Spring还会注册too.darn.old.age和too.darn.old.age.int（所以第一会注册这个字段名，第二会注册这个字段类型）；这么做的目的，是为了帮助开发者可以更方便的匹配错误信息。更多关于MessageCodesResolver的信息和默认策略可以参考MessageCodesResolver和DefaultMessageCodesResolver的Javadocs。

翻译的不准确的地方还望大家指出来~