转载

Spring @Valid @Validated

对于属性的验证有如下一些注解

@NotBlank：只用在String上，值不能为null，并且trim后长度大于零。不为null，不是全为空格的字符串

@NotNull: 不能为null,但可以是长度为零的字符串

@NotEmpty: 不能为null，长度大于零

@Null：必须为null

@Min(value): 数字，值必须大于等于指定的值

@Max(value): 数字，值必须小雨等于指定的值

@DecimalMin(value): 数字，值必须大于等于指定的值

@DecimalMax(value): 数字，值必须小雨等于指定的值

@Digits(integer, fraction)：数字，值必须在可接收的范围内

@Size(min=v1,max=v2): v1<=值<=v2

@AssertTrue: 必须为true

@AssertFalse: 必须为false

@Past: 必须是过去的日期

@Future: 必须是将来的日期

@Pattern(regex=, flag=): 符合指定的正则表达式

@Valid：可以用在方法参数，方法，属性上。用来进行嵌套验证。嵌套验证就是在ClassA的属性中有ClassB，而ClassB的属性也需要进行验证。

@Validated:可以用在方法参数，方法上，不能用在属性上。提供了分组的功能，在参数传入时根据分组采用不同的验证机制。说明一下分组，例如对于User的userID，在新建用户时userID必须要为null。在更新用户时userID必须要不为空并且不能都是空格（blank）。这就对userID进行了分组功能，Add和Update两个组。

@Valid实例

Book定义

public class Book {

    @NotBlank(message = "bookID is mandatory, can not be blank")
    public String bookID;
    
    @Size(min=5, max=20)
    @NotBlank(message = "bookName is mandatory, can not be blank")
    public String bookName;
    public String author;
    
    @Valid
    public List<ChapterInfo> chapterList;
    
    public Book(String id, String name, String auth) {
        bookName = name;
        author = auth;
        bookID = id;
    }
}

ChapterInfo定义

public class ChapterInfo {
    @Min(0)
    public Long chapterID;
    
    @NotBlank
    @Size(min=5, max=50)
    public String chapterName;
    
    @Size(min=5, max=20)
    public String contentID;
}

BookController

@RestController
@RequestMapping("/bookcontroller")
public class BookController {

    private List<Book> bookList = new ArrayList();
    
    @ResponseBody
    @RequestMapping("/addBookToList")
    public boolean addBookToList(@Valid @RequestBody Book b) {
        System.out.println(b.bookName);
        
        bookList.add(b);
        
        return true;
    }
    
    @InitBinder
    private void activateDirectFieldAccess(DataBinder dataBinder) {
        dataBinder.initDirectFieldAccess();
    }
    
}

Postman验证

Spring @Valid @Validated

可以看到chapterList中的ChapterInfo的chapterName为blank，验证不通过

@Validated实例

public class User {
    
    @NotBlank
    public String name;
    
    @NotBlank
    public String address;
    
    @Min(1)
    public int age;

    public boolean isMan;
    
    @NotBlank(groups = {Update.class})
    @Null(groups = {Add.class})
    public String usrID;
    
    public interface Add{}
    
    public interface Update{}
    
    
    public User(String name, String addr, int age, boolean isMan) {
        this.name = name;
        this.address = addr;
        this.age = age;
        this.isMan = isMan;
    }

}

其中对usrID属性使用了@NotBlank(groups = {Update.class})和@Null(groups = {Add.class})注释。意思是：

(1)Update user时usrID不能为blank（要通过usrID查找user去update）

(2)Add user时usrID必须为空（要生成新的user，会分配user ID）

@RestController
@RequestMapping("/registcontroller")
public class RegistController {

    List<User> usrList = new ArrayList();
    
    
    @PostMapping(path="/adduser")
    @ResponseBody
    public User addUser(@RequestBody @Validated({User.Add.class}) User usr, BindingResult result) {
        
        if (result.hasErrors()) {
            List<ObjectError> list = result.getAllErrors();
            FieldError error = (FieldError)list.get(0);
            System.out.println(error.getObjectName() + "," + error.getField() + "," + error.getDefaultMessage());
            return null;
        }
        User user = new User(usr.name, usr.address, usr.age, usr.isMan);
        String usrID  = usrList.size() + "";
        
        user.usrID = usrID;
        
        return user;
    }
}

在addUser的传入参数进行了Validated的分组验证（Add)，如果传入User的usrID不为blank则会出错。

PostMan验证

usrID不存在时

Spring @Valid @Validated