当前位置 : 主页 > 编程语言 > java >

SpringBoot学习篇之@Valid与@Validated的区别

来源:互联网 收集:自由互联 发布时间:2023-01-30
目录 1.介绍 2.用法 (1)@Valid用法 (2)@Validated用法 (3)@Validated实现分组校验 (4)@Valid 实现嵌套校验 总结: 1.介绍 说明: 其实@Valid 与 @Validated都是做数据校验的,只不过注解位置
目录
  • 1.介绍
  • 2.用法
    • (1)@Valid用法
    • (2)@Validated用法
    • (3)@Validated实现分组校验
    • (4)@Valid 实现嵌套校验
  • 总结:

    1.介绍

    说明: 其实@Valid 与 @Validated都是做数据校验的,只不过注解位置与用法有点不同。

    不同点:

    (1)

    @Valid是使用Hibernate validation的时候使用。@Validated是只用Spring Validator校验机制使用。

    (2)

    @Valid 可以嵌套验证

    @Validation 不能进行嵌套验证

    (3)

    @Valid:可以用在方法、构造函数、方法参数和成员属性(field)上。

    @Validated:用在类、方法和方法参数上。但不能用于成员属性(field)。

    (如果@Validated注解在成员属性上,则会报不适用于field的错误。)

    (4)

    @Valid:没有分组功能。

    @Validated:提供分组功能,可以在参数验证时,根据不同的分组采用不同的验证机制。

    2.用法

    (1)@Valid用法

    a.导入依赖

    SpringBoot项目:

    <dependency>
        <groupId>javax.validation</groupId>
        <artifactId>validation-api</artifactId>
        <version>1.1.0.Final</version>
    </dependency>
     
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-validator</artifactId>
        <version>5.4.1.Final</version>
    </dependency>
    

    b.使用前提是实体类中属性使用注解进行校验

    package com.example.demo.pojo;
    
    import lombok.Data;
    import org.hibernate.validator.constraints.Length;
    import org.hibernate.validator.constraints.NotBlank;
    import org.hibernate.validator.constraints.Range;
    import org.springframework.format.annotation.DateTimeFormat;
    
    import javax.persistence.*;
    import javax.validation.constraints.NotNull;
    import java.io.Serializable;
    import java.util.Date;
    
    //lombok
    @Data
    public class User implements Serializable {
    
        //用户名
        @NotBlank(message = "请输入名称")
        @Length(message = "名称不能超过个 {max} 字符", max = 10)
        private String username;
    
        //年龄
        @NotNull(message = "请输入年龄")
        @Range(message = "年龄范围为 {min} 到 {max} 之间", min = 1, max = 100)
        private String age;
    }

    c.在Controller方法参数中加上@Valid注解

    package com.example.demo.controller;
    
    import com.example.demo.pojo.User;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.validation.BindingResult;
    import org.springframework.validation.ObjectError;
    import org.springframework.validation.annotation.Validated;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestBody;
    import org.springframework.web.bind.annotation.ResponseBody;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.validation.Valid;
    import java.util.List;
    
    @RestController
    public class UserController {
    
        public static final Logger logger = LoggerFactory.getLogger(UserController.class.getName());
    
        @PostMapping("/add")
        @ResponseBody
        public String add(@Validated User user, BindingResult bindingResult){
            if(bindingResult.hasErrors()){
                List<ObjectError> allErrors = bindingResult.getAllErrors();
                allErrors.forEach( v ->{
                    logger.error(v.getObjectName()+"======"+v.getDefaultMessage());
                });
                return "添加失败";
            }
            return "添加成功";
        }
    }

    经过测试填写错误数据,会在控制台输出报错信息。

    (2)@Validated用法

    a.开启校验框架(与上面一样)

    <!--1.导入JSR303规范-->
    <dependency>
        <groupId>javax.validation</groupId>
        <artifactId>validation-api</artifactId>
    </dependency>
    <!--使用hibernate框架提供的校验器做实现-->
    <dependency>
        <groupId>org.hibernate.validator</groupId>
        <artifactId>hibernate-validator</artifactId>
    </dependency>
    

    c.在需要开启校验功能的类上使用注解@Validated开启校验功能,对具体的字段设置校验规则,这里讲的是可以在类上使用@Validated注解,配合xml数据绑定。

    @Component
    @Data
    @ConfigurationProperties(prefix = "servers")
    //开启对当前bean的属性注入校验
    @Validated
    public class ServerConfig {
        //设置具体的规则
        @Max(value = 8888,message = "最大值不能超过8888")
        @Min(value = 202,message = "最小值不能低于202")
        private int port;
    }
    

    (3)@Validated实现分组校验

    注意 分组校验就是把条件加入组中,可以自由选择开启那些组的校验方式。

    a.分组接口

    package com.example.demo.pojo;
    public interface Group {
        interface Update{};
        interface FindAll{};
    }

    b.实体类

    package com.example.demo.pojo;
    
    import lombok.Data;
    import org.hibernate.validator.constraints.Length;
    import org.hibernate.validator.constraints.NotBlank;
    import org.hibernate.validator.constraints.Range;
    import org.springframework.format.annotation.DateTimeFormat;
    
    import javax.persistence.*;
    import javax.validation.constraints.NotNull;
    import java.io.Serializable;
    import java.util.Date;
    
    //lombok
    @Data
    public class User implements Serializable {
    
        //用户名
        @NotBlank(message = "请输入用户名不能为空",groups = {Group.FindAll.class})
        @Length(message = "名称不能超过个 {max} 字符", max = 10 ,groups = {Group.FindAll.class})
        private String username;
    
        //年龄
        @NotBlank(message = "请输入年龄不能为空",groups = {Group.Update.class})
        @Range(message = "年龄范围为 {min} 到 {max} 之间", min = 1, max = 100,groups = {Group.Update.class})
        private String age;
    }
    

    c.controller接口:

    注意 @Validated有参数 value中写分组名称

    package com.example.demo.controller;
    
    import com.example.demo.pojo.Group;
    import com.example.demo.pojo.User;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.validation.BindingResult;
    import org.springframework.validation.ObjectError;
    import org.springframework.validation.annotation.Validated;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestBody;
    import org.springframework.web.bind.annotation.ResponseBody;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.validation.Valid;
    import java.util.List;
    
    @RestController
    public class UserController {
    
        public static final Logger logger = LoggerFactory.getLogger(UserController.class.getName());
    
        @PostMapping("/add")
        @ResponseBody
        //注意@Validated有参数 value中写分组名称
        public String add(@Validated(value = {Group.Update.class}) User user, BindingResult bindingResult){
            if(bindingResult.hasErrors()){
                List<ObjectError> allErrors = bindingResult.getAllErrors();
                allErrors.forEach( v ->{
                    logger.error(v.getObjectName()+"======"+v.getDefaultMessage());
                });
                return "添加失败";
            }
            return "添加成功";
        }
    }

    (4)@Valid 实现嵌套校验

    注: 嵌套检测就是在一个User类中,存在另外一个User2类的属性。嵌套检测User同时也检测User2。

    a.实体类User

    package com.example.demo.pojo;
    
    import lombok.Data;
    import org.hibernate.validator.constraints.Length;
    import org.hibernate.validator.constraints.NotBlank;
    import org.hibernate.validator.constraints.Range;
    import org.springframework.format.annotation.DateTimeFormat;
    
    import javax.persistence.*;
    import javax.validation.Valid;
    import javax.validation.constraints.NotNull;
    import java.io.Serializable;
    import java.util.Date;
    
    //lombok
    @Data
    public class User implements Serializable {
    
        //用户名
        @NotBlank(message = "请输入用户名不能为空1")
        private String username;
    
        //年龄
        @NotBlank(message = "请输入年龄不能为空1")
        private String age;
    
        @Valid
        @NotNull(message = "user2不能为空1")
        private User2 user2;
    }
    }

    b.实体类User2

    package com.example.demo.pojo;
    
    import lombok.Data;
    import org.hibernate.validator.constraints.Length;
    import org.hibernate.validator.constraints.NotBlank;
    import org.hibernate.validator.constraints.Range;
    import org.springframework.format.annotation.DateTimeFormat;
    
    import javax.persistence.*;
    import javax.validation.Valid;
    import javax.validation.constraints.NotNull;
    import java.io.Serializable;
    import java.util.Date;
    
    package com.example.demo.pojo;
    
    import lombok.Data;
    import org.hibernate.validator.constraints.Length;
    import org.hibernate.validator.constraints.Range;
    
    import javax.validation.constraints.NotNull;
    import java.io.Serializable;
    
    //lombok
    @Data
    public class User2 implements Serializable {
    
        //用户名
        @Length(message = "名称不能超过个 {max} 字符2", max = 10 )
        private String username2;
    
        //年龄
    
        @Range(message = "年龄范围为 {min} 到 {max} 之间2", min = 1, max = 100)
        private String age2;
    }

    c.Controller类(这里使用@Valid)

    package com.example.demo.controller;
    
    import com.example.demo.pojo.Group;
    import com.example.demo.pojo.User;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.validation.BindingResult;
    import org.springframework.validation.ObjectError;
    import org.springframework.validation.annotation.Validated;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestBody;
    import org.springframework.web.bind.annotation.ResponseBody;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.validation.Valid;
    import java.util.List;
    
    @RestController
    public class UserController {
    
        public static final Logger logger = LoggerFactory.getLogger(UserController.class.getName());
    
        @PostMapping("/add")
        @ResponseBody
        public String add(@Valid User user, BindingResult bindingResult){
            if(bindingResult.hasErrors()){
                List<ObjectError> allErrors = bindingResult.getAllErrors();
                allErrors.forEach( v ->{
                    logger.error(v.getObjectName()+"======"+v.getDefaultMessage());
                });
                return "添加失败";
            }
            return "添加成功";
        }
    }

    总结:

    了解这两个注解可以让你的校验数据更加方便。

    到此这篇关于SpringBoot学习篇之@Valid与@Validated区别的文章就介绍到这了,更多相关SpringBoot @Valid与@Validated区别内容请搜索自由互联以前的文章或继续浏览下面的相关文章希望大家以后多多支持自由互联!

    网友评论