小试Bean Validation

数据校验是任何一个应用程序都会用到的功能,无论是显示层还是持久层. 通常,相同的校验逻辑会分散在各个层中, 这样,不仅浪费了时间还会导致错误的发生。 为了避免重复, 开发人员经常会把这些校验逻辑直接写在领域模型里面, 但是这样又把领域模型代码和校验代码混杂在了一起, 而这些校验逻辑更应该是描述领域模型的元数据。
    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应用程序中。