快捷導(dǎo)航

Java中@Constraint實(shí)現(xiàn)自定義校驗(yàn)注解

更新時(shí)間：2025年05月22日 10:14:55 作者：月軒居士

本文主要介紹了Java中@Constraint實(shí)現(xiàn)自定義校驗(yàn)注解,需配合ConstraintValidator實(shí)現(xiàn)校驗(yàn)邏輯,適用于HibernateValidator等框架,感興趣的可以了解一下

@Constraint 是 Java 中用于定義自定義校驗(yàn)注解的一個(gè)元注解。它通常與 Hibernate Validator 或其他基于 JSR 380（Bean Validation 2.0）的校驗(yàn)框架一起使用。通過(guò) @Constraint 注解，你可以創(chuàng)建自己的校驗(yàn)邏輯，并將其應(yīng)用到實(shí)體類的字段上

1. 創(chuàng)建自定義校驗(yàn)注解

首先，定義一個(gè)自定義校驗(yàn)注解。假設(shè)我們想創(chuàng)建一個(gè)注解 @ValidLength，用于校驗(yàn)字符串的最大長(zhǎng)度為20位。

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Constraint(validatedBy = ValidLengthValidator.class)
@Target({ ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.PARAMETER })
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidLength {
    String message() default "長(zhǎng)度必須在1到20個(gè)字符之間";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    int min() default 1;
    int max() default 20;
}

2. 創(chuàng)建校驗(yàn)器

接下來(lái)，創(chuàng)建一個(gè)實(shí)現(xiàn) ConstraintValidator 接口的類，用于實(shí)現(xiàn)具體的校驗(yàn)邏輯。

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class ValidLengthValidator implements ConstraintValidator<ValidLength, String> {

    private int min;
    private int max;

    @Override
    public void initialize(ValidLength constraintAnnotation) {
        this.min = constraintAnnotation.min();
        this.max = constraintAnnotation.max();
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null) {
            return true; // 允許為空
        }
        return value.length() >= min && value.length() <= max;
    }
}

3. 應(yīng)用自定義校驗(yàn)注解

在實(shí)體類中使用自定義校驗(yàn)注解。

import javax.validation.constraints.NotNull;

public class User {

    @NotNull
    @ValidLength(min = 1, max = 20)
    private String username;

    // Getters and Setters
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }
}

4. 測(cè)試校驗(yàn)

編寫一個(gè)測(cè)試類來(lái)驗(yàn)證校驗(yàn)邏輯是否按預(yù)期工作。

import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ValidatorFactory;
import javax.validation.ConstraintViolation;
import java.util.Set;

public class Main {
    public static void main(String[] args) {
        User user = new User();
        user.setUsername("12345678901234567890"); // 20位，合法

        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
        Validator validator = factory.getValidator();

        Set&lt;ConstraintViolation&lt;User&gt;&gt; violations = validator.validate(user);
        for (ConstraintViolation&lt;User&gt; violation : violations) {
            System.out.println(violation.getMessage());
        }

        if (violations.isEmpty()) {
            System.out.println("校驗(yàn)通過(guò)");
        } else {
            System.out.println("校驗(yàn)失敗");
        }
    }
}

輸出
運(yùn)行上述代碼后，如果 username 的長(zhǎng)度在1到20個(gè)字符之間，輸出將是：
校驗(yàn)通過(guò)
如果 username 的長(zhǎng)度超過(guò)20個(gè)字符或小于1個(gè)字符，輸出將是：
長(zhǎng)度必須在1到20個(gè)字符之間
校驗(yàn)失敗

總結(jié)

自定義校驗(yàn)注解：使用 @Constraint 注解定義自定義校驗(yàn)注解。
校驗(yàn)器：實(shí)現(xiàn) ConstraintValidator 接口，編寫具體的校驗(yàn)邏輯。
應(yīng)用注解：在實(shí)體類的字段上使用自定義校驗(yàn)注解。
測(cè)試校驗(yàn)：使用 Validator 對(duì)象進(jìn)行校驗(yàn)，并處理校驗(yàn)結(jié)果。

到此這篇關(guān)于Java中@Constraint實(shí)現(xiàn)自定義校驗(yàn)注解的文章就介紹到這了,更多相關(guān)Java 自定義校驗(yàn)注解內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: