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 pasnull(accepte une chaîne vide).@NotEmpty: ninullni 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/@Maxsur un nombre.@Positive(ou@PositiveOrZero) exige une valeur strictement positive (ou positive ou nulle).- @Email, @Pattern, @Past
@Emailvalide un format d'adresse électronique.@Pattern(regexp = "...")valide une chaîne contre une expression régulière.@Pastexige une date antérieure à maintenant (utile pour une date de naissance).- MethodArgumentNotValidException
Exception levée quand
@Validdé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
@PathVariableou@RequestParamporteur d'une contrainte (ex.@Min(1)) échoue à la validation. Traduite automatiquement en 400 Bad Request.
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.