SpringBootでJSR303に基づいて簡単な検証アノテーションをカスタマイズする方法

1.環境

• SpringBoot2.2.2.RELEASE
• 依存関係validation-api（これは関数の導入の依存関係のみです）

 	 <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>2.0.1.Final</version>
        </dependency>

2.カスタム検査アノテーションを作成します

• @interfaceクラスを作成するために、ここでは例としてValidValueを使用します。
• JSR303規則では次の3つが必要です

	// 校验不通过时返回的错误信息
    String message() default "The specified value must be submitted";
	// 在需要多个校验规则的时候可以指定是哪个组的校验规则
    Class<?>[] groups() default {
    
    };
	//
    Class<? extends Payload>[] payload() default {
    
    };

• 設定されたルールは、int[] vals() default {};検証に使用するルールです。これは、入力する番号が配列に含まれている必要があることを意味します。
• 完全な例は次のとおりです（クラスのアノテーションが何を使用しているかわからない場合は、チェックアノテーションをクリックしてコピーするだけです）
• 内部のValidValueConstraintValidatorバリデーター（以下で説明）は、検証アノテーションにバインドする必要があります

/**
 * @Author: llzhyaa 
 * @Date: 2020/4/10 21:05
 * validatedBy = {} 可以指定多个校验器
 */
@Documented
@Constraint(
        validatedBy = {
    
    ValidValueConstraintValidator.class}
)
@Target({
    
    ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidValue{
    
    
    // 这三个是必须有的
    String message() default "The specified value must be submitted";

    Class<?>[] groups() default {
    
    };

    Class<? extends Payload>[] payload() default {
    
    };

    int[] vals() default  {
    
    };
}

3.カスタムバリデーターを作成します

• バリデーターを定義する必要があります
• A extends Annotation 指定注解 (就是你上面自定义注解的名字)
• T 指定类型 ，就是你需要校验的变量的类型

/**
 * @Author: llzhyaa 
 * @Date: 2020/4/10 21:15
 * 校验器
 * ConstraintValidator<A extends Annotation, T>
 *     A extends Annotation 指定注解 (就是你上面自定义注解的名字)
 *     T 指定类型 
 */
public class ValidValueConstraintValidator implements ConstraintValidator<ValidValue,Integer> {
    
    

    private Set<Integer> set = new HashSet<>();

    @Override
    public void initialize(ValidValue constraintAnnotation) {
    
    
        // 初始化 , 获取到在你注解上的数字，存入一个set中
        int[] vals = constraintAnnotation.vals();
        if(vals  != null){
    
    
          for (int val : vals) {
    
    
            set.add(val);
       		 }
        }	
    }

    // 判断是否校验成功

    /**
     *
     * @param integer 需要校验的值（就是你传入的值）
     * @param constraintValidatorContext
     * @return
     */
    @Override
    public boolean isValid(Integer integer, ConstraintValidatorContext constraintValidatorContext) {
    
    
		// 校验，获取到你输入的数字是否包含在你之前的set中
        return set.contains(integer);
    }
}

• カスタムチェッカーをカスタムチェックアノテーションに関連付ける
• これは@Constraint、カスタムバリデーターをカスタム検証アノテーションにバインドすることです

@Constraint(
      validatedBy = {
    
    ValidValueConstraintValidator.class}
)

4.コントローラーにコメントを追加します

• @Valid着信値を検証する必要があることを示します
• BindingResult result、エラー情報を取得できます

	@ResponseBody
    @RequestMapping("/test")
    public Map<String,String> test(@Valid String showStatus ,BindingResult result){
    
    
       if (result.hasErrors()){
    
    
            // 获取错误结果
            Map<String,String> map = new HashMap<>();
            result.getFieldErrors().forEach((item)->{
    
    
                // FieldError 获取错误提示
                String message = item.getDefaultMessage();
                String field = item.getField();
                map.put(field,message);
            })
        }
        return map ;
    }

4.テスト

• 検証する必要のある変数に注釈を追加するだけです
• @ValidValue(vals = {0,1})、つまり、入力する番号は0または1でなければなりません。別の番号の場合、エラーが報告されます

	@ValidValue(vals = {
    
    0,1})
	private Integer showStatus;

• エラーの詳細を見てください。

 	{
    
    
   		 // 这里就是你自定义的默认返回错误
        "showStatus": "The specified value must be submitted",
    }

5.返されたエラーメッセージをカスタマイズする方法

• jarパッケージによって提供されるコメントでは、それらのエラーメッセージはすべてjarパッケージに配置されます。これは、ValidationMessages.propertiesグローバル検索でValidationMessages確認できます。
• 例えば

javax.validation.constraints.AssertFalse.message     = must be false
javax.validation.constraints.AssertTrue.message      = must be true
javax.validation.constraints.DecimalMax.message      = must be less than ${
    
    inclusive == true ? 'or equal to ' : ''}{
    
    value}
javax.validation.constraints.DecimalMin.message      = must be greater than ${
    
    inclusive == true ? 'or equal to ' : ''}{
    
    value}
javax.validation.constraints.Digits.message          = numeric value out of bounds (<{
    
    integer} digits>.<{
    
    fraction} digits> expected)
javax.validation.constraints.Email.message           = must be a well-formed email address
javax.validation.constraints.Future.message          = must be a future date
javax.validation.constraints.FutureOrPresent.message = must be a date in the present or in the future
javax.validation.constraints.Max.message             = must be less than or equal to {
    
    value}
javax.validation.constraints.Min.message             = must be greater than or equal to {
    
    value}
javax.validation.constraints.Negative.message        = must be less than 0
javax.validation.constraints.NegativeOrZero.message  = must be less than or equal to 0
javax.validation.constraints.NotBlank.message        = must not be blank
javax.validation.constraints.NotEmpty.message        = must not be empty
javax.validation.constraints.NotNull.message         = must not be null

• したがって、ValidationMessages.propertiesファイルを自分で作成して、resourcesディレクトリに配置します。
• com.study.common.valid.ValidValue.messageカスタムアノテーションはプラスですか.message

com.study.common.valid.ValidValue.message=输入的数字必须不规范

• 次に、カスタムアノテーションの上のデフォルトの戻り情報を変更する必要があります

 String message() default "{com.study.common.valid.ListValue.message}";