Java參數(shù)校驗詳解之使用@Valid注解和自定義注解進(jìn)行參數(shù)驗證

更新時間：2024年06月22日 11:44:07 作者：是小錢-

在后端開發(fā)中,參數(shù)校驗是非常普遍的,下面這篇文章主要給大家介紹了關(guān)于Java參數(shù)校驗詳解之使用@Valid注解和自定義注解進(jìn)行參數(shù)驗證的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下

@Valid 注解對入?yún)⑦M(jìn)行相應(yīng)的校驗：

注解使用在方法參數(shù)上，然后對于參數(shù)的校驗要求可去參數(shù)的實體類進(jìn)行校驗條件的填寫。

/**
 * @author Z
 * @date 2023/9/27 21:25
 */
@Data
public class User {
    @NotNull //賬號非空
    //這個@Mobile是自定義判斷注解，下面有對其的創(chuàng)建進(jìn)行詳細(xì)的講解
    @Mobile(required = true) 
    private String mobile;
?
    @NotNull //密碼非空
    @Length(min = 32)  //長度的限制
    private String password;
}

以及如： @Size(min=1, max=12) 代表：長度在 1 ~ 12 字符之間。其他一些判斷的注解可以去該導(dǎo)入的外部庫查看。

也可以自定判斷條件注解：如@Mobile這個自定義的注解：

1.創(chuàng)建軟件包：Validation

2.創(chuàng)建需要的注解：Mobile

3.而對于這個注解的寫法，直接去拷貝javax.validation 包中已經(jīng)寫好的注解，如：@Notnull注解進(jìn)行修改：（有報錯的地方就刪除不用即可）

@Notnull注解如下：

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(NotNull.List.class)  //爆紅了刪除
@Documented
@Constraint(validatedBy = {}) //校驗規(guī)則的定義
public @interface NotNull {
    String message() default "{javax.validation.constraints.NotNull.message}";
    //修改校驗的消息
?
    Class<?>[] groups() default {};
?
    Class<? extends Payload>[] payload() default {};
?
}

而在這里在添加一條屬性：（代表必填）

 boolean required() default true;

自定義的@Mobile如下：

/**
 * @author Z
 * @date 2023/9/28 8:53
 */
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
//自己定義校驗規(guī)則的一個類：MobileValidator.class （手機(jī)號碼校驗規(guī)則類）
//將自定義規(guī)則類放進(jìn)@Constraint(validatedBy={}) 中
@Constraint(validatedBy = {MobileValidator.class})
public @interface Mobile {
?
    boolean required() default true;
?
    //信息，拋出的是BindException，前端頁面接收的話，我們要進(jìn)行異常的捕獲
    String message() default "手機(jī)號碼格式錯誤";
?
    Class<?>[] groups() default {};
?
    Class<? extends Payload>[] payload() default {};
}

而我們需要進(jìn)行自己定義檢驗規(guī)則，創(chuàng)建一個校驗規(guī)則類，并將其放進(jìn)@Constraint(validatedBy={}) 中

自定義校驗規(guī)則類：

/**
 * 手機(jī)號碼校驗規(guī)則
 *
 * @author Z
 * @date 2023/9/28 8:56
 */
public class MobileValidator implements ConstraintValidator<Mobile, String> {
?
    private boolean required = false;
?
    //初始化：獲取是否需要是必填的
    @Override
    public void initialize(Mobile constraintAnnotation) {
        //獲取到填的值:true或者false
        required = constraintAnnotation.required();
    }
?
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        //必填：則使用手機(jī)號碼校驗工具類去校驗
        if (required){
            return ValidatorUtil.Mobile(value);
        //非必填：
        }else {
            if (StringUtils.isEmpty(value)){ //傳的號碼為空
                return true;
            }else {
                //傳的號碼非空，則使用手機(jī)號碼校驗工具類去校驗
                return ValidatorUtil.isMobile(value);
            }
        }
    }
}

而對于手機(jī)號碼的校驗工具類：

添加依賴：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
</dependency>

使用正則表達(dá)進(jìn)行手機(jī)號碼的校驗：

import org.apache.commons.lang3.StringUtils;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
?
/**
 * 手機(jī)號碼校驗類 (使用正則表達(dá)式)
 *
 * @author Z
 * @date 2023/9/27 21:45
 */
public class ValidatorUtil {
?
    private static final Pattern mobile_pattern = Pattern.compile("[1]([3-9])[0-9]{9}$");
?
    public static boolean Mobile(String mobile) {
        if (StringUtils.isEmpty(mobile)){
            return false;
        }
        Matcher matcher = mobile_pattern.matcher(mobile);
        return matcher.matches();
    }
}

總結(jié)

到此這篇關(guān)于Java參數(shù)校驗詳解之使用@Valid注解和自定義注解進(jìn)行參數(shù)驗證的文章就介紹到這了,更多相關(guān)Java @Valid注解和自定義注解參數(shù)驗證內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: