Visualización de descriptores de despliegue
Un descriptor de despliegue es un archivo XML (extensible markup language) que especifica la configuración y las opciones de contenedor correspondientes a una aplicación o módulo.
Antes de empezar
En este tema se da por supuesto que ha instalado una aplicación o módulo en el servidor y que desea ver su descriptor de despliegue.
Acerca de esta tarea
Al crear una aplicación J2EE (Java™ 2 Platform, Enterprise Edition) o un módulo en una herramienta de ensamblaje, la herramienta de ensamblaje crea archivos de descriptor de despliegue para la aplicación o el módulo. Los módulos o las aplicaciones Java EE (Java Platform, Enterprise Edition) 5 o posteriores pueden utilizar anotaciones en lugar de descriptores de despliegue.
Después de instalar una aplicación o módulo en un servidor, puede ver su descriptor de despliegue en la consola administrativa. No puede ver anotaciones Java EE 5 o posteriores.
Salvo que una aplicación dé soporte a Java EE 5 o posteriores, un archivo EAR (Enterprise Archive) debe contener un archivo application.xml. El archivo application.xml identifica cada módulo de una aplicación. No se requiere una aplicación Java EE para proporcionar un archivo application.xml en un archivo EAR. Cuando un archivo application.xml no existe, el producto examina el contenido del archivo JAR (Java Archive) para determinar si el archivo JAR es un módulo EJB (Enterprise bean) o un módulo de cliente de aplicación. Un archivo JAR no debe contener más de un descriptor de despliegue. Cuando se encuentra un archivo ejb-jar.xml en un archivo JAR, el producto lo considera un módulo EJB. Si no se encuentra un archivo ejb-jar.xml y se encuentra un archivo application-client.xml, el producto considera que el archivo JAR es un módulo de cliente de aplicación. Si tanto el archivo ejb-jar.xml como el archivo application-client.xml existen en el archivo JAR, el producto puede considerar que un archivo JAR que pretendía ser un módulo de cliente de aplicación es un módulo EJB, o que un archivo JAR que pretendía ser un módulo EJB es un módulo de cliente de aplicación. Un archivo JAR no debe contener más de un tipo de descriptor de despliegue.
Procedimiento
Resultados
Se visualiza el descriptor de despliegue para la aplicación.
Ejemplo
A continuación se muestra el descriptor de despliegue para DefaultApplication del producto:
<application id="ID_aplicación" >
<display-name> DefaultApplication.ear</display-name>
<description> Ésta es la aplicación por omisión de IBM WebSphere Application Server.</<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> Role de todos los usuarios autenticados.</description>
<role-name> Rol de todos</role-name>
</security-role>
</application>
Qué hacer a continuación
Después de visualizar un descriptor de despliegue en la página de consola, realice lo siguiente:
- Examine el contenido del descriptor de despliegue, incluyendo las configuraciones
que tenga para los enlaces, roles de seguridad, referencias a otros recursos, o los
nombres JNDI (Java Naming and Directory Interface).
Por ejemplo, examine los archivos JAR del módulo Java EE 5 o posterior para asegurarse de que cada archivo JAR no contiene más de un tipo de descriptor de despliegue. Si un archivo JAR contiene más de un tipo de descriptor de despliegue, siga al siguiente paso y elimine el descriptor de despliegue ajeno. Por lo tanto, si los archivos ejb-jar.xml y application-client.xml existen en el archivo JAR, elimine el descriptor de despliegue que el módulo no necesita.
- Cambie un descriptor de despliegue cuando sea necesario.
Puede editar archivos descriptores de despliegue manualmente. No obstante, es preferible editar los descriptores de despliegue utilizando la consola o en un editor de descriptor de despliegue de herramienta de ensamblaje para asegurarse de que el descriptor tiene las propiedades válidas y que las referencias contienen los valores correctos.
Si el módulo Java EE 5 o posterior no tiene un atributo metadata-complete o el atributo metadata-complete se ha establecido en false, puede indicar al producto que grabe todo el descriptor de despliegue del módulo, incluida la información de despliegue de las anotaciones, en un formato XML. En la página Metadatos para módulos, seleccione metadata-complete attribute.
