Formations — 1 037 leçons en français

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épendance spring-boot-starter-validation et la déclenche avec @Valid sur le paramètre du contrôleur.

MethodArgumentNotValidException

Exception levée par Spring MVC quand un @RequestBody @Valid échoue. Elle porte un BindingResult qui liste les champs en faute, avec pour chacun le nom du champ et le message de la contrainte violée.

FieldError

Objet du BindingResult dé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 (@ClassConstraint personnalisée) ou se vérifie dans le service. Côté front, l'équivalent est un validateur posé sur le FormGroup et 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é.

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.