Brugerdefinerede constraint-annoteringer
Opret en brugerdefineret @UniqueEmail-annotering med en ConstraintValidator-implementering.
Brugerdefinerede constraint-annoteringer er en gratis Java Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i Java Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Java Academy-kurset indeholder 4 lektioner i alt.
Når standardbegrænsninger ikke er nok
Standardannotations fra Bean Validation dækker almindelige tilfælde. Til domænespecifikke regler (f.eks. unik e-mail, gyldig IBAN eller adgangskodestyrke) skal du oprette tilpassede begrænsningsannotations.
Definition af begrænsningsannotationen
Opret en annotation med @Constraint(validatedBy = ...), de obligatoriske elementer message, groups og payload samt passende indstillinger for opbevaring og mål.
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 {};
}Implementering af ConstraintValidator
Implementér ConstraintValidator<UniqueEmail, String>. Metoden initialize læser annotationselementerne, mens isValid udfører selve kontrollen.
@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);
}
}Brug af den tilpassede begrænsning
Anvend annotationen som enhver standardbegrænsning på et felt, en parameter eller en returværdi.
public record CreateUserRequest(
@NotBlank
String name,
@NotBlank @Email @UniqueEmail
String email
) {}Tilpasset meddelelse med interpolation
Referér til annotationselementer i meddelelsen med {elementName}. Brug ctx.buildConstraintViolationWithTemplate() til at tilføje tilpassede meddelelser med dynamiske data.
@Constraint(validatedBy = RangeValidator.class)
public @interface InRange {
int min() default 0;
int max() default 100;
String message() default "Must be between {min} and {max}";
// ...
}Begrænsning på klasseniveau
Anvend en begrænsning på klasseniveau for at validere flere felter samlet — det er nyttigt til regler på tværs af felter, f.eks. bekræftelse af adgangskoder.
@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 {};
}Implementering af validator på klasseniveau
Validatoren modtager hele objektet. Tilgå flere felter for at udføre validering på tværs af felter.
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;
}
}Sammensætning af begrænsninger
Opret en metabegrænsning ved at annotere din tilpassede annotation med eksisterende begrænsninger. Begge anvendes automatisk.
@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 {};
}Returnering af flere overtrædelser
Brug ctx.disableDefaultConstraintViolation(), og tilføj individuelle overtrædelsesmeddelelser for hvert problem, der findes i ét valideringsgennemløb.
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;
}Spring-administrerede validatorer
Da UniqueEmailValidator er annoteret med @Component, injicerer Spring repositories i den. Det fungerer kun, hvis validatoren startes gennem Springs validator, som Spring Boot automatisk kobler til.
Test af tilpassede validatorer
Enhedstest validatorer direkte — der er ikke brug for en Spring-kontekst til ren valideringslogik. Brug Validation.buildDefaultValidatorFactory() til integrationstests.
Validator validator = Validation.buildDefaultValidatorFactory().getValidator();
CreateUserRequest req = new CreateUserRequest("", "bad-email", null);
Set<ConstraintViolation<CreateUserRequest>> violations = validator.validate(req);
System.out.println(violations.size()); // 3Hurtigt tjek
Hvilken grænseflade implementerer en validator for en tilpasset begrænsning?
Opsummering
Opret @interface med @Constraint(validatedBy=...). Implementér ConstraintValidator. Brug @Component til Spring-injektion. Begrænsninger på klasseniveau validerer flere felter samlet. Sammensæt eksisterende begrænsninger for at undgå gentagelser.
Lær Java med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 104
- Lektioner
- 374
Ofte stillede spørgsmål
Er lektionen “Brugerdefinerede constraint-annoteringer” gratis?
Ja — hele teksten til “Brugerdefinerede constraint-annoteringer” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af Java Academy-kurset, skal du opgradere til CoddyKit PRO. Java Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Brugerdefinerede constraint-annoteringer”?
Opret en brugerdefineret @UniqueEmail-annotering med en ConstraintValidator-implementering. Du øver dig i Java Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på Java Academy?
Der kræves ingen tidligere erfaring. Java Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 2 af 4.
Hvor lang tid tager lektionen “Brugerdefinerede constraint-annoteringer”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne Java Academy-lektion?
Ja. Alle Java Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Bean Validation: @NotNull, @Size, @Pattern
- Brugerdefinerede constraint-annoteringer
- Global fejlhåndtering med @ControllerAdvice
- RFC 7807 Problem Details og ensartede fejlresponses