<!-- https://mvnrepository.com/artifact/javax.validation/validation-api -->
    <dependency>
      <groupId>javax.validation</groupId>
      <artifactId>validation-api</artifactId>
      <version>1.1.0.Final</version>
    </dependency>

// 表明注解可以使用在哪里
// 這里表示注解可以使用在 方法 屬性  注解  構(gòu)造方法  參數(shù)  type 
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
//描述保留注解的各種策略，它們與元注解(@Retention)一起指定注釋要保留多長(zhǎng)時(shí)間
@Retention(RetentionPolicy.RUNTIME)
//表明這個(gè)注解是由 javadoc記錄的
@Documented
public @interface MyOwnAnnotation {
    
}

@Documented
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
// 這個(gè)表明可以重復(fù)使用，
//例如在一個(gè)field使用這個(gè)注解
// 一般注解只能使用一次
//@Max(value = 11)
//Long num;
// 如果使用了這個(gè)@Repeatable標(biāo)注，那就可以使用兩次
//@Max(value = 11)
//@Max(value = 22)
//Long num;
@Repeatable(AssertFalse.List.class)
// 這個(gè)Constraint 指定驗(yàn)證類，如果不自定義指定，實(shí)現(xiàn)其默認(rèn)的驗(yàn)證類 ，如果指定
// @Constraint(validatedBy = { MyValidator.class })
@Constraint(validatedBy = {})
public @interface AssertFalse {
    // 校驗(yàn)失敗的信息，可以自定義
    String message() default "{javax.validation.constraints.AssertFalse.message}";
    // 這里主要進(jìn)行將validator進(jìn)行分類，不同的類group中會(huì)執(zhí)行不同的validator操作
    Class<?>[] groups() default {};
	// 這個(gè)主要是指定bean，一般很少使用
    Class<? extends Payload>[] payload() default {};

    @Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface List {
        AssertFalse[] value();
    }
}

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(Max.List.class)
@Documented
@Constraint(validatedBy = {})
public @interface Max {
    // 校驗(yàn)失敗的信息，可以自定義
    String message() default "{javax.validation.constraints.Max.message}";

    // 這里主要進(jìn)行將validator進(jìn)行分類，不同的類group中會(huì)執(zhí)行不同的validator操作
    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};
	// 與上面不同的就是多了個(gè)value，這個(gè)需要自定義參數(shù)傳入的值與這個(gè)value值對(duì)比，也就是校驗(yàn)的參考值
    long value();

    @Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface List {
        Max[] value();
    }
}

@NotNull(message = "姓名不能為空")
private String name;

等同于
import javax.validation.groups.Default;
@NotNull(message = "姓名不能為空" , groups = {Default.class})
private String name;  

import javax.validation.groups.Default;

public interface CreateUser extends Default {
}

import javax.validation.groups.Default;

public interface UpdateUser extends Default{
}

@Data
class User{
    	
    	@NotNull(message = "用戶id不能為空", groups = UpdateUser.class)
    	private Integer id;
   
        @NotNull(message = "姓名不能為空" ,groups = {CreateUser.class, UpdateUser.class})
        private String name;
    
        @NotNull(message = "性別不能為空")
        private String sex;
    
        @Max(value = 20 ,message = "最大長(zhǎng)度為20")
        private String address;
    
        @Email(message = "不滿足郵箱格式")
        private String email;
    
        @AssertTrue(message = "字段為true才能通過(guò)")
        private boolean isAuth;
    
        @NotBlank(message = "手機(jī)號(hào)不能為空")
        @Pattern(regexp = "^[1][3,4,5,6,7,8,9][0-9]{9}$", message = "手機(jī)號(hào)格式有誤")
        private String mobile;
    
        @Future(message = "時(shí)間在當(dāng)前時(shí)間之后才可以通過(guò)")
        private Date date;
}

 /**
     * 走參數(shù)校驗(yàn)注解的 groups 組合校驗(yàn)
     *
     * @param user
     * @return
     */
@PostMapping("/users/update")
public ResponseDTO updateUser(@RequestBody @Validated(UpdateUser.class) User user) {
     userService.updateById(userDTO);
     return ResponseDTO.success();
}


 /**
     * 走參數(shù)校驗(yàn)注解的 groups 組合校驗(yàn)
     *
     * @param user
     * @return
     */
@PostMapping("/users/save")
public ResponseDTO saveUser(@RequestBody @Validated(CreateUser.class) User user) {
     userService.saveUser(userDTO);
     return ResponseDTO.success();
}

@Data
class User{
   
        @NotNull(message = "姓名不能為空")
        private String name;
    
        @NotNull(message = "性別不能為空")
        private String sex;
    
        @Max(value = 20 ,message = "最大長(zhǎng)度為20")
        private String address;
    
        @Email(message = "不滿足郵箱格式")
        private String email;
    
        @AssertTrue(message = "字段為true才能通過(guò)")
        private boolean isAuth;
    
        @NotBlank(message = "手機(jī)號(hào)不能為空")
        @Pattern(regexp = "^[1][3,4,5,6,7,8,9][0-9]{9}$", message = "手機(jī)號(hào)格式有誤")
        private String mobile;
    
