Java Academy · Les

Bean Validation: @NotNull, @Size, @Pattern

Voorzie DTO's van Bean Validation-beperkingen en activeer validatie met @Valid in controllers.

Les 1 van 413 stappen

Bean Validation: @NotNull, @Size, @Pattern is een gratis Java Academy-les op CoddyKit. Dit is les 1 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Java Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Java Academy bevat in totaal 4 lessen.

Wat is Bean Validation?

Bean Validation (Jakarta Bean Validation 3.0) biedt declaratieve annotaties voor beperkingen aan Java-beans. Spring Boot configureert automatisch een validator en activeert deze via @Valid of @Validated.

@NotNull, @NotEmpty, @NotBlank

@NotNull: de waarde mag niet null zijn. @NotEmpty: niet null en niet leeg (voor tekenreeksen en collecties). @NotBlank: niet null, niet leeg en niet uitsluitend witruimte. Gebruik bij tekenreeksen bij voorkeur @NotBlank.

public record CreateUserRequest(
    @NotBlank(message = "Name is required")
    String name,
    @NotBlank @Email
    String email,
    @NotNull
    UserRole role
) {}

@Size en @Length

@Size(min, max) beperkt de grootte van tekenreeksen, collecties, mappen en arrays. @Length (Hibernate) werkt alleen op tekenreeksen. Gebruik voor draagbaarheid bij voorkeur @Size.

@Size(min = 3, max = 50, message = "Name must be 3-50 characters")
private String name;
@Size(min = 1, max = 10, message = "Cart must have 1-10 items")
private List<CartItem> items;

@Min, @Max, @Positive, @Range

Numerieke beperkingen: @Min/@Max voor exacte grenzen, @Positive/@PositiveOrZero voor tekenbeperkingen en @DecimalMin/@DecimalMax voor BigDecimal.

@Min(1) @Max(100)
private int quantity;
@DecimalMin("0.01") @DecimalMax("99999.99")
private BigDecimal price;
@Positive
private long orderId;

@Pattern voor validatie met reguliere expressies

@Pattern(regexp) valideert tekenreeksen aan de hand van een reguliere expressie. Dit is nuttig voor telefoonnummers, postcodes en aangepaste notaties.

@Pattern(regexp = "^\\+?[1-9]\\d{7,14}$", message = "Invalid phone number")
private String phone;
@Pattern(regexp = "^[A-Z]{2}\\d{5}$", message = "Invalid postal code (e.g. AB12345)")
private String postalCode;

@Email en @URL

@Email valideert de notatie van e-mailadressen (een basisondersteuning voor RFC 5321). @URL (Hibernate) valideert de URL-notatie. Combineer deze altijd met @NotBlank, omdat ze null toestaan.

@NotBlank @Email
private String email;
// Hibernate-specific:
@URL(protocol = "https")
private String profileUrl;

@Past, @Future, @PastOrPresent

Datum/tijd-beperkingen valideren datum- en tijdwaarden. Ze werken met LocalDate, LocalDateTime, Instant en meer.

@Past(message = "Birth date must be in the past")
private LocalDate birthDate;
@Future(message = "Expiry must be in the future")
private LocalDate expiryDate;

Validatie activeren met @Valid

Voeg @Valid toe aan een parameter van een controllermethode. Spring valideert het object en werpt bij een fout MethodArgumentNotValidException op, met een 400-status (Ongeldig verzoek) als resultaat.

@PostMapping("/users")
public ResponseEntity<UserDto> create(@Valid @RequestBody CreateUserRequest req) {
    User user = userService.create(req);
    return ResponseEntity.status(201).body(UserDto.from(user));
}

Cascadende validatie met @Valid op velden

Als je geneste objecten wilt valideren, annoteer je het veld met @Valid, naast de beperkingen op klasseniveau.

public record OrderRequest(
    @NotNull @Valid
    AddressRequest shippingAddress, // validates AddressRequest constraints too
    @Valid @NotEmpty
    List<@Valid LineItemRequest> items
) {}

Validatiegroepen

Gebruik groepen om in verschillende contexten verschillende beperkingen toe te passen (bijvoorbeeld bij aanmaken versus bijwerken). Annoteer met de groepsinterface en activeer deze met @Validated(CreateGroup.class).

public interface CreateGroup {}
public interface UpdateGroup {}
public record UserRequest(
    @NotBlank(groups = CreateGroup.class) String password,
    @NotNull(groups = UpdateGroup.class)  Long id
) {}
// Controller:
@PutMapping("/{id}")
public UserDto update(@Validated(UpdateGroup.class) @RequestBody UserRequest req) { ... }

Validatiefouten uitlezen

Vang MethodArgumentNotValidException op in een @ControllerAdvice om veldfouten te extraheren en gestructureerde foutreacties op te bouwen.

@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, String>> handleValidation(MethodArgumentNotValidException ex) {
    Map<String, String> errors = new LinkedHashMap<>();
    ex.getBindingResult().getFieldErrors().forEach(e ->
        errors.put(e.getField(), e.getDefaultMessage()));
    return ResponseEntity.badRequest().body(errors);
}

Korte controle

Welke annotatie valideert dat een String niet null en niet leeg is (dus niet alleen uit witruimte bestaat)?

Beantwoord dit in de interactieve les

Samenvatting

Voorzie DTO's van beperkingen voor Bean Validation. Voeg @Valid toe in controllers om validatie te activeren. Gebruik @NotBlank voor tekenreeksen, @Size voor lengtes, @Pattern voor reguliere expressies en @Past/@Future voor datums. Handel fouten af in @ControllerAdvice.

Gratis beginnen

Leer Java met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 104
Lessen: 374

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Bean Validation: @NotNull, @Size, @Pattern” gratis?

Ja — de volledige tekst van “Bean Validation: @NotNull, @Size, @Pattern” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Java Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Java Academy bevat in totaal 4 lessen.

Wat leer ik in “Bean Validation: @NotNull, @Size, @Pattern”?

Voorzie DTO's van Bean Validation-beperkingen en activeer validatie met @Valid in controllers. Je oefent met Java Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Java Academy te beginnen?

Ervaring vooraf is niet nodig. Java Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 1 van 4.

Hoe lang duurt de les “Bean Validation: @NotNull, @Size, @Pattern”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Java Academy?

Ja. Elke les over Java Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

Bean Validation: @NotNull, @Size, @Pattern
Aangepaste constraint-annotaties
Globale exceptionafhandeling met @ControllerAdvice
RFC 7807 Problem Details en consistente foutreacties

← Terug naar Java Academy