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

  1. Accédez à une vue de descripteur de déploiement.

    Cliquez sur l'option de navigation indiquée dans Accès à une vue de la console pour visualiser le descripteur de déploiement d'un module donné :

    Tableau 1. Accès aux pages du descripteur de déploiement dans la console. Cliquez sur les liens dans l'arborescence de navigation de la console et les pages.
    Module Fichier des descripteurs de déploiement Accès à une vue de la console
    Application d'entreprise application.xml Applications > Types d'application > Applications WebSphere enterprise > nom_application > Affichage du descripteur de déploiement
    application Web WEB-INF/web.xml Applications > Types d'application > Applications WebSphere enterprise > nom_application > Gestion des modules > nom_module > Affichage du descripteur de déploiement
    WEB-INF/portlet.xml Applications > Types d'application > Applications WebSphere enterprise > nom_application > Gestion des modules > nom_module > Afficher le descripteur de déploiement du portlet
    Bean enterprise ejb-jar.xml Applications > Types d'application > Applications WebSphere enterprise > nom_application > Gestion des modules > nom_module > Affichage du descripteur de déploiement
    Client d'application application-client.xml Applications > Types d'application > Applications WebSphere enterprise > nom_application > Gestion des modules > nom_module > Affichage du descripteur de déploiement
    Service Web webservices.xml Applications > Types d'application > Applications d'entreprise WebSphere > nom_application > Gestion des modules > nom_module >
    • Afficher l'extension du descripteur de déploiement du client de services Web
    • Afficher le descripteur de déploiement du serveur de services Web
    • Afficher l'extension du descripteur de déploiement du serveur de services Web
    Pour plus d'informations sur les vues, voir la rubrique relative à l'affichage des descripteurs de déploiement des services Web dans la console d'administration.
    Adaptateur de ressources imbriqué dans une application d'entreprise ra.xml Applications > Types d'application > Applications d'entreprise WebSphere > nom_application > Gestion des modules > nom_module_ra > Afficher le descripteur de déploiement
    Adaptateur de ressources autonome ra.xml Ressources > Adaptateurs de ressources > Adaptateurs de ressources > nom_module > Affichage du descripteur de déploiement
  2. Cliquez sur Développer tout pour afficher le contenu du descripteur de déploiement.

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 :

  1. 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.

  2. 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.

Eviter les incidents Eviter les incidents: Si votre application Java EE version 5 ou ultérieure utilise des annotations et une bibliothèque partagée, ne sélectionnez pas l'attribut metadata-complete. Lorsque l'application utilise des annotations et une bibliothèque partagée, si vous affectez à l'attribut metadata-complete la valeur true, le produit représente de manière incorrecte une annotation @EJB dans le descripteur de déploiement sous la forme <ejb-ref>> au lieu de <ejb-local-ref>>. Pour les modules Web, quand vous affectez à l'attribut metadata-complete la valeur true, il se produit des erreurs InjectionException. Si vous devez affecter à l'attribut metadata-complete la valeur true, pour éviter les erreurs, n'utilisez pas de bibliothèque partagée directement mais placez-la plutôt dans le répertoire classes ou lib du serveur d'applications, ou indiquez intégralement les métadonnées dans les descripteurs de déploiement.gotcha

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_deploymtdesc
Nom du fichier : trun_app_deploymtdesc.html