validation 验证参数

2024-06-22 08:52
文章标签 参数 验证 validation

本文主要是介绍validation 验证参数,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

validation 验证参数

一、引入POM依赖

添加spring-boot-starter-validation
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId>
</dependency>
或添加hibernate-validator
<dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator</artifactId>
</dependency>
或添加spring-boot-starter-web
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>

二、校验注解

JSR提供的校验注解:
  1. @Null:被注释的元素值必须为null。
  2. @NotNull:被注释的元素值必须不为null。
  3. @Pattern(regex=):被注释的元素字符串必须符合指定的正则表达式。
  4. @Size(max=, min=):集合元素数量必须在min和max范围内。
  5. @AssertTrue:被注释的元素必须为true。
  6. @AssertFalse:被注释的元素必须为false。
  7. @Min(value):被注释的元素必须是一个数字,其值必须大于等于指定的最小值。
  8. @Max(value):被注释的元素必须是一个数字,其值必须小于等于指定的最大值。
  9. @Range(min,max):数字必须在min和max范围内。
  10. @DecimalMin(value):被注释的元素必须是一个数字,其值必须大于等于指定的最小值。
  11. @DecimalMax(value):被注释的元素必须是一个数字,其值必须小于等于指定的最大值。
  12. @Digits (integer, fraction):被注释的元素必须是一个数字,其值必须在可接受的范围内。
  13. @Past:被注释的元素必须是一个过去的日期。
  14. @Future:被注释的元素必须是一个将来的日期。
  15. @Email:字符串必须是Email地址。
  16. @SafeHtml:字符串必须是安全的html。
  17. @URL:字符串必须是合法的URL。
  18. @CreditCardNumber(ignoreNonDigitCharacters=):字符串必须是信用卡号,按照美国的标准验证。
  19. @Size(max,min):限制字符长度必须在min到max之间。
Hibernate Validator提供的校验注解:
  1. @NotBlank(message =):验证字符串非null,且trim后长度必须大于0。
  2. @Length(min=,max=):被注释的字符串的大小必须在指定的范围内。
  3. @NotEmpty:被注释的字符串的必须非空。
  4. @Range(min=,max=,message=):被注释的元素必须在合适的范围内。
  5. @AssertFalse:校验false。
  6. @AssertTrue:校验true。
  7. @DecimalMax(value=,inclusive=):小于等于value,inclusive=true是小于等于。
  8. @DecimalMin(value=,inclusive=):与上类似。
  9. @Max(value=):小于等于value。
  10. @Min(value=):大于等于value。
  11. @NotNull:检查Null。
  12. @Past:检查日期。
  13. @Pattern(regex=,flag=):正则。
  14. @Size(min=, max=):字符串,集合,map限制大小。
  15. @Valid:对po实体类进行校验。

三、常用注解的使用

Controller添加@Valid或者@Validated都可以
@RestController
@RequestMapping("/")
public class DemoController {@RequestMapping("test")public String test(@Valid @RequestBody request request) {}
}
@Pattern @NotBlank
//正则: 手机号格式是否正确
public static final String REGEX_PHONE = "(^$)|(^[1][3-9][0-9]{9}$)";@Pattern(regexp = Constants.REGEX_PHONE, message = "借款人手机号格式不正确")
@NotBlank(message = "借款人手机号不能为空")
@ApiModelProperty("借款人手机号")
private String borrowerPhone;
@Pattern(regexp = "[ABCD]", message = "权利取得方式不正确")
@ApiModelProperty("权利取得方式(原始:A,继承:B,承受:C,其他:D)")
@NotBlank(message = "权利取得方式不能为空")
private String acqMode;
@Pattern(regexp = "agree|disagree", message = "分发权利不正确")
@ApiModelProperty("分发权利(agree:同意分发,disagree:不同意分发)")
private String copyrightDispense;
@Past
@Past(message = "首次发表日期不正确")
@ApiModelProperty("首次发表日期")
@NotBlank(message = "首次发表日期不能为空")
private String publishDate;
@Size @Empty
@Empty(message = "字体文件数量不能为空")
@Size(max = 50, message = "字体文件数量过多")
@ApiModelProperty("字体文件")
private List<Long> fontFile;
@Length
@Length(max = 20, message = "企业法人名称过长")
@ApiModelProperty("企业法人名称")
private String legalName;
@Range
@Range(min=0,max=2,message="非法性别")
private String sex;
@Email
@Email(message="非法邮件地址")
private String email;
@Min @Max
@Min(value = 1, message = "作品是否涉及字体1-4以内整数")
@Max(value = 4, message = "作品是否涉及字体1-4以内整数")
@ApiModelProperty("作品是否涉及字体")
private Integer isHasFont;

四、分组校验

