0Pricing
Java Academy · Lezione

Annotazioni di vincoli personalizzate

Crei un'annotazione @UniqueEmail personalizzata con un'implementazione di ConstraintValidator.

Annotazioni di vincoli personalizzate è una lezione Java Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Java Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Java Academy include 4 lezioni in totale.

Quando i vincoli standard non bastano

Le annotazioni standard di Bean Validation coprono i casi più comuni. Per regole specifiche del dominio (ad esempio, email univoche, IBAN validi o robustezza delle password), crei annotazioni di vincolo personalizzate.

Definizione dell'annotazione di vincolo

Crei un'annotazione con @Constraint(validatedBy = ...), gli elementi obbligatori message, groups e payload, nonché la ritenzione e il target appropriati.

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
@Documented
@Constraint(validatedBy = UniqueEmailValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface UniqueEmail {
    String message() default "Email already registered";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

Implementazione di ConstraintValidator

Implementi ConstraintValidator<UniqueEmail, String>. Il metodo initialize legge gli elementi dell'annotazione; isValid esegue il controllo effettivo.

@Component
public class UniqueEmailValidator implements ConstraintValidator<UniqueEmail, String> {
    @Autowired private UserRepository repo;
    @Override
    public boolean isValid(String email, ConstraintValidatorContext ctx) {
        if (email == null) return true; // let @NotBlank handle null
        return !repo.existsByEmail(email);
    }
}

Utilizzo del vincolo personalizzato

Applichi l'annotazione come un qualsiasi vincolo standard a un campo, a un parametro o a un valore restituito.

public record CreateUserRequest(
    @NotBlank
    String name,
    @NotBlank @Email @UniqueEmail
    String email
) {}

Messaggio personalizzato con interpolazione

Faccia riferimento agli elementi dell'annotazione nel messaggio utilizzando {elementName}. Utilizzi ctx.buildConstraintViolationWithTemplate() per aggiungere messaggi personalizzati con dati dinamici.

@Constraint(validatedBy = RangeValidator.class)
public @interface InRange {
    int min() default 0;
    int max() default 100;
    String message() default "Must be between {min} and {max}";
    // ...
}

Vincolo a livello di classe

Applichi un vincolo a livello di classe per validare più campi insieme, utile per regole tra campi come la conferma della password.

@Documented
@Constraint(validatedBy = PasswordMatchValidator.class)
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface PasswordMatch {
    String message() default "Passwords do not match";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

Implementazione del validator a livello di classe

Il validator riceve l'intero oggetto. Acceda a più campi per eseguire la validazione tra campi.

public class PasswordMatchValidator implements ConstraintValidator<PasswordMatch, ChangePasswordRequest> {
    public boolean isValid(ChangePasswordRequest req, ConstraintValidatorContext ctx) {
        if (req.getNewPassword() == null) return true;
        boolean match = req.getNewPassword().equals(req.getConfirmPassword());
        if (!match) {
            ctx.disableDefaultConstraintViolation();
            ctx.buildConstraintViolationWithTemplate("Passwords do not match")
               .addPropertyNode("confirmPassword").addConstraintViolation();
        }
        return match;
    }
}

Composizione dei vincoli

Crei un metavincolo annotando la propria annotazione personalizzata con vincoli esistenti. Entrambi vengono applicati automaticamente.

@NotBlank
@Email
@Size(max = 255)
@Constraint(validatedBy = {})
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidEmail {
    String message() default "Invalid email";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

Restituzione di più violazioni

Utilizzi ctx.disableDefaultConstraintViolation() e aggiunga singoli messaggi di violazione per ogni problema rilevato durante una singola esecuzione del validator.

public boolean isValid(String password, ConstraintValidatorContext ctx) {
    List<String> issues = new ArrayList<>();
    if (password.length() < 8) issues.add("Too short");
    if (!password.matches(".*\\d.*")) issues.add("Must contain a digit");
    if (issues.isEmpty()) return true;
    ctx.disableDefaultConstraintViolation();
    issues.forEach(msg -> ctx.buildConstraintViolationWithTemplate(msg).addConstraintViolation());
    return false;
}

Validator gestiti da Spring

Poiché UniqueEmailValidator è annotato con @Component, Spring vi inietta i repository. Funziona solo se il validator viene inizializzato tramite il validator di Spring, che Spring Boot collega automaticamente.

Test dei validator personalizzati

Testi direttamente i validator con test unitari: per la logica di validazione pura non è necessario il contesto Spring. Utilizzi Validation.buildDefaultValidatorFactory() per i test di integrazione.

Validator validator = Validation.buildDefaultValidatorFactory().getValidator();
CreateUserRequest req = new CreateUserRequest("", "bad-email", null);
Set<ConstraintViolation<CreateUserRequest>> violations = validator.validate(req);
System.out.println(violations.size()); // 3

Verifica rapida

Quale interfaccia implementa un validator di vincoli personalizzato?

Riepilogo

Crei una @interface con @Constraint(validatedBy=...). Implementi ConstraintValidator. Utilizzi @Component per l'iniezione di Spring. I vincoli a livello di classe validano più campi insieme. Componga vincoli esistenti per evitare duplicazioni.

Domande Frequenti

La lezione «Annotazioni di vincoli personalizzate» è gratuita?

Sì — il testo completo di «Annotazioni di vincoli personalizzate» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Java Academy, passa a CoddyKit PRO. Il corso Java Academy include 4 lezioni in totale.

Cosa imparerò in «Annotazioni di vincoli personalizzate»?

Crei un'annotazione @UniqueEmail personalizzata con un'implementazione di ConstraintValidator. Eserciti Java Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Java Academy?

Non è richiesta alcuna esperienza precedente. Java Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Annotazioni di vincoli personalizzate»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Java Academy?

Sì. Ogni lezione Java Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Validazione dei bean: @NotNull, @Size, @Pattern
  2. Annotazioni di vincoli personalizzate
  3. Gestione globale delle eccezioni con @ControllerAdvice
  4. Problem Details RFC 7807 e risposte di errore coerenti
← Torna a Java Academy