1 JSR303引數驗證註解

JSR(Java 規範提案)是Java Specification Requests的縮寫，是指向JCP(Java Community Process)提出新增一個標準化技術規範的正式請求。

2 應用

2.1 註解型別

2.2 程式碼舉例

1.在springboot各個版本中，有的版本spring-boot-starter-web 依賴中沒有org.springframework.boot:spring-boot-starter-validation這個依賴所以需要手動匯入，有的話就不需要了

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

2.程式碼

domain

package com.yh.jsr303.domain;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import org.hibernate.validator.constraints.Range;
import org.springframework.format.annotation.DateTimeFormat;

import javax.validation.constraints.*;
import java.math.BigDecimal;
import java.time.LocalDate;

/**
 * @author yh
 * @date 2020/8/10 11:03
 * @description:
 */
@Data
public class Person {

    @NotNull(message = "id不能為空")
    private Long id;

    @Future(message = "需要一個將來日期") // 只能是將來的日期
    @DateTimeFormat(pattern = "yyyy-MM-dd") // 日期格式化轉換
    @JsonFormat(timezone = "GMT+8", pattern = "yyyy-MM-dd HH:mm:ss")//格式化接收的日期
    private LocalDate date;

    @DecimalMin(value = "0.1") // 最小值0.1元
    @DecimalMax(value = "10000.00") // 最大值10000元
    private BigDecimal doubleValue;

    @Min(value = 0, message = "最小值為0") // 最小值為1
    @Max(value = 127, message = "最大值為127") // 最大值88
    private Integer integer;

    @Range(min = 1, max = 100, message = "範圍為1至100") // 限定範圍
    private Long range;

    // 郵箱驗證
    @Email(message = "郵箱格式錯誤")
    private String email;

    @Size(min = 10, max = 16, message = "字串長度要求10到16之間。")
    private String size;
}

controller

package com.yh.jsr303.controller;

import com.yh.jsr303.domain.Person;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.validation.Valid;

/**
 * @author yh
 * @date 2020/8/10 11:26
 * @description:
 */
@RestController
@RequestMapping("/person")
public class PersonController {
    //	然後在controller的每個介面中使用@Valid和BindingResult類
    // @Valid註解用於驗證一個入參，驗證之後的訊息繫結到BindingResult類中：
    public ResponseEntity<Void> queryPerson(@Valid Person person, BindingResult bindingResult){
        if(bindingResult.hasErrors()){
            //丟擲異常或者返回  bindingResult.getFieldError().getDefaultMessage();
        }
        return ResponseEntity.ok().build();
    }
}