Struts 1.x

Akrogen fournit un example de catalogue pour générer les composants basiques du framework Struts1.x.

Ce catalogue contient :

  • les XML Components Akrogen:
    • ActionForm pour générer les classes ActionForm.
    • form-bean pour ajouter la définition form-bean dans le struts-config.
    • Action pour générer les classes Action.
    • action-mapping pour ajouter la défintion action dans le struts-config.
    • ApplicationResources pour mettre à jour les resources dans le fichier de propriétés ApplicationResources.
    • JSP Form pour générer la JSP.
  • les Wizards Akrogen :
    • Struts1 qui permet d'enchaîner tous les components Struts décrits ci dessus dans un même Wizard.

Avant de vouloir utiliser ce catalogue, il est conseillé d'apprendre à utiliser Akrogen.

Installation du catalogue

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.

Utilisation du catalogue

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 :

Wizard Struts1

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.

Model selection

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.

Model & Path

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 :

  • le fichier struts-config.xml, ajouter l'attribut path dans le modèle de key strutsConfig des XML components form-bean et action-mapping du catalogue. L'attribut path doit être renseigné avec le chemin de votre fichier struts-config.xml :
      <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é.

  • le fichier ApplicationResources.properties, ajouter l'attribut path dans le modèle de key applicationResources du XML component ApplicationResources du catalogue. L'attribut path doit être renseigné avec le chemin de votre fichier ApplicationResources.properties :
      <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.

Struts1.x settings

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 :

Démarrer Struts1 wizard

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.