public class ValidationGroups {public interface ValidA {}public interface ValidB {}
}@ApiModelProperty("身份证背面id")
@NotNull(message = "身份证背面id不能为空", groups = {ValidationGroups.ValidA.class,ValidationGroups.ValidB.class})
private Long backAttachId;@ApiModelProperty("证件id")
@NotNull(message = "证件id不能为空", groups = ValidationGroups.ValidB.class)
private Long businessAttachId;//注解传参校验
public ResultVo<String> addOrUpdateOwnerTemplate(
@Validated(value = {ValidationGroups.ValidA.class,ValidationGroups.ValidB.class}) @NotNull OwnerTemplateReq ownerTemplateReq) throws Exception {return ownerTemplateService.addOrUpdateOwnerTemplate(ownerTemplateReq);
}//手写代码校验
if (条件) {beanValidate(ownerTemplateReq, ValidationGroups.ValidA.class);
} else {beanValidate(ownerTemplateReq, ValidationGroups.ValidB.class);
}//校验方法
private static <T> void beanValidate(T object, Class<?>... groups) throws ValidationException {Validator validator = Validation.buildDefaultValidatorFactory().getValidator();Set<ConstraintViolation<T>> validate1 = validator.validate(object);if (Objects.nonNull(validate1) && validate1.size() > 0) {String msg = validate1.stream().map(ConstraintViolation::getMessage).collect(Collectors.joining("|"));throw new ServiceException(msg);}Set<ConstraintViolation<T>> validate = validator.validate(object, groups);if (Objects.nonNull(validate) && validate.size() > 0) {String msg = validate.stream().map(ConstraintViolation::getMessage).collect(Collectors.joining("|"));throw new ServiceException(msg);}
}

五、@Validated @Valid

