我們?cè)陂_(kāi)發(fā)Java項(xiàng)目的時(shí)候，經(jīng)常需要對(duì)參數(shù)進(jìn)行一些必填項(xiàng)、格式、長(zhǎng)度等進(jìn)行校驗(yàn)，如果手寫(xiě)代碼對(duì)參數(shù)校驗(yàn)，每個(gè)接口會(huì)需要很多低級(jí)的代碼，這樣會(huì)降低代碼的可讀性。那么我們能不能使用一種比較優(yōu)雅的方式來(lái)實(shí)現(xiàn)，對(duì)請(qǐng)求中的參數(shù)進(jìn)行校驗(yàn)?zāi)兀?/p>

knife4j的安裝與使用可參考我的博客：SpringBoot使用knife4j進(jìn)行在線接口調(diào)試

正文

ValidationApi框架就是用來(lái)解決參數(shù)校驗(yàn)中代碼冗余問(wèn)題，ValidationApi框架提供一些注解用來(lái)幫助我們對(duì)請(qǐng)求參數(shù)進(jìn)行校驗(yàn)：

SpringBoot使用validation-api實(shí)現(xiàn)參數(shù)校驗(yàn)

注入依賴

<!--參數(shù)校驗(yàn)--><dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.0.1.Final</version></dependency><!--提供一些字符串操作--><dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> <version>3.3.2</version></dependency><!--lombok--><dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.2</version> <optional>true</optional></dependency><!--knife4j接口--><dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>knife4j-spring-boot-starter</artifactId> <version>2.0.4</version></dependency>

UserPojoReq.java請(qǐng)求封裝類

如果成員變量是其他對(duì)象實(shí)體，該變量必須加 @Valid，否則嵌套中的驗(yàn)證不生效

@Setter@Getter@ToString@ApiModel('用戶對(duì)象')public class UserPojoReq extends Request implements Serializable { private static final long serialVersionUID = -354657839724457905L; @ApiModelProperty(required = true, notes = '主鍵', example = '123') private String id; @ApiModelProperty(required = true, notes = '用戶名', example = 'luo') @NotNull(message = '用戶姓名為必填項(xiàng)，不得為空') @Size(min = 2,max = 20,message = '用戶名長(zhǎng)度要在2—8個(gè)字符') private String name; @ApiModelProperty(required = true, notes = '消息', example = '消息') private String msg;}

CouponTypeEnum.class :錯(cuò)誤碼枚舉類

