Akrogen fournit un example de catalogue pour générer les composants basiques du framework Struts1.x.
Ce catalogue contient :
Avant de vouloir utiliser ce catalogue, il est conseillé d'apprendre à utiliser Akrogen.
Après avoir installé Akrogen vous devez télécharger le catalogue struts1.x-catalog.
Dézipper la distribution et référencer ce catalogue dans votre projet Eclipse pour l'utiliser.
Pour rappel Akrogen permet de générer un/des composants à l'aide d'un Wizard ou d'un Composant à partir de la vue catalogue. Une fois que vous avez référencer le catalogue Struts1.x la vue catalogue doit afficher les Components et Wizards de Struts1.x :
Le Wizard Struts1 permet d'appeler et enchaîner les composants ActionForm, form-bean, Action et action-mapping dans un même wizard Eclipse. Cette section utilisera le Wizard Struts1 pour générer l'ensemble des composants de Struts.1.x.
Les XML components form-bean et action-mapping permettent de mettre à jour le fichier struts-config.xml. L'accès à un de ces composants nécéssitent donc la sélection du struts-config à mettre à jour. Autrement dit ces 2 composants définissent un modèle de type xml et de key strutsConfig.
Le XML component ApplicationResources permet de mettre à jour le fichier ApplicationResources. Autrement dit ce composant définit un modèle de type properties et de key applicationResources.
Avant d'ouvrir le Wizard Struts1, vous devez sélectionner le fichier struts-config et le fichier de propriétés ApplicationResources à mettre à jour.
Pour cela vous devez sélectionner le mode "sélection" de modèle (en cliquant sur le petite icône qui représente un tableau en haut à droite de la vue catalogue).
Sélectionnez ensuite le fichier struts-config.xml à mettre à jour dans une des vues Eclipse (Navigation, Package Explorer,..). Vous avez un exemple de fichier struts-config dans le répertoire Data du catalogue.
Après avoir sélectionné le fichier struts-config, le tableau qui affiche les modèles attendus par les components se met à jour avec votre fichier struts-config :
Sélectionner ensuite le fichier ApplicationResources.properties.
La sélection des fichiers struts-config.xml, ApplicationResources peuvent devenir pénible au cours du temps. Il est possible d'indiquer aux XML components les fichiers à utiliser, afin d'éviter de sélectionner ces fichiers à chaque accès du wizard Struts1 ou des XML components le constituant.
Pour cela vous devez modifier les XML components et indiquer le path à utiliser pour chacun des modèles strutsConfig et applicationResources. Pour éviter de sélectionner :
<model key="strutsConfig" type="xml" useIntoInput="true" omitDocumentType="true"
path="web/WEB-INF/struts-config.xml" />Dans cette exemple, le fichier web/WEB-INF/struts-config.xml de votre projet Eclipse sera utilisé.
<model key="applicationResources" type="xml" useIntoInput="true" omitDocumentType="true"
path="src/net/sourceforge/gestcv/ApplicationResources.properties" />Dans cette exemple, le fichier src/net/sourceforge/gestcv/ApplicationResources.properties de votre projet Eclipse sera utilisé.
Il est aussi possible de définir un chemin qui pointe sur un fichier qui ne serait pas dans votre projet Eclipse. Vous pouvez utiliser les patterns /*/ (n'importe quel répertoire) et /**/ (n'importe quel liste de répertoires) dans votre path.
Par exemple, vous pouvez renseigner le path comme ceci :
path="web/*/struts-config.xml"
Pour plus d'information, veuillez vous référer à la section Path.
La saisie des packages dans les composants ActionForm, Action peut devenir rébarbatif au cours du temps. Il est possible de rendre persistent les valeurs des packages. Ces valeurs sont stockés dans le fichiers de propriétés Resources/struts1.x-settings.properties du catalogue. Le XML component StrutsSettings vous permet de gérer les valeurs de ces propriétés :
Pour démarer la génération des composants, double cliquer le Wizard Struts1. Le Wizard ActionForm s'ouvre.
Une fois tous les wizards page renseignés, cliquer sur le bouton Finish pour lancer la génération de code.