SpringCloud微服務實戰——搭建企業級開發框架（八）：使用注解校驗微服務消息參數

  平時開發過程中，經常要用到參數校驗，如果直接在代碼邏輯里面寫參數校驗，代碼有點冗余且用起來不是非常方便，顯得代碼邏輯復雜且重復代碼太多，這里我們使用注解的方式進行參數校驗,SpringBoot中常用的用於參數校驗的注解如下：

@AssertFalse 所注解的元素必須是Boolean類型，且值為false
@AssertTrue 所注解的元素必須是Boolean類型，且值為true
@DecimalMax 所注解的元素必須是數字，且值小於等於給定的值
@DecimalMin 所注解的元素必須是數字，且值大於等於給定的值
@Digits 所注解的元素必須是數字，且值必須是指定的位數
@Future 所注解的元素必須是將來某個日期
@Max 所注解的元素必須是數字，且值小於等於給定的值
@Min 所注解的元素必須是數字，且值小於等於給定的值
@Range 所注解的元素需在指定范圍區間內
@NotNull 所注解的元素值不能為null
@NotBlank 所注解的元素值有內容
@Null 所注解的元素值為null
@Past 所注解的元素必須是某個過去的日期
@PastOrPresent 所注解的元素必須是過去某個或現在日期
@Pattern 所注解的元素必須滿足給定的正則表達式
@Size 所注解的元素必須是String、集合或數組，且長度大小需保證在給定范圍之內
@Email 所注解的元素需滿足Email格式

1、在GitEgg-Platform工程的子工程gitegg-platform-boot里添加spring-boot-starter-validation依賴，因為自SpringBoot2.3.X開始spring-boot-starter-web默認不再引入校驗框架，這里需要手動引入,pom.xml如下

<!--?xml version="1.0" encoding="UTF-8"?-->
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactid>GitEgg-Platform</artifactid>
        <groupid>com.gitegg.platform</groupid>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelversion>4.0.0</modelversion>

    <artifactid>gitegg-platform-boot</artifactid>
    <name>${project.artifactId}</name>
    <version>${project.parent.version}</version>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-web</artifactid>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-validation</artifactid>
        </dependency>
        <dependency>
            <groupid>com.gitegg.platform</groupid>
            <artifactid>gitegg-platform-swagger</artifactid>
            <optional>true</optional>
        </dependency>
    </dependencies>

</project>

2、GitEgg-Platform工程重新install，在GitEgg-Cloud工程的子工程gitegg-service-system里面新建類SystemDTO.java

package com.gitegg.service.system.dto;

import lombok.Data;

import javax.validation.constraints.*;

@Data
public class SystemDTO {

    @NotNull
    @Min(value = 10, message = "id必須大於10")
    @Max(value = 150, message = "id必須小於150")
    private Long id;

    @NotNull(message = "名稱不能為空")
    @Size(min = 3, max = 20, message = "名稱長度必須在3-20之間")
    private String name;
}

3、SystemController.java類里面添加參數校驗測試接口

package com.gitegg.service.system.controller;

import com.gitegg.platform.boot.common.base.Result;
import com.gitegg.platform.boot.common.exception.BusinessException;
import com.gitegg.service.system.dto.SystemDTO;
import com.gitegg.service.system.service.ISystemService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.AllArgsConstructor;
import org.springframework.web.bind.annotation.*;

import javax.validation.Valid;

@RestController
@RequestMapping(value = "system")
@AllArgsConstructor
@Api(tags = "gitegg-system")
public class SystemController {

    private final ISystemService systemService;

    @GetMapping(value = "list")
    @ApiOperation(value = "system list接口")
    public Object list() {
        return systemService.list();
    }


    @GetMapping(value = "page")
    @ApiOperation(value = "system page接口")
    public Object page() {
        return systemService.page();
    }

    @GetMapping(value = "exception")
    @ApiOperation(value = "自定義異常及返回測試接口")
    public Result<string> exception() {
        return Result.data(systemService.exception());
    }

    @PostMapping(value = "valid")
    @ApiOperation(value = "參數校驗測試接口")
    public Result<systemdto> valid(@Valid @RequestBody SystemDTO systemDTO) {
        return Result.data(systemDTO);
    }
}

4、運行GitEggSystemApplication.java，打開瀏覽器訪問：http://127.0.0.1:8001/doc.html，然后點擊左側的參數校驗測試接口，使用Swagger2進行測試，即可查看校驗結果

5、這里的提示信息用到了上一章節講到的統一異常處理邏輯：

    /**
     * 非法請求-參數校驗
     */
    @ExceptionHandler(value = {MethodArgumentNotValidException.class})
    public Result handlerMethodArgumentNotValidException(MethodArgumentNotValidException methodArgumentNotValidException) {
        //獲取異常字段及對應的異常信息
        StringBuffer stringBuffer = new StringBuffer();
        methodArgumentNotValidException.getBindingResult().getFieldErrors().stream()
                .map(t -> t.getField() + t.getDefaultMessage() + ";")
                .forEach(e -> stringBuffer.append(e));
        String errorMessage = stringBuffer.toString();
        Result result = Result.error(ResultCodeEnum.PARAM_VALID_ERROR, errorSystem + errorMessage);
        return result;
    }

本文源碼在https://gitee.com/wmz1930/GitEgg的chapter-08分支。