Objectif
Ce guide d'utilisation de l'outil porte sur les informations spécifiques à J2EE suivantes :
Présentation
XDE permet de créer des J2EE de manière automatisée, afin de modéliser les composants à déployer dans les archives et
de modéliser les noeuds (conteneurs et serveurs) pour lesquels les archives J2EE sont à déployer. Ces activités sont
effectuées dans des modèles de déploiement XDE.
Dans ce guide d'utilisation de l'outil, les étapes suivantes sont effectuées :
Pour plus d'informations
Les liens vers les rubriques d'aide en ligne de Rational XDE™ sont indiqués par l'icône suivante .
Paramétrage de l'espace de travail d'assemblage
Dans XDE, l'espace de travail d'assemblage correspond aux modèles de déploiement XDE (EJB, Web et EAR). Cette étape
permet la création des modèles de déploiement XDE requis. Pour obtenir des recommandations sur les projets et les
modèles de déploiement qu'il convient de définir, reportez-vous à Instructions relatives aux structures de modèle XDE.
Certains modèles de déploiement peuvent déjà avoir été générés lors de la création des projets XDE. Toutefois,
l'assembleur peut choisir de créer des "espaces de travail d'assemblage" supplémentaires pour prendre en charge les
opérations de déploiement liées aux tests et à la production.
Dans XDE, des espaces de travail d'assemblage distincts peuvent être implémentés à l'aide de modèles de déploiement XDE
distincts ou en définissant des archives individuelles dans le même modèle de déploiement (c'est-à-dire des archives
distinctes pour les tests, la production, etc.). Cette dernière approche a pour avantage de réduire le nombre de
modèles XDE et de simplifier quelque peu de manière cohérente l'ajout, la suppression et la modification de composants
J2EE, de fichiers archive, etc., lorsqu'ils se situent dans le même modèle. Gérer les modifications apportées
actuellement à ce modèle est l'inverse de cette approche. Un modèle séparé facilite également la limitation de l'accès
au contenu des archives de production, lorsqu'elles doivent être soigneusement contrôlées.
Il est possible de créer "manuellement" les modèles de déploiement XDE (reportez-vous à Création de modèles de déploiement
. Ces modèles
peuvent également être générés à l'aide des assistants de déploiement J2EE de XDE au moment où l'archive est créé
(reportez- vous à la prochaine étape : Définition des archives). Les assistants de
déploiement XDE créent ou mettent à jour le modèle de déploiement Web ou EJB approprié, ainsi qu'un modèle EAR qui
contient le fichier "de délimitation" requis pour déployer la plupart des serveurs d'application.
Pour obtenir des informations sur le renseignement des modèles de déploiement XDE, reportez-vous aux étapes suivantes
de ce guide d'utilisation de l'outil.
Définition des archives
Cette étape vous permet de créer les archives, si elles n'existent pas encore, et de décider des éléments à mettre en
package dans les archives.
Les archives de module J2EE, les fichiers JAR EJB et WAR EJB, sont modélisées dans les modèles de déploiement EJB et
Web, respectivement. Ces modèles de déploiement servent à modéliser les éléments à déployer dans ces archives.
Les archives d'application J2EE, les fichiers EAR, sont modélisées dans le modèle de déploiement EAR. Ce modèle sert à
modéliser les archives de module J2EE à mettre en package dans le fichier EAR, ainsi que le noeud de serveur
d'application vers lequel le fichier EAR est à déployer. Pour plus d'information sur le mappage d'archives à des
noeuds, reportez-vous à Déploiement de
relations . Les noeuds
contiennent des informations sur le type de serveur et des informations requises pour le déploiement. Si le type de
serveur d'application est pris en charge par XDE, XDE vous autorise alors à définir certaines propriétés (telles que
les rôles de sécurité au niveau de l'application) pour le serveur, afin de faciliter le déploiement. Pour plus
d'informations, reportez-vous à Noeuds
de déploiement (Java) . Voir aussi
Serveurs d'application (Java)
.
Dans XDE, vous pouvez utiliser des assistants de déploiement d'application J2EE pour paramétrer des modèles de
déploiement XDE, ce qui comprend la création des modèles et des archives, l'identification des éléments à déployer dans
ces archives et la spécification du noeud vers lequel il convient de déployer l'archive. Les modèles de déploiement EJB
et Web vous permettent de définir les éléments à inclure dans les archives de module J2EE et l'assistant de déploiement
paramètre les relations entre les fichiers archive et les composants. Le modèle de déploiement EAR vous permet de
définir les archives transférées dans l'EAR (l'assistant de déploiement paramètre les relations par défaut avec les
archives dans les modèles de déploiement Web et EJB) et de définir les "noeuds" du serveur d'application vers lesquels
l'archive va être déployé. Pour plus d'informations sur les assistants de déploiement XDE, reportez-vous à Assistants de déploiement J2EE
.
Les remarques ci-dessous concernent l'utilisation des assistants de déploiement XDE :
-
Les modèles XDE contenant les éléments pour lesquels créer des packages dans les archives doivent avoir été ouverts
avant que les assistants ne soient appelés pour faire apparaître ces éléments dans les zones de liste déroulante et
les sélectionner à des fins d'intégration dans l'archive.
-
Les assistants ajoutent uniquement des éléments aux archives. Ces derniers ne peuvent pas supprimer les éléments
spécifiés précédemment, même s'ils sont décochés dans les assistants lorsque ces derniers sont appelés par la
suite.
-
Si un de vos modèles de déploiement dispose de plusieurs archives, XDE considère l'une d'elles comme archive "par
défaut". Cette archive correspond à celle indiquée pendant la dernière étape effectuée dans l'assistant de
déploiement. Si vous utilisez XDE dans WebSphere Studio Application Developer, cette archive est la seule reconnue
par XDE, car un projet distinct doit être associé à chaque archive dans Application Developer. C'est la raison pour
laquelle vous ne pouvez pas utiliser les outils d'Application Developer pour travailler avec des archives.
-
Vous pouvez continuer à exécuter les assistants lorsque l'application évolue et que des nouveaux éléments doivent
être ajoutés à des archives existantes, que des archives doivent être créées ou que des changements doivent être
apportés aux informations de déploiement (pour plus d'informations sur le déploiement d'archives J2EE,
reportez-vous à Guide d'utilisation de l'outil : Déploiement de modules et
d'applications J2EE à l'aide de Rational XDE Developer - édition pour plateforme Java).
-
Après avoir exécuté les assistants, il peut s'avérer judicieux d'ouvrir le diagramme par défaut dans chaque modèle
de déploiement, de faire glisser dans le diagramme les éléments créés dans les modèles de déploiement, les
composants et les archives par exemple, puis de les disposer comme souhaité.
Il convient que les résultats de cette étape soient collectés dans les diagrammes de déploiement. Pour plus
d'informations, reportez-vous à Utilisation de diagrammes de déploiement
. voir aussi Présentation et regroupement de formes dans
des diagrammes .
Définition des descripteurs de déploiement
Dans XDE, vous n'éditez pas réellement les descripteurs de déploiement directement, mais modélisez les descripteurs de
déploiement dans les modèles de déploiement XDE. Le fichier des descripteurs de déploiement est alors ensuite
automatiquement généré au cours du déploiement. Le modèle de déploiement XDE correspond globalement à un modèle du
descripteur de déploiement correspondant. Pour plus d'informations sur les descripteurs de déploiement dans XDE,
reportez-vous à Fichiers des
descripteurs de déploiement
.
Les assistants de déploiement XDE (traités dans l'étape : Définition des archives
précédente) renseignent automatiquement de nombreuses propriétés de descripteur de déploiement lors de la création de
l'archive et à chaque lancement des assistants de déploiement. Ainsi, les descripteurs de déploiement évoluent avec les
composants qu'ils contiennent.
Certains serveurs d'application nécessitent un "encapsuleur" EAR avec les fichiers JAR EJB, les fichiers WAR et
d'autres archives JAR de déploiement, ce qui signifie que le fournisseur de composants d'application devra peut-être
assembler un fichier EAR à des fins de test. Dans ce cas, le fichier EAR généré automatiquement par les assistants de
déploiement XDE est généralement suffisant.
Malgré tout, les assembleurs d'application sont généralement concernés par les détails des contenus EAR, en particulier
par les rôles de sécurité au niveau de l'application, etc., lesquels sont également modélisables dans XDE. Le modèle de
déploiement XDE vous offre la possibilité de modéliser des rôles de sécurité, des autorisations, des transactions,
etc., à l'aide des menus locaux ou des boîtes à outils correspondantes. L'"assistant de connexion" de chaque boîte à
outils sait quels types de relations doivent être créés entre des éléments. Lorsque plusieurs possibilités existent,
l'utilisateur est invité à effectuer un choix. Pour plus d'informations sur l'"assistant de connexion", reportez-vous à
Définition de relations pour les
EJB . Pour plus
d'informations sur la modélisation de fichiers WAR, reportez-vous à Modélisation de fichiers WAR
. Pour plus d'informations
sur la modélisation de fichiers JAR EJB, reportez-vous à Modélisation du déploiement
.
Les modèles de déploiement XDE (EJB, Web et EAR) contiennent toutes les informations requises pour générer les
descripteurs de déploiement EJB, Web et Enterprise Application ejb-jar.xml, web.xml et application.xml, respectivement
(certaines informations proviennent des modèles de code associés aux modèles de déploiement). Il s'agit des
descripteurs définis par la norme J2EE. D'autres descripteurs sont généralement nécessaires pour procéder au
déploiement complet sur la plupart des serveurs d'application. XDE génère ces descripteurs de déploiement pour les
serveurs d'application pris en charge. Pour plus d'informations, reportez-vous à Déploiement d'une application Java
.
Si vous avez défini des mappages entre des tables de base de données dans le modèle de
données et des EJB entity avec persistance gérée par conteneur (CMP), ces mappages seront utilisés pour générer les
directives de mappage dans les descripteurs spécifiques au fournisseur (les directives de mappage ne sont pas partie du
descripteur EJB standard). Si aucun mappage de modèle de données n'a été défini, les mappages par défaut sont générés
pour les EJB entity CMP. Pour plus d'informations, reportez-vous à Utilisation des EJB avec des bases de données
.
XDE ne modélise ni ne génère l'ensemble du contenu de tous les descripteurs spécifiques du fournisseur. Vous pouvez
remplacer la création automatique d'un ou de plusieurs de ces descripteurs et décider de gérer ce(s) dernier(s)
vous-même. Chaque archive comporte une propriété incluant une liste de fichiers ou de répertoires qui seront inclus
dans cette archive, mais qui ne seront pas modélisés. Cette propriété est appelée JARNonModelElements pour les fichiers JAR, EJBNonModelElements pour les fichiers JAR EJB, WebNonModelElements pour les fichiers WAR et EARNonModelElements pour les fichiers EAR. Ajoutez les descripteurs de
déploiement et d'autres fichiers que vous souhaitez gérer vous-même pour la propriété de l'archive correspondante. Pour
plus d'informations, reportez-vous à Déploiement d'une application Java
.
Validation des archives
Des erreurs complexes pouvant survenir en particulier au niveau du serveur d'application et entraîner des messages
d'erreur inexistantes, il peut s'avérer utile de valider les modèles de déploiement XDE avant de procéder au
déploiement. Il est en réalité utile de valider les modèles "au lancement" (de temps en temps lors de l'assemblage et
une fois avant le déploiement, pour vérifier le "bon état" du modèle).
XDE prend en charge la vérification de l'intégrité des modèles. Sélectionnez le modèle souhaité dans l'explorateur de
modèles, puis appelez la commande contextuelle de validation. Si des problèmes sont identifiés, des tâches sont
ajoutées à la liste des tâches. Pour plus d'informations, reportez-vous à Validation des modèles Java
. Pour plus d'informations sur les
éléments validés par XDE dans les modèles de déploiement, reportez-vous à Règles de validation du déploiement
.
Pour plus d'informations
Hormis la modélisation d'archives J2EE et de descripteurs de déploiement, XDE vous permet également d'importer des
descripteurs de déploiement ou des archives complètes dans XDE. Pour plus d'informations, reportez-vous à Importation et exportation lors du
déploiement .
Pour plus d'informations sur la modélisation du déploiement XDE, reportez-vous à Modélisation du déploiement
. Pour plus d'informations sur le
déploiement, reportez-vous à Guide d'utilisation de l'outil : Déploiement de modules et d'applications
J2EE à l'aide de Rational XDE Developer - édition pour plateforme Java.
|