java自定義驗證器的實現(xiàn)示例

更新時間：2024年01月18日 08:26:43 作者：飛起的豹子

在對外暴露接口中，我們通常會對入?yún)⑦M行驗證，比如一些字符串非空判斷等，本文主要介紹了java自定義驗證器的實現(xiàn)示例，具有一定的參考價值，感興趣的可以了解一下

前言

在對外暴露接口中，我們通常會對入?yún)⑦M行驗證，比如一些字符串非空判斷、數(shù)字最小值最大值這些基礎的判斷在java驗證規(guī)范中已經(jīng)提供了，然而這些只是常規(guī)的驗證，我們可以通過自定義注解以及驗證器來進行我們自己業(yè)務上的一些驗證，這樣可以避免在業(yè)務邏輯中添加過多的驗證，降低代碼的可讀性。

使用

1、依賴引入

僅需引入驗證包即可，當然，如果使用的springboot，可以直接管理依賴，不用指定版本

        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
        </dependency>

2、自定義注解

這里添加一個銀行卡驗證的注解，其實核心注解就是@Constraint，這個注解要求我們的注解中必須有message()groups()以及payload()這三個方法

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

/**
 * 銀行卡號校驗注解
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
// 這里指定驗證器
@Constraint(validatedBy = {BankCardValidator.class})
@Target({ElementType.FIELD,ElementType.ANNOTATION_TYPE,ElementType.PARAMETER})
public @interface BankCardValidity {

    /**
     * 提示信息
     * @return String
     */
    String message() default "";

    /**
     * 是否驗證
     * @return boolean
     */
    boolean required() default true;

    /**
     * groups
     * @return []
     */
    Class<?>[] groups() default {};


    /**
     * payload
     * @return []
     */
    Class<? extends Payload>[] payload() default {};
}

3、編寫驗證器

驗證器的核心是實現(xiàn)ConstraintValidator這個類，第一個參數(shù)是指定注解，第二個則是指定的入?yún)?/p>

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * 銀行卡號校驗器
 */
public class BankCardValidator implements ConstraintValidator<BankCardValidity,String> {

    /**
     * 是否強制驗證
     */
    private boolean required = false;

    /**
     * 銀行卡號正則校驗,這里就是一個正則驗證
     */
    private static Pattern patternForBankCardNo = Pattern.compile("^([1-9]{1})(\\d{15}|\\d{18})$");
	
	/**
	 * 這里就是驗證邏輯，返回true驗證通過，返回false驗證不通過
	 */
    @Override
    public boolean isValid(String bankCardNo, ConstraintValidatorContext context) {
        if (required) {
            return isBankCardNo(bankCardNo);
        } else {
            if (StrUtil.isBlank(bankCardNo)) {
                return false;
            }
            return isBankCardNo(bankCardNo);
        }
    }

    @Override
    public void initialize(BankCardValidity validity) {
        required = validity.required();
    }

    /**
     * 驗證是否為銀行卡號
     * @param bankCardNo 輸入內容
     * @return boolean
     */
    private static boolean isBankCardNo(String bankCardNo) {
        // 使用的hutool工具包，也可以使用其它工具包
        if (StrUtil.isBlank(bankCardNo)) {
            return false;
        }
        Matcher matcherForBankCardNo = patternForBankCardNo.matcher(bankCardNo);
        return matcherForBankCardNo.matches() ;
    }
}

至此編碼就完成了，我們可以在注解中添加新的方法，在initialize()方法中使用，或者取值等操作，這都是根據(jù)業(yè)務場景來進行的。
當然，在入?yún)⑿z中，我們肯定也需要把@Valid等注解加上，驗證器才會去驗證。

到此這篇關于java自定義驗證器的實現(xiàn)示例的文章就介紹到這了,更多相關java自定義驗證器內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: