数据校验是任何一个应用程序都会用到的功能,无论是显示层还是持久层. 通常,相同的校验逻辑会分散在各个层中, 这样,不仅浪费了时间还会导致错误的发生。 为了避免重复, 开发人员经常会把这些校验逻辑直接写在领域模型里面, 但是这样又把领域模型代码和校验代码混杂在了一起, 而这些校验逻辑更应该是描述领域模型的元数据。
JSR 303 - Bean Validation - 为实体验证定义了元数据模型和API. 默认的元数据模型是通过Annotations来描述的,但是也可以使用XML来重载或者扩展. Bean Validation API 并不局限于应用程序的某一层或者哪种编程模型, 例如,如图所示, Bean Validation 可以被用在任何一层, 或者是像类似Swing的富客户端程序中。
下面是一个非常简单的例子:
import java.util.Set; import javax.validation.ConstraintViolation; import javax.validation.Validation; import javax.validation.Validator; import javax.validation.ValidatorFactory; import javax.validation.constraints.Max; import javax.validation.constraints.Min; import javax.validation.constraints.NotNull; import javax.validation.constraints.Size; /** * 用户实体类 * 验证规则如下: * userId最小为1 * userName不为空 * userPwd非空,长度在6-20之间 * userAge的值在18-60之间 * @author tanlan * */ public class User { @Min(1) private int userId; @NotNull(message = "用户名不能为空!") @Size(min=1,message = "用户名不能为空!") private String userName; @NotNull @Size(min = 6, max = 20, message = "密码长度必须在6-20之间!") private String userPwd; @Min(value = 18, message = "年龄最小值必须是18") @Max(value = 60, message = "年龄最大值必须是60") private int userAge; public User() { } public User(int userId, String userName, String userPwd, int userAge) { this.userId = userId; this.userName = userName; this.userPwd = userPwd; this.userAge = userAge; } public int getUserId() { return userId; } public void setUserId(int userId) { this.userId = userId; } public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String getUserPwd() { return userPwd; } public void setUserPwd(String userPwd) { this.userPwd = userPwd; } public int getUserAge() { return userAge; } public void setUserAge(int userAge) { this.userAge = userAge; } public static void main(String[] args) { ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); Validator validator = factory.getValidator(); User user = new User(1, "tanlan", "123", 10); Set<ConstraintViolation<User>> constraintViolations = validator .validate(user); for (ConstraintViolation<User> constraintViolation : constraintViolations) { System.out.println(constraintViolation.getMessage()); } } }
需要用到的包:
hibernate-validator-4.2.0.Final.jar
validation-api-1.0.0.GA.jar
slf4j-api-1.6.1.jar
上面的代码运行后的结果是:
密码长度必须在6-20之间!
年龄最小值必须是18
下一步要学习一下这种验证如何应用到多层Web应用程序中。