        @Future(message = "時(shí)間在當(dāng)前時(shí)間之后才可以通過(guò)")
        private Date date;
}

@RequestMapping("users")
public ResponseDTO saveUser( @RequestBody @Validated User user){
    
}

import com.dto.ResponseDTO;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.dao.DuplicateKeyException;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.servlet.NoHandlerFoundException;

import javax.validation.ConstraintViolationException;
import javax.validation.ValidationException;

@RestControllerAdvice
public class GlobalExceptionHandler {

    private Logger logger = LoggerFactory.getLogger(getClass());

    private static int DUPLICATE_KEY_CODE = 1001;
    private static int PARAM_FAIL_CODE = 1002;
    private static int VALIDATION_CODE = 1003;

    /**
     * 處理自定義異常
     */
    @ExceptionHandler(BizException.class)
    public ResponseDTO handleRRException(BizException e) {
        logger.error(e.getMessage(), e);
        return new ResponseDTO(e.getCode(), e.getMessage());
    }

    /**
     * 方法參數(shù)校驗(yàn)
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseDTO handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        logger.error(e.getMessage(), e);
        return new ResponseDTO(PARAM_FAIL_CODE, e.getBindingResult().getFieldError().getDefaultMessage());
    }

    /**
     * ValidationException
     */
    @ExceptionHandler(ValidationException.class)
    public ResponseDTO handleValidationException(ValidationException e) {
        logger.error(e.getMessage(), e);
        return new ResponseDTO(VALIDATION_CODE, e.getCause().getMessage());
    }

    /**
     * ConstraintViolationException
     */
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseDTO handleConstraintViolationException(ConstraintViolationException e) {
        logger.error(e.getMessage(), e);
        return new ResponseDTO(PARAM_FAIL_CODE, e.getMessage());
    }
	/**
	* 路徑異常
	*/
    @ExceptionHandler(NoHandlerFoundException.class)
    public ResponseDTO handlerNoFoundException(Exception e) {
        logger.error(e.getMessage(), e);
        return new ResponseDTO(404, "不好意思，路徑不存在，請(qǐng)檢查路徑是否正確");
    }
	/**
	* 所有其他異常捕捉
	*/
    @ExceptionHandler(Exception.class)
    public ResponseDTO handleException(Exception e) {
        logger.error(e.getMessage(), e);
        return new ResponseDTO(500, "不好意思，系統(tǒng)繁忙,請(qǐng)稍后再試");
    }
}

@RestController
@RequestMapping("user/")
@Validated
public class UserController{
    @RequestMapping("users)
    public ResponseDTO getUser(@RequestParam("userId") @NotNull(message = "用戶id不能為空") Long userId){

    }
}

@Documented
// 這里標(biāo)注該注解是使用在filed和參數(shù)上的
@Target({ElementType.PARAMETER, ElementType.FIELD})
// 運(yùn)行時(shí)生效
@Retention(RetentionPolicy.RUNTIME)
// 指定驗(yàn)證的類是哪個(gè)   MyValidator 就是第二步做的事情
@Constraint(validatedBy = MyValidator.class)
public @interface MyValid {
	// 提供自定義異常的信息，可以指定默認(rèn)值
    String message() default "參數(shù)不合法";
    // 分組，詳細(xì)看 上面的介紹 
    Class<?>[] groups() default {};
	// 針對(duì)bean的，使用不多
    Class<? extends Payload>[] payload() default {};
}

// 這個(gè)是Max的指定的驗(yàn)證規(guī)則源碼
public abstract class AbstractMaxValidator<T> implements ConstraintValidator<Max, T> {
    protected long maxValue;

    public AbstractMaxValidator() {
    }
    public void initialize(Max maxValue) {
        this.maxValue = maxValue.value();
    }
    public boolean isValid(T value, ConstraintValidatorContext constraintValidatorContext) {
        if (value == null) {
            return true;
        } else {
            return this.compare(value) <= 0;
        }
    }
    protected abstract int compare(T var1);
}

// 自定義的驗(yàn)證類
public class MyValidator implements ConstraintValidator {
    @Override
    public void initialize(Annotation constraintAnnotation) {
		// 可以獲取注解的值 ，一般寫(xiě)在該方法中
    }

    @Override
    public boolean isValid(Object o, ConstraintValidatorContext constraintValidatorContext) {
        // 編寫(xiě)自己屬性驗(yàn)證的規(guī)則，o 則是待驗(yàn)證的值
        return false;
    }
}

// 自定義的驗(yàn)證類
public class MyValidator implements ConstraintValidator<MyValid , Object> {
    @Override
    public void initialize(MyValid myValid) {
		// 可以獲取注解的值 ，一般寫(xiě)在該方法中
    }

    @Override
    public boolean isValid(Object o, ConstraintValidatorContext constraintValidatorContext) {
        // 編寫(xiě)自己屬性驗(yàn)證的規(guī)則，o 則是待驗(yàn)證的值
        return false;
    }
}

@Data
public Class Example{
    @NotBlank(message = "姓名不能為空")
    @MyValid(message = "姓名有誤,請(qǐng)核對(duì)后提交")
    private String name;
}