@Getterpublic enum CouponTypeEnum { PARAMETER_ERROR(1001, '請(qǐng)求參數(shù)有誤!'), UNKNOWN_ERROR(9999, '未知的錯(cuò)誤!”); /** * 狀態(tài)值 */ private int couponType; /** * 狀態(tài)描述 */ private String couponTypeDesc; CouponTypeEnum(int couponType, String couponTypeDesc){ this.couponType = couponType; this.couponTypeDesc = couponTypeDesc; } public static String getDescByType(int couponType) { for (CouponTypeEnum type : CouponTypeEnum.values()) { if (type.couponType == couponType) {return type.couponTypeDesc; } } return null; } public String getcouponTypeStr(){ return String.valueOf(this.couponType); }}

BusinessException.java:自定義業(yè)務(wù)異常類

/** * 業(yè)務(wù)自定義異常 */@Getterpublic class BusinessException extends RuntimeException { private static final long serialVersionUID = -1895174013651345407L; private final CouponTypeEnum errorCode; private String primaryErrorCode; private String primaryErrorMsg; private String primaryErrorIP; public BusinessException(CouponTypeEnum errorCode) { this(errorCode, errorCode.getCouponTypeDesc()); } public BusinessException(CouponTypeEnum errorCode, String message) { super(message); this.errorCode = errorCode; } public BusinessException(CouponTypeEnum errorCode, String message,String primaryErrorCode,String primaryErrorMsg,String primaryErrorIP) { super(message); this.errorCode = errorCode; this.primaryErrorCode=primaryErrorCode; this.primaryErrorMsg=primaryErrorMsg; this.primaryErrorIP=primaryErrorIP; } public BusinessException(CouponTypeEnum errorCode,String primaryErrorCode,String primaryErrorMsg,String primaryErrorIP) { this(errorCode, errorCode.getCouponTypeDesc()); this.primaryErrorCode=primaryErrorCode; this.primaryErrorMsg=primaryErrorMsg; this.primaryErrorIP=primaryErrorIP; }}

GlobalExceptionHandler.class 攔截異常并統(tǒng)一處理

MissingServletRequestParameterException：必填項(xiàng)為null異常 HttpMessageNotReadableException：參數(shù)類型不匹配異常 MethodArgumentNotValidException：JSON校驗(yàn)失敗異常（比如長(zhǎng)度等） BusinessException：自定義的異常 Exception：其他異常

@RestControllerAdvice('com.luo.producer.controller')@Slf4jpublic class GlobalExceptionHandler { /** * 忽略參數(shù)異常處理器 * * @param e 忽略參數(shù)異常 * @return Response */ @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler(MissingServletRequestParameterException.class) public Response parameterMissingExceptionHandler(MissingServletRequestParameterException e) { log.error('', e); return new Response(CouponTypeEnum.PARAMETER_ERROR.getcouponTypeStr(), '請(qǐng)求參數(shù) ' + e.getParameterName() + ' 不能為空'); } /** * 缺少請(qǐng)求體異常處理器 * * @param e 缺少請(qǐng)求體異常 * @return Response */ @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler(HttpMessageNotReadableException.class) public Response parameterBodyMissingExceptionHandler(HttpMessageNotReadableException e) { log.error('', e); return new Response(CouponTypeEnum.PARAMETER_ERROR.getcouponTypeStr(), '參數(shù)體不能為空'); } /** * 參數(shù)效驗(yàn)異常處理器 * * @param e 參數(shù)驗(yàn)證異常 * @return ResponseInfo */ @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler(MethodArgumentNotValidException.class) public Response parameterExceptionHandler(MethodArgumentNotValidException e) { log.error('', e); // 獲取異常信息 BindingResult exceptions = e.getBindingResult(); // 判斷異常中是否有錯(cuò)誤信息，如果存在就使用異常中的消息，否則使用默認(rèn)消息 if (exceptions.hasErrors()) { List<ObjectError> errors = exceptions.getAllErrors(); if (!errors.isEmpty()) {// 這里列出了全部錯(cuò)誤參數(shù)，按正常邏輯，只需要第一條錯(cuò)誤即可FieldError fieldError = (FieldError) errors.get(0);return new Response(CouponTypeEnum.PARAMETER_ERROR.getcouponTypeStr(), fieldError.getDefaultMessage()); } } return new Response(CouponTypeEnum.PARAMETER_ERROR); } /** * 自定義參數(shù)錯(cuò)誤異常處理器 * * @param e 自定義參數(shù) * @return ResponseInfo */ @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler({BusinessException.class}) public Response paramExceptionHandler(BusinessException e) { log.error('', e); // 判斷異常中是否有錯(cuò)誤信息，如果存在就使用異常中的消息，否則使用默認(rèn)消息 if (!StringUtils.isEmpty(e.getMessage())) { return new Response(CouponTypeEnum.PARAMETER_ERROR.getcouponTypeStr(), e.getMessage()); } return new Response(CouponTypeEnum.PARAMETER_ERROR); } /** * 其他異常 * * @param e * @return */ @ResponseStatus(HttpStatus.BAD_REQUEST) @ExceptionHandler({Exception.class}) public Response otherExceptionHandler(Exception e) { log.error('其他異常', e); // 判斷異常中是否有錯(cuò)誤信息，如果存在就使用異常中的消息，否則使用默認(rèn)消息 if (!StringUtils.isEmpty(e.getMessage())) { return new Response(CouponTypeEnum.UNKNOWN_ERROR.getcouponTypeStr(), e.getMessage()); } return new Response(CouponTypeEnum.UNKNOWN_ERROR); }}

驗(yàn)證

測(cè)試接口

@Valid被標(biāo)記的實(shí)體將會(huì)開(kāi)啟一個(gè)校驗(yàn)的功能

@RequestBody：請(qǐng)求實(shí)體需要加上@RequestBody否則MethodArgumentNotValidException異常將會(huì)被識(shí)別成Exception異常，提示信息將與預(yù)期不符。

@RestController@Slf4jpublic class UserController { @PostMapping('/helloluo') @MyPermissionTag(value = 'true') public String helloluo(@RequestBody @Valid UserPojoReq userPojoReq){ return 'Hello World”+userPojoReq; }}

模擬請(qǐng)求參數(shù)，進(jìn)行接口訪問(wèn)：

到此這篇關(guān)于SpringBoot使用validation-api實(shí)現(xiàn)參數(shù)校驗(yàn)的示例的文章就介紹到這了,更多相關(guān)SpringBoot validation參數(shù)校驗(yàn)內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)！