Codes HTTP retournés et leurs contextes
L’application utilise les codes HTTP standard pour signaler des erreurs fonctionnelles ou techniques. Chaque code est déclenché dans des contextes précis, principalement par le filtre de sécurité et l’action de souscription.
Le 403 Forbidden est émis par le filtre de sécurité quand le jeton CSRF est absent, trop long ou ne correspond pas à celui stocké en session pour une requête POST sur une action .do. Ce mécanisme protège contre les attaques CSRF et garantit que les formulaires proviennent bien de l’application.
Le 404 Not Found est retourné dans deux cas :
- lors de l’accès à un produit inexistant dans le catalogue (route
/produit.doavec un code invalide) ; - quand aucune route ne correspond à la requête dans l’action de souscription (cas par défaut en fin de traitement).
Le 405 Method Not Allowed est déclenché dans plusieurs scénarios :
- si la méthode HTTP utilisée n’est pas autorisée (seules GET, HEAD et POST sont acceptées) ;
- si une requête POST est envoyée sur
/catalogue.doou/produit.do(ces routes sont réservées au GET) ; - si une requête GET est envoyée sur
/commencer.doou/confirmer.do(ces routes exigent POST) ; - si une requête POST est envoyée sur
/confirmation.doou/recapitulatif.do(ces routes sont réservées au GET).
Le 409 Conflict est retourné quand la clé de confirmation (confirmationKey) fournie dans la requête de confirmation ne correspond pas à celle stockée dans le brouillon (Draft) en session. Ce code indique que le récapitulatif affiché n’est plus synchronisé avec l’état actuel de la souscription.
Le 503 Service Unavailable est positionné par l’action de souscription quand une erreur SQL survient lors de l’enregistrement de la souscription confirmée. Dans ce cas, l’application affiche un message d’indisponibilité temporaire directement sur la page de récapitulatif, sans rediriger vers la page d’erreur générale.
Consulter les sources (3)
- Marty Harness · source
- src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/CatalogAction.java · lignes 13–31
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
Messages affichés sur la page erreur.jsp
La page erreur.jsp affiche des messages adaptés en fonction du code HTTP reçu, via l’attribut jakarta.servlet.error.status_code.
Pour le 403, le message est :
Le formulaire a expiré ou son jeton de sécurité est invalide. Rechargez la page avant de réessayer.
Pour le 404, le message est :
La page ou le produit demandé est introuvable.
Pour le 409, le message est :
Ce récapitulatif n’est plus à jour. Revenez à la simulation pour vérifier votre demande.
Pour les autres codes (comme 405 ou 500), un message générique est affiché :
La demande est invalide ou le service est indisponible. Aucune confirmation n’est émise sur cette page.
Notez que le 503 déclenché lors de l’enregistrement d’une souscription n’affiche pas de message sur erreur.jsp, mais directement sur la page de récapitulatif avec le texte :
L’enregistrement est momentanément indisponible. Aucune confirmation n’a été émise. Votre saisie est conservée ; vous pouvez réessayer.
Consulter les sources (2)
- Marty Harness · source
- src/main/webapp/WEB-INF/jsp/erreur.jsp · lignes 1–12
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
Gestion des conflits sur confirmation_key
Le confirmationKey est un identifiant unique généré automatiquement pour chaque demande en cours. Il est régénéré à chaque modification des informations du souscripteur ou des paramètres de la simulation.
Cette régénération garantit qu’un récapitulatif affiché à l’utilisateur devient obsolète dès qu’une étape précédente est modifiée. Lorsqu’un utilisateur tente de confirmer une souscription avec un confirmationKey qui ne correspond plus à celui stocké en session, l’application retourne un 409 Conflict et redirige vers la page d’erreur.
En base de données, la table des souscriptions impose une contrainte d’unicité sur le champ confirmation_key. Si, par une coïncidence extrême, un même identifiant était généré pour deux souscriptions distinctes, le dépôt détecte la violation de contrainte et retourne la souscription existante au lieu de provoquer une erreur. Ce mécanisme évite les doublons tout en préservant l’intégrité des données.
Consulter les sources (4)
- Marty Harness · source
- src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
- Marty Harness · source
- src/main/java/fr/demo/souscription/model/Draft.java · lignes 6–28
- Marty Harness · source
- src/main/java/fr/demo/souscription/repository/SubscriptionRepository.java · lignes 24–115
- Marty Harness · source
- src/main/resources/db/schema.sql · lignes 1–1; src/main/resources/db/schema.sql · lignes 1–21