Instructions: Assemblage des applications J2EE
Ces instructions portent sur l'assemblage des modules J2EE en une application J2EE.
Relations
Eléments connexes
Description principale

Introduction

Les assembleurs d'application J2EE assemblent les modules J2EE en une application J2EE. Les assembleurs d'application peuvent utiliser des modules commerciaux dans leurs applications en modifiant simplement les descripteurs de déploiement ou en apportant d'autres descripteurs.

Certains serveurs d'application nécessitent un "encapsuleur" EAR pour les fichiers JAR EJB, WAR et d'autres archives JAR de déploiement ; par conséquent, le fournisseur de composants d'application devra peut-être assembler un fichier EAR à des fins de test.

Les étapes détaillées de l'assemblage d'une application figurent dans la spécification J2EE, section J2EE.8.3 "Application Assembly" (Assemblage de l'application). L'extrait suivant récapitule ces conseils.

Assemblage d'une application J2EE

L'assemblage d'une application J2EE comporte les étapes suivantes :

  1. Sélectionnez les modules J2EE qui seront utilisés par l'application.
  2. Créez une structure de répertoires pour l'application.
  3. Harmonisez les descripteurs de déploiement des modules J2EE.
    • Editez les descripteurs de déploiement des modules J2EE pour relier les dépendances qui peuvent être résolues en interne et pour éliminer les noms de rôles de sécurité redondants.
    • Définissez des transactions, rôles de sécurité, autorisations de méthode, etc.
    • Si vous le souhaitez, utilisez l'élément alt-dd pour spécifier un autre descripteur de déploiement tout en conservant l'original.
    • Attribuez une racine de contexte pour chaque module Web inclus dans l'application J2EE.
    • Vérifiez que les dépendances de composant sont correctement décrites.
    • Vérifiez qu'il existe une seule version de chaque classe dans l'application.
  4. Créez un descripteur de déploiement XML pour l'application et nommez-le "application.xml".
  5. Regroupez les éléments de l'application en un package.
    a. Insérez les modules J2EE dans les répertoires appropriés. Insérez le descripteur de déploiement dans META-INF/application.xml.
    b. Regroupez le tout dans un fichier ".EAR".

Ajout et suppression de modules

Il est possible d'ajouter des modules J2EE à une application avant son
déploiement, à l'aide des étapes suivantes :

  1. Décidez de l'emplacement du nouveau module dans le package de l'application. Si vous le souhaitez,
    créez de nouveaux répertoires dans la hiérarchie du package de l'application.
  2. Copiez les nouveaux modules J2EE vers l'emplacement souhaité.
  3. Editez les descripteurs de déploiement des modules J2EE pour relier les dépendances
    qui peuvent être résolues en interne par ces modules.
  4. Editez le descripteur de déploiement de l'application comme il convient.

De même, il est possible de supprimer un module : retirez-le de la hiérarchie du package de l'application et éditez les descripteurs de déploiement de manière à éliminer les incohérences.

Validation de l'application

Des erreurs complexes pouvant survenir en particulier du côté du serveur d'applications et entraîner des messages d'erreurs inexistantes ou étranges, il peut s'avérer utile de valider le contenu de l'archive avant de procéder au déploiement. Vérifiez par exemple qu'au moins un module est défini dans le fichier EAR.

L'archive EAR peut également être validée à l'aide d'un outil de vérification J2EE, livré avec J2EE SDK. Cet outil vérifie la cohérence et la bonne formation de l'archive. Par exemple, il s'assure que les archives des modules et de l'application sont cohérentes avec les spécifications standard (J2EE, Servlet et EJB).