Formations — 1 037 leçons en français

Accueil › Spring Boot › Valider les données avec Bean Validation

Valider les données avec Bean Validation

Créer une API RESTdebutant

Bean Validation (les annotations jakarta.validation.constraints.*) permet de décrire des règles sur un DTO et de les faire vérifier automatiquement par Spring. Il faut d'abord ajouter la dépendance, absente du starter web depuis Spring Boot 2.3 :

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

Ensuite, on annote le DTO et on ajoute @Valid devant @RequestBody :

public record CreationProduitDto(
        @NotBlank String nom,
        @Positive double prix,
        @NotNull String categorie
) { }

@PostMapping("/produits")
public ResponseEntity<Produit> creer(@Valid @RequestBody CreationProduitDto dto) {
    Produit produit = service.creer(dto);
    return ResponseEntity.ok(produit);
}

Si une contrainte échoue, Spring lève une MethodArgumentNotValidException avant que le corps de la méthode ne s'exécute, traduite automatiquement en réponse 400 Bad Request avec le détail des champs invalides. Aucun if manuel n'est nécessaire.

Les termes à connaître

spring-boot-starter-validation

Dépendance à ajouter pour utiliser Bean Validation (Hibernate Validator). Depuis Spring Boot 2.3, elle n'est plus incluse automatiquement dans spring-boot-starter-web : il faut l'ajouter explicitement au projet.

@Valid

Annotation (jakarta.validation.Valid) posée sur un paramètre de méthode (typiquement @RequestBody) pour déclencher la validation de l'objet selon les contraintes posées sur ses champs.

@NotNull, @NotBlank, @NotEmpty

Contraintes de présence. @NotNull : la valeur n'est pas null (accepte une chaîne vide). @NotEmpty : ni null ni vide (chaîne, collection). @NotBlank : en plus, une chaîne ne peut pas être uniquement des espaces.

@Size, @Min, @Max, @Positive

Contraintes numériques et de taille. @Size(min=, max=) sur une chaîne ou une collection. @Min/@Max sur un nombre. @Positive (ou @PositiveOrZero) exige une valeur strictement positive (ou positive ou nulle).

@Email, @Pattern, @Past

@Email valide un format d'adresse électronique. @Pattern(regexp = "...") valide une chaîne contre une expression régulière. @Past exige une date antérieure à maintenant (utile pour une date de naissance).

MethodArgumentNotValidException

Exception levée quand @Valid détecte une violation de contrainte sur un @RequestBody. Traduite automatiquement en réponse 400 Bad Request par Spring Boot.

HandlerMethodValidationException

Depuis Spring Framework 6.1, exception levée quand un @PathVariable ou @RequestParam porteur d'une contrainte (ex. @Min(1)) échoue à la validation. Traduite automatiquement en 400 Bad Request.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.