Guide d'utilisation de l'outil :
Assembler les modules et les applications J2EE avec RAD 6.0
Objet
Ce guide d'utilisation de l'outil décrit la manière de produire les archives J2EE (WAR, EJB JAR, application client JAR, fichiers RAR et EAR) en utilisant le système RAD 6.0.
Il se rapporte aux informations RUP suivantes :
Présentation
L'assemblage est le processus qui consiste à combiner les composants d'une application J2EE dans des packages ( module J2EE
ou application J2EE
) pouvant être déployés vers un serveur d'applications. Ces packages sont des fichiers d'archives qui doivent se conformer à une structure de répertoires, les règles du contenu sont définies par l'assemblage de l'application J2EE et par le modèle de déploiement.
RAD 6.0 facilite grandement le processus d'assemblage en imposant le développement de composants d'applications dans un projet qui représente soit un module J2EE
soit une application J2EE. Quand vous créez un projet, l'outil génère automatiquement une structure de répertoire de fichiers et l'intègre au projet. Cette structure respecte l'assemblage de l'application J2EE et le modèle de déploiement. Au fur et à mesure que les composants sont créés via l'assistant produits, ils sont sauvegardés par défaut dans le dossier approprié à l'intérieur du projet. Par exemple, quand vous créez un nouveau fichier JSP en utilisant l'assistant Nouveau fichier JSP, l'outil le stocke par défaut dans le dossier contenu Web du projet Web qui représente l'endroit habituel où sont stockés les fichiers sources de contenu Web. En outre, RAD 6.0 génère aussi automatiquement tous les artefacts d'assemblage et de déploiement J2EE, comme le fichier manifeste et les descripteurs de déploiement appropriés. L'assemblage d'un module ou d'une application J2EE consiste donc simplement à éditer le(s) descripteur(s) de déploiement correspondants si nécessaire et à exporter le projet vers un fichier d'archives. Les étapes suivantes sont réalisées dans ce guide d'utilisation de l'outil :
- Pour éditer un descripteur de déploiement de projet Enterprise Application(EAR) :
- Dans la vue de perspective J2EE Explorateur de projet, étendez Enterprise Applications > project_name.
- Double-cliquez sur Descripteur de déploiement : project_name pour ouvrir l'éditeur de descripteur de déploiement de l'application.
- Sélectionnez l'onglet approprié au bas de la vue d'éditeur pour éditer les valeurs spécifiques du descripteur de déploiement.
- Sauvegardez le fichier de descripteur de déploiement en sélectionnantFichier> Enregistrer à partir de la barre de menu principale.
- Pour éditer un descripteur de projet Web (WAR) :
- Dans la vue de perspective J2EE Explorateur de projet, étendez Web Modules > project_name.
- Double-cliquez sur Descripteur de déploiement : project_name pour ouvrir l'éditeur de descripteur de déploiement de l'application.
- Sélectionnez l'onglet approprié au bas de la vue d'éditeur pour éditer les valeurs spécifiques du descripteur de déploiement.
- Sauvegardez le fichier de descripteur de déploiement en sélectionnantFichier> Enregistrer à partir de la barre de menu principale.
- Pour éditer un descripteur de projet EJB (EJB JAR) :
- Dans la vue de perspective J2EE Explorateur de projet, étendez EJB Modules > project_name.
- Double-cliquez sur Descripteur de déploiement : project_name pour ouvrir l'éditeur de descripteur de déploiement de l'application.
- Sélectionnez l'onglet approprié au bas de la vue d'éditeur pour éditer les valeurs spécifiques du descripteur de déploiement.
- Sauvegardez le fichier de descripteur de déploiement en sélectionnantFichier> Enregistrer à partir de la barre de menu principale.
- Pour éditer un projet client d'application (JAR client d'application) :
- Dans la vue de perspective J2EE Explorateur de projet, étendez Application Client Modules > project_name.
- Double-cliquez sur Descripteur de déploiement : project_name pour ouvrir l'éditeur de descripteur de déploiement du client.
- Sélectionnez l'onglet approprié au bas de la vue d'éditeur pour éditer les valeurs spécifiques du descripteur de déploiement.
- Sauvegardez le fichier de descripteur de déploiement en sélectionnantFichier> Enregistrer à partir de la barre de menu principale.
- Pour éditer un descripteur de projet Connecteur (RAR) :
- Dans la vue de perspective J2EE Explorateur de projet, étendez Modules connecteur> project_name.
- Double-cliquez sur Descripteur de déploiement : project_name pour ouvrir l'éditeur XML sur le fichier ra.xml.
- Editez le fichier XML pour changer les valeurs spécifiques de descripteur de déploiement.
- Sauvegardez le fichier de descripteur de déploiement en sélectionnantFichier> Enregistrer à partir de la barre de menu principale.
Bien que l'outil soit défini par défaut pour valider les ressources lorsque vous les enregistrez, il est recommandé de valider manuellement votre projet global avant de l'exporter dans un fichier d'archive (Notez que vous pouvez annuler et changer les validateurs exécutés sur votre projet en faisant un clic droit et en sélectionnant Propriétés > Validation).
- Dans la vue de perspective J2EE Exploration de projet, faites un clic droit sur project_name.
- Sélectionnez Exécuter la validation.
- Après que la validation ait été effectuée, vérifiez la vue Problèmes. Si des erreurs sont répertoriées, résolvez-les avant de passer à l'étape suivante.
- Pour exporter un projet Enterprise Application vers un EAR
file:
- Dans la vue de perspective J2EE Explorateur de projet, faites un clic droit sur project_name.
- Sélectionnez Exporter > fichier EAR.
- Dans l'assistant Exportation, définissez le nom et l'emplacement souhaité du fichier EAR.
- Vous pouvez sélectionner les options suivantes :
- Exporter les fichiers source
- Remplacer le fichier existant si vous exportez vers un fichier EAR et que vous ne voulez pas recevoir d'avertissement à propos du remplacement
- Incluez les chemins de construction du projet et les fichiers de métadonnées pour conserver les noms d'origine des projets inclus ou référencés par le projet d'application et maintenir des dépendances de chemin de classe. Cela vous permet d'importer ensuite l'EAR dans un autre espace de travail et d'importer ses modules en tant que projets binaires.
- Cliquez sur Terminer. L'assistant exporte le contenu du projet d'application vers le fichier EAR défini.
- Pour exporter un projet Web vers un fichier WAR :
- Dans la vue de perspective J2EE Explorateur de projet, faites un clic droit sur project_name.
- Sélectionnez Exporter > fichier WAR.
- Dans l'assistant Exportation, définissez le nom et l'emplacement souhaité du fichier WAR.
- Vous pouvez sélectionner les options suivantes :
- Exporter les fichiers source
- Remplacer le fichier existant si vous exportez vers un fichier WAR et que vous ne voulez pas recevoir d'avertissement à propos du remplacement
- Cliquez sur Terminer. L'assistant exporte le contenu du projet d'application vers le fichier WAR défini.
- Pour exporter un projet EJB vers un fichier EJB JAR :
- Dans la vue de perspective J2EE Explorateur de projet, faites un clic droit sur project_name.
- Sélectionnez Exporter > fichier EJB JAR.
- Dans l'assistant Exportation, définissez le nom et l'emplacement souhaité du fichier JAR.
- Vous pouvez sélectionner les options suivantes :
- Exporter les fichiers source
- Remplacer le fichier existant si vous exportez vers un fichier JAR et que vous ne voulez pas recevoir d'avertissement à propos du remplacement
- Cliquez sur Terminer. L'assistant exporte le contenu du projet d'application vers le fichier JAR défini.
- Pour exporter un projet client d'application vers un fichier JAR client d'application :
- Dans la vue de perspective J2EE Explorateur de projet, faites un clic droit sur project_name.
- Sélectionnez Exporter > fichier JAR client app.
- Dans l'assistant Exportation, définissez le nom et l'emplacement souhaité du fichier JAR.
- Vous pouvez sélectionner les options suivantes :
- Exporter les fichiers source
- Remplacer le fichier existant si vous exportez vers un fichier JAR et que vous ne voulez pas recevoir d'avertissement à propos du remplacement
- Cliquez sur Terminer. L'assistant exporte le contenu du projet du client d'application vers le fichier JAR défini.
- Pour exporter un projet Connector vers un fichier RAR :
- Dans la vue de perspective J2EE Explorateur de projet, faites un clic droit sur project_name.
- Sélectionnez Exporter > fichier RAR.
- Dans l'assistant Exportation, définissez le nom et l'emplacement souhaité du fichier RAR.
- Vous pouvez sélectionner les options suivantes :
- Exporter les fichiers source
- Remplacer le fichier existant si vous exportez vers un fichier RAR et que vous ne voulez pas recevoir d'avertissement à propos du remplacement
- Cliquez sur Terminer. L'assistant exporte le contenu du projet Connector vers le fichier RAR défini.
|