脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → SpringBoot集成Validation参数校验

SpringBoot集成Validation参数校验

 更新时间：2022年01月16日 08:20:55   作者：one_smail  
这篇文章主要为大家详细介绍了SpringBoot集成Validation参数校验，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下

本文实例为大家分享了SpringBoot集成Validation参数校验的具体代码，供大家参考，具体内容如下

1、依赖

SpringBoot在web启动器中已经包含validator包

<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
</dependency>

非SpringBoot项目，需要自定引入依赖

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.1.5.Final</version>
</dependency>
<dependency>
    <groupOd>org.glassfish</groupId>
    <artifactId>jakarta.el</artifactId>
    <version>3.0.3</version>
</dependency>

2、常用约束说明

package com.smile.project.validator.utils;
 
public class 常用约束说明 {
 
    /**
     * @Null：元素为null
     * @NotNull：元素不为null
     * @AssertTrue：元素为true
     * @AssertFalse：元素为false
     * @Min(value)：数字的值大于等于指定的最小值
     * @Max(value)：数字的值小于等于指定的最大值
     * @DecimalMin(value)：大数值大于等于指定的最小值
     * @DecimalMax(value)：大数值小于等于指定的最大值
     * @Size(max=,min=)：元素的大小在指定的范围内
     * @Digits(integer,fraction):元素是一个数字，其值必须在可接受的范围内
     * @Past:一个过去的日期
     * @Future:一个将来的日期
     * @Pattern(regex=,flag=):指定的正则表达式
     * @URL:必须是一个URL
     * @Email：必须是email格式
     * @NotBlank:字符串不能为空
     * @NotEmpty：集合不能为空
     * @Length：长度必须在指定范围内
     * @Valid：对实体类进行校验
     */
 
}

3、实体约束示例

import com.smile.project.validator.utils.Gender;
import lombok.Data;
import javax.validation.constraints.Email;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
 
@Data
public class SysUser {
 
    private Long id;
 
    @NotNull(message = "用户名不能为空")
    @Size(min = 3,max = 5,message = "用户名长度为{min}-{max}之间")
    private String username;
 
    @NotNull(message = "昵称不能为空")
    private String name;
 
    @NotNull(message = "密码不能为空")
    private String password;
 
    @Email(message = "邮箱格式不合法")
    private String email;
 
    private String gender;
 
}

4、控制层示例

需要在class加上@Validated注解

如果参数时实体，需要加上@Valid注解

import com.smile.project.validator.entity.SysUser;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.validation.Valid;
import javax.validation.constraints.NotNull;
 
@RestController
@Validated
public class SysUserController {
 
    /**
     * 方法参数为实体校验
     */
    @PostMapping("/register")
    public ResponseEntity register(@Valid SysUser sysUser){
        return ResponseEntity.ok(sysUser);
    }
 
    /**
     * 方法参数校验
     */
    @GetMapping("user")
    public ResponseEntity getUser(@NotNull(message = "用户名不能为空") String username){
        SysUser sysUser = new SysUser();
        sysUser.setName("smile");
        return ResponseEntity.ok(sysUser);
    }
 
}

5、异常捕获

全局异常捕获，当出现参数校验不合法时捕获异常，并且返回给前端

import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.validation.ObjectError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import javax.validation.ConstraintViolation;
import javax.validation.ConstraintViolationException;
import java.util.HashMap;
import java.util.List;
import java.util.Set;
 
/**
 * 全局异常捕获
 * 当出翔参数校验不合法时捕获异常，并且返回给前端
 */
@ControllerAdvice
public class GlobHandler {
 
    /**
     * 捕获方法参数校验异常
     */
    @ExceptionHandler(ConstraintViolationException.class)
    @ResponseBody
    public ResponseEntity constraintViolationExceptionHandler(ConstraintViolationException e){
        Set<ConstraintViolation<?>> message = e.getConstraintViolations();
        HashMap<String,Object> map = new HashMap<>();
        message.stream().forEach(msg ->{
            String path = msg.getPropertyPath().toString();
            String field = path.substring(path.indexOf(".")+1);
            map.put(field,msg.getMessageTemplate());
        });
        return ResponseEntity.ok(map);
    }
 
    /**
     * 捕获实体参数校验异常
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseBody
    public ResponseEntity resolveMethodArgumentNotValidException(MethodArgumentNotValidException e){
        List<ObjectError> allErrors = e.getBindingResult().getAllErrors();
        HashMap<String,Object> map = new HashMap<>();
        allErrors.stream().forEach(error -> {
            FieldError fieldError = (FieldError) error;
            map.put(fieldError.getField(),fieldError.getDefaultMessage());
        });
        return ResponseEntity.ok(map);
    }
 
}

6、自定义校验规则

特殊的字段需要自定义规则，比如身份证号码，邮箱，电话等

6.1、定义校验注解

import com.smile.project.validator.utils.GenderValidator;
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
/**
 * 定义校验注解
 */
@Target({METHOD,FIELD})
@Retention(RUNTIME)
@Constraint(validatedBy = GenderValidator.class)
@Documented
public @interface Gender {
 
    String message() default "性别为男或者女";
 
    Class<?>[] groups() default {};
 
    Class<? extends Payload[]>[] payload() default {};
 
}

6.2、GenderValidator实现ConstraintValidator接口并提供校验规则

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
 
/**
 * 实现ConstraintValidator接口并提供校验规则
 */
public class GenderValidator implements ConstraintValidator<Gender,String> {
 
