Accueil › Fullstack Angular + Spring Boot › De Bean Validation au formulaire Angular, champ par champ
De Bean Validation au formulaire Angular, champ par champ
Les erreurs de bout en boutdebutant
Un formulaire mal relié au back se reconnaît tout de suite : l'utilisateur voit « Erreur 400 » et doit devenir devin. L'objectif est qu'il voie le message sous le champ concerné.
Côté back, la validation déclarative et un handler qui produit une structure champ → message :
public record CreerProduitRequest(
@NotBlank(message = "Le nom est obligatoire")
@Size(max = 120, message = "Le nom ne peut pas dépasser 120 caractères")
String nom,
@NotNull(message = "Le prix est obligatoire")
@DecimalMin(value = "0.01", message = "Le prix doit être supérieur à 0")
BigDecimal prix) { }
@Override
protected ResponseEntity<Object> handleMethodArgumentNotValid(
MethodArgumentNotValidException ex, HttpHeaders en, HttpStatusCode st, WebRequest req) {
Map<String, String> champs = ex.getBindingResult().getFieldErrors().stream()
.collect(Collectors.toMap(FieldError::getField,
e -> Objects.requireNonNullElse(e.getDefaultMessage(), "Valeur invalide"),
(a, b) -> a)); // un seul message par champ
ProblemDetail p = ProblemDetail.forStatusAndDetail(
HttpStatus.BAD_REQUEST, "Certains champs sont invalides.");
p.setTitle("Formulaire invalide");
p.setProperty("code", "VALIDATION");
p.setProperty("erreursChamps", champs);
return ResponseEntity.badRequest().body(p);
}
Côté front, les noms de champs du DTO doivent correspondre aux noms des contrôles :
this.formulaire = this.fb.group({
nom: ['', [Validators.required, Validators.maxLength(120)]],
prix: [null as number | null, [Validators.required, Validators.min(0.01)]],
});
Le contrat implicite est donc : un nom de champ DTO = un nom de contrôle. Le respecter rend le report d'erreurs automatique.
Les termes à connaître
- Bean Validation (Jakarta Validation)
Norme de validation déclarative par annotations (
@NotBlank,@Size,@Email,@Min…) posées sur les champs d'un DTO. Spring Boot l'active via la dépendancespring-boot-starter-validationet la déclenche avec@Validsur le paramètre du contrôleur.- MethodArgumentNotValidException
Exception levée par Spring MVC quand un
@RequestBody @Validéchoue. Elle porte unBindingResultqui liste les champs en faute, avec pour chacun le nom du champ et le message de la contrainte violée.- FieldError
Objet du
BindingResultdécrivant une violation sur un champ précis :getField()donne le nom du champ (prix,adresse.ville),getDefaultMessage()le message de la contrainte. C'est la paire nom-message que le front attend.- Validation croisée
Règle portant sur plusieurs champs à la fois (« la date de fin doit suivre la date de début »). Elle s'exprime avec une contrainte de classe (
@ClassConstraintpersonnalisée) ou se vérifie dans le service. Côté front, l'équivalent est un validateur posé sur leFormGroupet non sur un contrôle.- setErrors()
Méthode d'un contrôle Angular (
AbstractControl) qui lui attribue des erreurs depuis l'extérieur. C'est le point d'entrée pour reporter sur le formulaire les erreurs renvoyées par le back :controle.setErrors({ serveur: message }).- Validation front / validation back
La validation front sert le confort (retour immédiat, moins d'allers-retours) ; la validation back assure l'intégrité (elle est la seule qui compte). Elles sont redondantes par nature, et c'est voulu : le front peut être contourné.
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.