Affichage des descripteurs de déploiement
Un descripteur de déploiement est un fichier XML (extensible markup language) qui définit les options de configuration et de conteneur d'une application ou d'un module.
Avant de commencer
Cette rubrique suppose que vous avez installé une application ou un module sur un serveur et que vous souhaitez afficher son descripteur de déploiement.
Pourquoi et quand exécuter cette tâche
Lorsque vous créez une application ou un module J2EE (Java™ 2 Platform, Enterprise Edition) dans un outil d'assemblage, l'outil crée des fichiers de descripteur de déploiement pour l'application ou le module. Les applications et les modules Java EE (Java Platform, Enterprise Edition) versions 5 et ultérieurs peuvent utiliser des annotations à la place de descripteurs de déploiement.
Une fois qu'une application ou un module a été installé sur un serveur, vous pouvez afficher son descripteur de déploiement dans la console d'administration. Vous ne pouvez pas afficher les annotations Java EE versions 5 et ultérieures.
A moins qu'une application prenne en charge Java EE version 5 ou ultérieure, un fichier EAR (enterprise archive) doit contenir un fichier application.xml. Le fichier application.xml a pour rôle d'identifier chaque module d'une application. Il n'est pas nécessaire d'avoir recours à une application Java EE 5 pour fournir un fichier application.xml dans le fichier EAR. Si un fichier application.xml n'existe pas, le produit examine le contenu du fichier JAR (Java archive) pour déterminer si le fichier JAR est un module EJB (enterprise bean) ou un module client d'application. Un fichier JAR ne devrait pas contenir plus d'un descripteur de déploiement. Lorsqu'un fichier ejb-jar.xml se trouve dans un fichier JAR, le produit le considère comme étant un module EJB. Si un fichier ejb-jar.xml est introuvable alors qu'un fichier application-client.xml existe, le produit considère le fichier JAR comme étant un module client d'application. Si les deux fichiers ejb-jar.xml et application-client.xml se trouvent dans le fichier JAR, il se peut que le produit prenne en compte un fichier JAR conçu pour être un module client d'application comme étant un module EJB ou un fichier JAR conçu pour être un module EJB comme étant un module client d'application. Un fichier JAR ne devrait pas contenir plusieurs types de descripteur de déploiement.
Procédure
Résultats
Le descripteur de déploiement de l'application ou du module s'affiche.
Exemple
Le descripteur de déploiement du produit DefaultApplication est le suivant :
<application id="Application_ID" >
<display-name> DefaultApplication.ear</display-name>
<description> This is the IBM WebSphere
Application Server Default Application.</<description>
<module id="WebModule_1" >
<web>
<web-uri> DefaultWebApplication.war</web-uri>
<context-root> /</context-root>
</web>
</module>
<module id="EjbModule_1" >
<ejb> Increment.jar</ejb>
</module>
<security-role id="SecurityRole_1204342979281" >
<description> All Authenticated users role.</description>
<role-name> All Role</role-name>
</security-role>
</application>
Que faire ensuite
Une fois un descripteur de déploiement affiché dans la page de la console, procédez comme suit :
- Examinez le contenu du descripteur de déploiement, notamment les configurations
des liaisons d'application, les rôles de
sécurité, les références aux autres ressources ou les noms JNDI (Java Naming and Directory Interface).
Par exemple, examinez les fichiers JAR de votre module Java EE version 5 ou ultérieure pour vous assurer que chaque fichier JAR ne contient pas plusieurs types de descripteur de déploiement. S'il en contient plusieurs, passez à l'étape suivante puis supprimez tous les descripteurs de déploiement en trop. Ainsi, si les deux fichiers ejb-jar.xml et application-client.xml existent dans un fichier JAR, supprimez le descripteur de déploiement dont votre module n'a pas besoin.
- Modifiez un descripteur de déploiement si nécessaire.
Vous pouvez modifier manuellement un fichier de descripteur de déploiement. Il est cependant préférable de modifier un descripteur de déploiement en utilisant la console ou l'éditeur de descripteur de déploiement d'un outil d'assemblage afin de déterminer si le descripteur de déploiement a des propriétés valides et que ses références contiennent les valeurs appropriées.
Si votre module Java EE version 5 ou ultérieure ne comporte pas d'attribut metadata-complete ou si son attribut metadata-complete est défini sur false, vous pouvez demander au produit d'écrire l'ensemble du descripteur de déploiement du module, dont les informations d'annotations, au format XML. Dans la page Métadonnées pour des modules, choisissez attribut metadata-complete.
