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 personnellesinitial: 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/catalogueet/produit. Ces chemins n’utilisent pas de form-bean (pas d’attributname), 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-beansubscriptionFormavec unscopeégal àrequestet 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
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.jspproduit→/WEB-INF/jsp/produit.jspsouscripteur→/WEB-INF/jsp/souscripteur.jspsimulation→/WEB-INF/jsp/simulation.jsprecapitulatif→/WEB-INF/jsp/recapitulatif.jspconfirmation→/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