MartyAIDocumentation

Configuration Struts et routage des actions

Comprendre la configuration centralisée dans struts-config.xml et son impact sur le routage et les formulaires.

Rôle central de struts-config.xml

Le fichier struts-config.xml est le point central de configuration de l’application Struts. Il regroupe en un seul endroit les trois éléments clés du framework : les form-beans pour la liaison automatique des paramètres HTTP aux objets Java, les global-forwards pour la navigation vers les vues, et les action-mappings pour le routage des chemins logiques (.do) vers les classes Action. Cette centralisation permet de maintenir une séparation nette entre la logique de dispatching, la gestion des données de formulaire et la présentation, tout en offrant un point unique de maintenance pour les règles de navigation.

Consulter les sources (1)
Marty Harness · source
src/main/webapp/WEB-INF/struts-config.xml · lignes 1–27

Form-bean et gestion des données de formulaire

Un unique form-bean est déclaré dans struts-config.xml : subscriptionForm, de type fr.demo.souscription.form.SubscriptionForm. Ce form-bean sert de conteneur pour les données saisies tout au long du parcours de souscription.

La classe SubscriptionForm étend ActionForm et expose les propriétés suivantes, avec des valeurs par défaut adaptées au parcours :

  • firstName, lastName, email, birthDate : chaînes vides pour les informations personnelles
  • initial : versement initial, pré-rempli à "1000,00"
  • monthly : versement mensuel, pré-rempli à "100,00"
  • years : durée en années, pré-remplie à "5"
  • accepted : case à cocher pour l’acceptation des conditions, initialisée à false

Chaque propriété dispose d’un accesseur et d’un mutateur typés. La méthode safe garantit qu’une valeur null est convertie en chaîne vide, évitant ainsi les NullPointerException lors de l’affichage ou de la validation. Ce form-bean est instancié à chaque requête (scope request) et lié automatiquement par Struts aux paramètres HTTP.

Consulter les sources (2)
Marty Harness · source
src/main/webapp/WEB-INF/struts-config.xml · lignes 1–27
Marty Harness · source
src/main/java/fr/demo/souscription/form/SubscriptionForm.java · lignes 5–33

Association des chemins (.do) aux classes Action

Les action-mappings définissent les associations entre les chemins logiques (suffixés par .do) et les classes Action responsables de leur traitement. Chaque mapping précise la classe cible via l’attribut type, et le cas échéant, le form-bean associé (name), sa portée (scope) et si la validation automatique de Struts doit être appliquée (validate).

Deux classes Action sont configurées :

  • CatalogAction (fr.demo.souscription.action.CatalogAction) : Mappings /catalogue et /produit. Ces chemins n’utilisent pas de form-bean (pas d’attribut name), car ils sont dédiés à l’affichage en lecture seule (catalogue et fiches produits).

  • SubscriptionAction (fr.demo.souscription.action.SubscriptionAction) : Mappings /commencer, /souscripteur, /simulation, /recapitulatif, /confirmer, /confirmation. Ces six chemins utilisent le form-bean subscriptionForm avec un scope égal à request et une validation désactivée (validate="false").

Consulter les sources (1)
Marty Harness · source
src/main/webapp/WEB-INF/struts-config.xml · lignes 1–27
Interprétation candidate — à confirmer

Global-forwards et centralisation des destinations

Les global-forwards déclarés dans struts-config.xml associent des noms logiques à des chemins physiques vers les JSP sous /WEB-INF/jsp/. Ils centralisent les destinations de navigation et évitent la duplication des chemins dans le code des actions.

Six global-forwards sont définis :

  • catalogue → /WEB-INF/jsp/catalogue.jsp
  • produit → /WEB-INF/jsp/produit.jsp
  • souscripteur → /WEB-INF/jsp/souscripteur.jsp
  • simulation → /WEB-INF/jsp/simulation.jsp
  • recapitulatif → /WEB-INF/jsp/recapitulatif.jsp
  • confirmation → /WEB-INF/jsp/confirmation.jsp

Dans le code des classes Action, la méthode mapping.findForward(name) est utilisée pour résoudre un nom de forward en un chemin physique. Ces forwards sont globaux : accessibles depuis n’importe quelle action, ils constituent le mécanisme principal de navigation vers les vues.

Consulter les sources (1)
Marty Harness · source
src/main/webapp/WEB-INF/struts-config.xml · lignes 1–27

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

Empreinte du snapshot
9a6815fc1f0aaae6d1abef9ee7a19d966482e4bb8dc9f23161a788d459d556c1