MartyAIDocumentation

Architecture technique de l'application

Comprendre l'organisation en couches (web, services, repository) et les dépendances entre les composants principaux de struts-example-3.

Organisation en trois couches principales

L’application struts-example-3 s’articule autour de trois couches distinctes, chacune avec un rôle précis dans le traitement des souscriptions.

La couche Web expose les points d’entrée HTTP et gère la présentation. Elle comprend :

  • SecurityFilter, un filtre Servlet qui applique des en-têtes de sécurité (X-Content-Type-Options, X-Frame-Options, Content-Security-Policy, Cache-Control), restreint les méthodes HTTP autorisées à GET, HEAD et POST, et implémente une protection CSRF pour les requêtes POST ciblant les chemins .do. Il génère et stocke un jeton CSRF en session, puis le valide pour chaque requête POST concernée.
  • Application, un ServletContextListener qui initialise l’application au démarrage : chargement du pilote JDBC H2, création du répertoire de la base avec des permissions POSIX si supporté, instanciation de SubscriptionRepository et de ses dépendances (CatalogService, InputValidator, SimulationService, SubscriptionService), puis enregistrement de l’instance Application dans le contexte Servlet. Il assure aussi le nettoyage des pilotes JDBC à l’arrêt.
  • CatalogAction et SubscriptionAction, deux classes Struts qui étendent Action et traitent respectivement l’affichage du catalogue/produits et le parcours de souscription. Elles accèdent aux services métier via l’instance Application stockée dans le contexte Servlet.
  • struts-config.xml, qui déclare le form-bean subscriptionForm (de type SubscriptionForm), les global-forwards vers les JSP (catalogue, produit, souscripteur, simulation, recapitulatif, confirmation), et les action-mappings associant les chemins .do aux classes Action correspondantes.

La couche Service encapsule la logique métier et les règles de validation :

  • CatalogService fournit la liste des produits disponibles et permet de retrouver un produit par son code. Il expose une liste immuable de trois produits (PRUDENT, EQUILIBRE, DYNAMIQUE) avec leurs caractéristiques (nom, profil, description, taux annuel).
  • InputValidator valide les données saisies par l’utilisateur : noms (1-80 caractères, sans caractères de contrôle), adresse e-mail (format et longueur), date de naissance (format JJ/MM/AAAA, non future, majorité requise), montants (format, nombre de décimales, plages autorisées : 100-100000 € pour le versement initial, 0-2000 € pour la mensualité) et durée (1-30 ans). Il transforme aussi les chaînes validées en objets métier (Subscriber, BigDecimal).
  • SimulationService calcule le capital final selon une formule d’intérêts composés mensuels à partir du versement initial, de la mensualité, de la durée et du taux annuel du produit. Il valide les paramètres avant calcul et retourne un objet Simulation contenant les montants initiaux, mensuels, la durée, le total cotisé et le capital final.
  • SubscriptionService orchestré par Application utilise SimulationService pour recalculer la simulation à partir des données du brouillon (Draft), puis SubscriptionRepository pour persister la souscription avec une référence unique, la clé de confirmation, et l’horodatage.

La couche Repository assure la persistance des données :

  • SubscriptionRepository gère la connexion à la base H2, initialise le schéma à partir du fichier /db/schema.sql, et propose les opérations save (enregistrement d’une souscription avec gestion des doublons via la clé de confirmation et des erreurs SQLState 23505) et findByKey (recherche par clé de confirmation). Il stocke et restitue toutes les données de souscription, y compris les informations produit, souscripteur et simulation.
Consulter les sources (10)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56
Marty Harness · source
src/main/java/fr/demo/souscription/web/Application.java · lignes 22–84
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/webapp/WEB-INF/struts-config.xml · lignes 1–27
Marty Harness · source
src/main/java/fr/demo/souscription/service/CatalogService.java · lignes 9–23
Marty Harness · source
src/main/java/fr/demo/souscription/service/InputValidator.java · lignes 14–91
Marty Harness · source
src/main/java/fr/demo/souscription/service/SimulationService.java · lignes 8–30
Marty Harness · source
src/main/java/fr/demo/souscription/service/SubscriptionService.java · lignes 10–31
Marty Harness · source
src/main/java/fr/demo/souscription/repository/SubscriptionRepository.java · lignes 24–115

Flux de contrôle entre la couche Web et les services

Le filtre SecurityFilter est le premier composant intercepté pour toute requête HTTP. Il configure l’encodage UTF-8, ajoute les en-têtes de sécurité, vérifie que la méthode HTTP est autorisée (GET, HEAD ou POST), et pour les requêtes POST vers les chemins .do, il valide le jeton CSRF stocké en session contre celui soumis dans le paramètre csrf. Si la validation échoue, il renvoie une erreur 403. Sinon, il transmet la requête à la chaîne de filtres suivante.

Les requêtes .do sont ensuite routées par le framework Struts selon les action-mappings déclarés dans struts-config.xml. Chaque mapping associe un chemin (par exemple /catalogue, /produit, /commencer, /souscripteur, /simulation, /recapitulatif, /confirmer, /confirmation) à une classe Action spécifique (CatalogAction ou SubscriptionAction) et, le cas échéant, à un form-bean (subscriptionForm).

