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