MartyAIDocumentation

Traitement des requêtes HTTP et dispatching Struts

Suivre le parcours d'une requête depuis SecurityFilter jusqu'à l'affichage JSP, en identifiant les validations et les transitions.

Validation des méthodes HTTP et du jeton CSRF par SecurityFilter

SecurityFilter intercepte toute requête HTTP en amont du traitement Struts. Il applique systématiquement des en-têtes de sécurité à chaque réponse : X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Referrer-Policy: no-referrer, une Content-Security-Policy restrictive (interdiction des scripts, iframes, etc.) et Cache-Control: no-store. Il restreint les méthodes HTTP autorisées à GET, HEAD et POST ; toute autre méthode reçoit un code 405 Method Not Allowed avec un en-tête Allow: GET, HEAD, POST.

Pour les requêtes dont le chemin se termine par .do (cibles Struts), le filtre gère un jeton CSRF : il initialise un attribut de session csrf avec une valeur UUID aléatoire si celui-ci est absent, en synchronisant l’accès à la session. Pour les requêtes POST, il vérifie que le paramètre csrf est présent, ne dépasse pas 100 caractères, et correspond exactement au jeton stocké en session via une comparaison constante en temps (MessageDigest.isEqual). En cas d’absence, de taille excessive ou de non-correspondance, il renvoie un code 403 Forbidden et interrompt la chaîne de filtres.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56

Routage des requêtes via les ActionMappings de struts-config.xml

Le fichier struts-config.xml centralise la configuration du routage. Il déclare un unique form-bean subscriptionForm de type SubscriptionForm, utilisé par toutes les actions du parcours de souscription. Six global-forwards associent des noms logiques (catalogue, produit, souscripteur, simulation, recapitulatif, confirmation) aux chemins JSP sous /WEB-INF/jsp/.

Les action-mappings définissent les associations entre chemins et classes Action :

  • /catalogue et /produit → CatalogAction (sans form-bean, validate=false)
  • /commencer, /souscripteur, /simulation, /recapitulatif, /confirmer, /confirmation → SubscriptionAction (avec subscriptionForm, scope=request, validate=false)

CatalogAction ne traite que les requêtes GET : pour /catalogue, il expose la liste des produits et renvoie le forward catalogue ; pour /produit, il charge le produit demandé via son code et renvoie le forward produit.

Consulter les sources (3)
Marty Harness · source
src/main/webapp/WEB-INF/struts-config.xml · lignes 1–27
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/CatalogAction.java · lignes 13–31

Gestion des données de session entre les étapes

SubscriptionAction utilise la session HTTP pour maintenir l’état du parcours de souscription, en synchronisant chaque accès via synchronized (session). Deux objets clés sont stockés :

  • Draft : créé lors de /commencer (POST) avec le Product sélectionné, puis enrichi au fil des étapes. Il contient le produit (immuable), le souscripteur (ajouté après validation dans /souscripteur), la simulation (ajouté après calcul dans /simulation), et un confirmationKey (UUID régénéré à chaque modification de subscriber ou simulation). Transitions :

    • /souscripteur (GET) : pré-remplit le formulaire depuis draft.getSubscriber() si présent ; (POST) : valide avec InputValidator.subscriberErrors(), stocke le souscripteur dans le Draft via draft.setSubscriber(), puis redirige vers /simulation.do.
    • /simulation (GET) : pré-remplit le formulaire depuis draft.getSimulation() si présent ; (POST) : valide avec InputValidator.simulationErrors(), calcule la simulation via SimulationService.calculate(), la stocke dans le Draft via draft.setSimulation(), puis redirige vers /recapitulatif.do (si commande continuer) ou reste sur /simulation.do (si commande calculer).
    • /recapitulatif (GET) : affiche les données du Draft.
    • /confirmer (POST) : vérifie la correspondance entre draft.getConfirmationKey() et le paramètre confirmationKey, ainsi que l’acceptation des conditions (form.isAccepted()). Si valide, il appelle SubscriptionService.confirm(draft) pour persister la souscription, stocke le résultat Subscription en session sous les clés completed, completedReference et completedKey, supprime le draft, puis redirige vers /confirmation.do.
  • completed : stocké après confirmation réussie, utilisé par /confirmation (GET) pour afficher l’accusé d’enregistrement. Si le draft est absent et qu’aucune confirmation valide n’est en cours, SubscriptionAction redirige vers /catalogue.do?notice=parcours, ce qui affiche dans catalogue.jsp : « Votre parcours est incomplet ou votre session a expiré. »

Consulter les sources (6)
Marty Harness · source
src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
Marty Harness · source
src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
Marty Harness · source
src/main/webapp/WEB-INF/jsp/catalogue.jsp · lignes 1–38
Marty Harness · source
src/main/java/fr/demo/souscription/model/Draft.java · lignes 6–28
Marty Harness · source
src/main/webapp/WEB-INF/jsp/recapitulatif.jsp · lignes 1–26
Marty Harness · source
src/main/java/fr/demo/souscription/service/SubscriptionService.java · lignes 10–31

Flux complet d’une requête HTTP : de SecurityFilter à l’affichage JSP

Le schéma ci-dessous résume le cheminement d’une requête HTTP depuis son interception par SecurityFilter jusqu’à l’affichage de la JSP. SecurityFilter valide d’abord la méthode HTTP et, pour les requêtes ciblant Struts (chemin en .do), vérifie le jeton CSRF. Si la validation réussit, la requête est transmise au framework Struts qui, via les action-mappings de struts-config.xml, achemine la requête vers l’Action appropriée (CatalogAction ou SubscriptionAction). Les Actions interagissent avec la session HTTP pour gérer l’état du parcours (draft, completed) et renvoient un forward vers la JSP correspondante, qui génère la réponse HTML finale.

Consulter les sources (8)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56
Marty Harness · source
src/main/webapp/WEB-INF/struts-config.xml · lignes 1–27
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
Marty Harness · source
src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
Marty Harness · source
src/main/webapp/WEB-INF/jsp/catalogue.jsp · lignes 1–38
Marty Harness · source
src/main/java/fr/demo/souscription/model/Draft.java · lignes 6–28
Marty Harness · source
src/main/webapp/WEB-INF/jsp/fragments/csrf.jspf · lignes 1–1

Snapshot graph:e63f5f99ab8bbd6992fd2ffb · version 1
Workspace struts-example-3

Empreinte du snapshot
9a6815fc1f0aaae6d1abef9ee7a19d966482e4bb8dc9f23161a788d459d556c1