Dans les classes Action, l’accès aux services métier se fait via l’instance Application récupérée depuis le ServletContext. Par exemple, SubscriptionAction utilise Application.get(getServlet().getServletContext()) pour obtenir l’instance Application, puis appelle ses méthodes getCatalog(), getValidator(), getSimulations() et getSubscriptions() pour accéder respectivement à CatalogService, InputValidator, SimulationService et SubscriptionService. Ces services sont ensuite utilisés pour :

  • Récupérer un produit depuis le catalogue (app.getCatalog().find(code)).
  • Valider les données du souscripteur (app.getValidator().subscriberErrors(form)) ou de la simulation (app.getValidator().simulationErrors(form)).
  • Calculer une simulation (app.getSimulations().calculate(...)).
  • Confirmer et persister une souscription (app.getSubscriptions().confirm(draft)).

Les données de session (par exemple les objets draft de type Draft et completed de type Subscription) sont gérées directement par les Actions pour maintenir l’état du parcours de souscription entre les différentes étapes. Les erreurs de validation ou de traitement sont exposées dans la requête sous forme de Map<String, String> errors et affichées par les JSP via le fragment errors.jspf.

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/web/Application.java · lignes 22–84
Marty Harness · source
src/main/java/fr/demo/souscription/action/SubscriptionAction.java · lignes 22–151
Marty Harness · source
src/main/java/fr/demo/souscription/service/InputValidator.java · lignes 14–91
Marty Harness · source
src/main/java/fr/demo/souscription/service/SimulationService.java · lignes 8–30
Marty Harness · source
src/main/java/fr/demo/souscription/service/SubscriptionService.java · lignes 10–31
Marty Harness · source
src/main/webapp/WEB-INF/jsp/fragments/errors.jspf · lignes 1–6

Points d’entrée et routage des requêtes

L’application expose deux types de points d’entrée HTTP : un filtre global et des actions Struts.

SecurityFilter est le point d’entrée universel : il intercepte toutes les requêtes avant qu’elles n’atteignent les servlets ou les actions Struts. Son rôle est double : appliquer une politique de sécurité stricte (restriction des méthodes HTTP, en-têtes de sécurité, pas de cache) et protéger contre les attaques CSRF en générant et validant un jeton pour chaque session, spécifiquement pour les requêtes POST vers les chemins .do. Ce filtre garantit que seules les méthodes GET, HEAD et POST sont acceptées, et renvoie une erreur 405 (Method Not Allowed) pour toute autre méthode.

struts-config.xml définit la configuration centrale du routage. Il déclare :

  • Un unique form-bean nommé subscriptionForm de type SubscriptionForm, utilisé par toutes les actions de souscription pour lier les paramètres HTTP aux propriétés du formulaire.
  • Six global-forwards qui associent des noms logiques (catalogue, produit, souscripteur, simulation, recapitulatif, confirmation) aux chemins physiques des JSP sous /WEB-INF/jsp/.
  • Huit action-mappings qui lient les chemins .do aux classes Action :
    • /catalogue et /produit → CatalogAction
    • /commencer, /souscripteur, /simulation, /recapitulatif, /confirmer, /confirmation → SubscriptionAction

CatalogAction traite les requêtes en lecture seule (GET) : affichage du catalogue complet ou de la fiche d’un produit spécifique. Si la requête est en POST, elle renvoie une erreur 405. Pour /produit, elle récupère le produit demandé via app.getCatalog().find(code) et l’expose dans la requête pour affichage.

SubscriptionAction gère le parcours complet de souscription en plusieurs étapes, synchronisées sur la session pour éviter les conflits concurrents. Elle utilise le chemin (mapping.getPath()) pour déterminer l’étape courante et :

  • /commencer (POST) : initialise un brouillon (Draft) en session à partir du code produit et redirige vers /souscripteur.do.
  • /souscripteur (GET/POST) : affiche ou valide les informations du souscripteur, puis redirige vers /simulation.do si valide.
  • /simulation (GET/POST) : affiche ou valide les paramètres de simulation, recalcule si nécessaire, puis redirige vers /simulation.do ou /recapitulatif.do selon la commande.
  • /recapitulatif (GET) : affiche le récapitulatif avant confirmation.
  • /confirmer (POST) : valide la clé de confirmation et l’acceptation des conditions, puis persiste la souscription via app.getSubscriptions().confirm(draft) et redirige vers /confirmation.do.
  • /confirmation (GET) : affiche la confirmation de la souscription à partir de l’objet completed en session.

Les redirections entre étapes utilisent ActionForward avec le flag redirect=true, tandis que l’affichage des JSP utilise mapping.findForward(name) pour résoudre les global-forwards déclarés.

Consulter les sources (6)
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/service/SubscriptionService.java · lignes 10–31
Marty Harness · source
src/main/java/fr/demo/souscription/web/Application.java · lignes 22–84

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

Empreinte du snapshot
9a6815fc1f0aaae6d1abef9ee7a19d966482e4bb8dc9f23161a788d459d556c1