    //初始化校验值
    @Override
    public void initialize(Gender constraintAnnotation) {
 
    }
 
    //检验规则
    @Override
    public boolean isValid(String value, ConstraintValidatorContext content) {
        return "男".equals(value) || "女".equals(value);
    }
}

6.3、在成员变量中使用注解

import com.smile.project.validator.utils.Gender;
import lombok.Data;
import javax.validation.constraints.Email;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
 
@Data
public class SysUser {
 
    private Long id;
 
    @NotNull(message = "用户名不能为空")
    @Size(min = 3,max = 5,message = "用户名长度为{min}-{max}之间")
    private String username;
 
    @NotNull(message = "昵称不能为空")
    private String name;
 
    @NotNull(message = "密码不能为空")
    private String password;
 
    @Email(message = "邮箱格式不合法")
    private String email;
 
    @Gender()
    private String gender;
 
}

7、分组校验

默认情况下，不指定分组都属于默认组；使用分组校验有利于分层校验开发

7.1、新建两个接口，一个用于查询，一个用于添加

public interface ADD extends Default {
 
}
 
public interface Select extends Default {
 
}

7.2、修改尸体校验规则，如果不指定分组默认时Default组；

import com.smile.project.validator.utils.Gender;
import lombok.Data;
import javax.validation.constraints.Email;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
 
@Data
public class SysUser {
 
    private Long id;
 
    @NotNull(message = "用户名不能为空",groups = ADD.class)
    @Size(min = 3,max = 5,message = "用户名长度为{min}-{max}之间")
    private String username;
 
    @NotNull(message = "昵称不能为空",groups = Select.class)
    private String name;
 
    @NotNull(message = "密码不能为空",groups = ADD.class)
    private String password;
 
    @Email(message = "邮箱格式不合法",groups = Select.class)
    private String email;
 
    @Gender()
    private String gender;
 
}

7.3、控制层示例，此时只会校验ADD组和Default组

//分组校验
@PostMapping("/user")
public ResponseEntity addUser(@Validated(value = ADD.class) @RequestBody SysUser sysUser){
    return ResponseEntity.ok(sysUser);
}

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

相关文章

  • 带你快速搞定java多线程(5)

    带你快速搞定java多线程(5)

    这篇文章主要介绍了java多线程编程实例，分享了几则多线程的实例代码，具有一定参考价值，加深多线程编程的理解还是很有帮助的，需要的朋友可以参考下
    2021-07-07
  • Spring Framework远程代码执行漏洞分析(最新漏洞)

    Spring Framework远程代码执行漏洞分析(最新漏洞)

    Spring Framework 是一个开源应用框架，旨在降低应用程序开发的复杂度，它具有分层体系结构，允许用户选择组件，同时还为 J2EE 应用程序开发提供了一个有凝聚力的框架，对Spring远程代码执行漏洞相关知识感兴趣的朋友一起看看吧
    2022-04-04
  • 用java生成html文件实现原理及代码

    用java生成html文件实现原理及代码

    用printStream来向html文件里输出数据，先创建一个StringBuilder对象，通过append方法来为其添加html语句，具体实现如下，感兴趣的朋友可以参考下，希望对大家有所帮助
    2013-08-08
  • mybatis interceptor 处理查询参数及查询结果的实例代码

    mybatis interceptor 处理查询参数及查询结果的实例代码

    这篇文章主要介绍了mybatis interceptor 处理查询参数及查询结果,非常不错，具有参考借鉴价值，需要的朋友可以参考下
    2017-01-01
  • java实现建造者模式（Builder Pattern）

    java实现建造者模式（Builder Pattern）

    这篇文章主要为大家详细介绍了java实现建造者模式Builder Pattern，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2018-10-10
  • Java序列化和反序列化示例介绍

    Java序列化和反序列化示例介绍

    大家好，本篇文章主要讲的是Java序列化和反序列化示例介绍，感兴趣的同学赶快来看一看吧，对你有帮助的话记得收藏一下，方便下次浏览
    2022-01-01
  • SpringBoot对Controller进行单元测试的实现代码 附乱码解决方案

    SpringBoot对Controller进行单元测试的实现代码 附乱码解决方案

    这篇文章主要介绍了SpringBoot对Controller进行单元测试的实现代码 附乱码解决方案,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2021-04-04
  • Lombok同时使⽤@Data和@Builder踩坑总结

    Lombok同时使⽤@Data和@Builder踩坑总结

    这篇文章主要介绍了Lombok同时使⽤@Data和@Builder踩坑总结，文章围绕主题展开详细的内容介绍，具有一定的参考价值需要的小伙伴可以参考一下，希望对你的学习有所帮助
    2022-05-05
  • Java中AIO、BIO、NIO应用场景及区别

    Java中AIO、BIO、NIO应用场景及区别

    本文主要介绍了Java中AIO、BIO、NIO应用场景及区别，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2023-06-06
  • javaweb项目如何实现手机短信登录

    javaweb项目如何实现手机短信登录

    这篇文章主要介绍了javaweb项目如何实现手机短信登录，手机号登录在现在的项目中用的场景非常多，实现起来也不难，今天我们就一起来通过演示实现登录过程,需要的朋友可以参考下
    2019-07-07

最新评论