@Validated和@Valid都是Java中用于数据校验的注解,它们通常与Java Bean Validation(JSR 303)规范一起使用。在Spring框架中,可以使用这两个注解对方法参数进行校验。

  1. @Validated:这个注解用于类级别,表示该类中的所有方法都会进行数据校验。它主要用于分组校验,可以将不同的校验规则应用到不同的组上。
  2. @Valid:这个注解用于方法参数级别,表示对该参数进行数据校验。当请求中的参数不满足校验规则时,会抛出MethodArgumentNotValidException异常。例如:
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.RestController;@RestController
@Validated
public class UserController {@PostMapping("/user")public String createUser(@Valid @RequestBody User user) {// 保存用户信息return "success";}
}    

在这个例子中,createUser方法接收一个User对象作为参数,并使用@Valid注解对其进行校验。如果请求中的User对象不满足校验规则,会抛出MethodArgumentNotValidException异常。

六、全局异常处理ConstraintViolationException

import com.fa.notary.common.enums.base.ErrorCode;
import com.fa.notary.vo.ResultVo;
import io.netty.util.internal.ThrowableUtil;
import lombok.extern.log4j.Log4j2;
import org.apache.commons.collections.CollectionUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.dao.DuplicateKeyException;
import org.springframework.validation.BindException;
import org.springframework.validation.FieldError;
import org.springframework.validation.ObjectError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.MissingServletRequestParameterException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import javax.validation.ConstraintViolation;
import javax.validation.ConstraintViolationException;
import java.text.MessageFormat;
import java.util.List;
import java.util.Set;@RestControllerAdvice
@Log4j2
public class GlobalExceptionHandler {/*** 处理所有不可知的异常*/@ExceptionHandler(Throwable.class)public ResultVo handleException(Throwable e){//DuplicateKeyException(唯一索引重复)if (e instanceof DuplicateKeyException) {return  ResultVo.error(ErrorCode.ERROR,"请勿重复添加");}//ServiceExceptionif(e instanceof ServiceException){return  ResultVo.error(ErrorCode.ERROR,((ServiceException) e).getMsg());}//ServiceExceptionif(e instanceof RetryException){return  ResultVo.error(ErrorCode.ERROR,((RetryException) e).getMsg());}//MissingServletRequestParameterExceptionif(e instanceof MissingServletRequestParameterException){String msg = MessageFormat.format("缺少参数{0}", ((MissingServletRequestParameterException) e).getParameterName());return  ResultVo.error(ErrorCode.ILLEGAL_PARAMETER,msg);}//ConstraintViolationExceptionif(e instanceof ConstraintViolationException){// 单个参数校验异常String msg="";Set<ConstraintViolation<?>> sets = ((ConstraintViolationException) e).getConstraintViolations();if(CollectionUtils.isNotEmpty(sets)){StringBuilder sb = new StringBuilder();sets.forEach(error -> {if (error instanceof FieldError) {sb.append(((FieldError)error).getField()).append(":");}sb.append(error.getMessage()).append(";");});msg = sb.toString();msg = StringUtils.substring(msg, 0, msg.length() -1);}return ResultVo.error(ErrorCode.ILLEGAL_PARAMETER,msg);}//BindExceptionif (e instanceof BindException){// get请求的对象参数校验异常String msg ="";List<ObjectError> errors = ((BindException) e).getBindingResult().getAllErrors();msg = getValidExceptionMsg(errors);return ResultVo.error(ErrorCode.ILLEGAL_PARAMETER,msg);}//MethodArgumentNotValidExceptionif (e instanceof MethodArgumentNotValidException){// post请求的对象参数校验异常String msg="";List<ObjectError> errors = ((MethodArgumentNotValidException) e).getBindingResult().getAllErrors();msg = getValidExceptionMsg(errors);return ResultVo.error(ErrorCode.ILLEGAL_PARAMETER,msg);}// 打印堆栈信息log.error(ThrowableUtil.stackTraceToString(e));return ResultVo.error(ErrorCode.ERROR,"网络繁忙,请稍后再试");}private String getValidExceptionMsg(List<ObjectError> errors) {if(CollectionUtils.isNotEmpty(errors)){StringBuilder sb = new StringBuilder();errors.forEach(error -> {if (error instanceof FieldError) {sb.append(((FieldError)error).getField()).append(":");}sb.append(error.getDefaultMessage()).append(";");});String msg = sb.toString();msg = StringUtils.substring(msg, 0, msg.length() -1);return msg;}return null;}
}

这篇关于validation 验证参数的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1083824

相关文章

详解Spring Boot接收参数的19种方式

《详解SpringBoot接收参数的19种方式》SpringBoot提供了多种注解来接收不同类型的参数,本文给大家介绍SpringBoot接收参数的19种方式,感兴趣的朋友跟随小编一起看看吧... 目录SpringBoot接受参数相关@PathVariable注解@RequestHeader注解@Reque

Java向kettle8.0传递参数的方式总结

《Java向kettle8.0传递参数的方式总结》介绍了如何在Kettle中传递参数到转换和作业中,包括设置全局properties、使用TransMeta和JobMeta的parameterValu... 目录1.传递参数到转换中2.传递参数到作业中总结1.传递参数到转换中1.1. 通过设置Trans的

java如何调用kettle设置变量和参数

《java如何调用kettle设置变量和参数》文章简要介绍了如何在Java中调用Kettle,并重点讨论了变量和参数的区别,以及在Java代码中如何正确设置和使用这些变量,避免覆盖Kettle中已设置... 目录Java调用kettle设置变量和参数java代码中变量会覆盖kettle里面设置的变量总结ja

spring 参数校验Validation示例详解

《spring参数校验Validation示例详解》Spring提供了Validation工具类来实现对客户端传来的请求参数的有效校验,本文给大家介绍spring参数校验Validation示例详... 目录前言一、Validation常见的校验注解二、Validation的简单应用三、分组校验四、自定义校

SpringBoot中Get请求和POST请求接收参数示例详解

《SpringBoot中Get请求和POST请求接收参数示例详解》文章详细介绍了SpringBoot中Get请求和POST请求的参数接收方式,包括方法形参接收参数、实体类接收参数、HttpServle... 目录1、Get请求1.1 方法形参接收参数 这种方式一般适用参数比较少的情况,并且前后端参数名称必须

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明(认真看哦) AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证,则会调用 #attemptAuthentica

Andrej Karpathy最新采访:认知核心模型10亿参数就够了,AI会打破教育不公的僵局

夕小瑶科技说 原创  作者 | 海野 AI圈子的红人,AI大神Andrej Karpathy,曾是OpenAI联合创始人之一,特斯拉AI总监。上一次的动态是官宣创办一家名为 Eureka Labs 的人工智能+教育公司 ,宣布将长期致力于AI原生教育。 近日,Andrej Karpathy接受了No Priors(投资博客)的采访,与硅谷知名投资人 Sara Guo 和 Elad G

C++11第三弹:lambda表达式 | 新的类功能 | 模板的可变参数

🌈个人主页: 南桥几晴秋 🌈C++专栏: 南桥谈C++ 🌈C语言专栏: C语言学习系列 🌈Linux学习专栏: 南桥谈Linux 🌈数据结构学习专栏: 数据结构杂谈 🌈数据库学习专栏: 南桥谈MySQL 🌈Qt学习专栏: 南桥谈Qt 🌈菜鸡代码练习: 练习随想记录 🌈git学习: 南桥谈Git 🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈🌈�

如何在页面调用utility bar并传递参数至lwc组件

1.在app的utility item中添加lwc组件: 2.调用utility bar api的方式有两种: 方法一,通过lwc调用: import {LightningElement,api ,wire } from 'lwc';import { publish, MessageContext } from 'lightning/messageService';import Ca

4B参数秒杀GPT-3.5:MiniCPM 3.0惊艳登场!

​ 面壁智能 在 AI 的世界里,总有那么几个时刻让人惊叹不已。面壁智能推出的 MiniCPM 3.0,这个仅有4B参数的"小钢炮",正在以惊人的实力挑战着 GPT-3.5 这个曾经的AI巨人。 MiniCPM 3.0 MiniCPM 3.0 MiniCPM 3.0 目前的主要功能有: 长上下文功能:原生支持 32k 上下文长度,性能完美。我们引入了