Visualizando Descritores de Implementação
Um descritor de implementação é um arquivo XML (Extensible Markup Language) que especifica opções de configuração e do contêiner para um aplicativo ou módulo.
Antes de Iniciar
Este tópico supõe que você tenha instalado um aplicativo ou um módulo em um servidor e que deseja visualizar seu descritor de implementação.
Sobre Esta Tarefa
Ao criar um aplicativo ou um módulo Java™ 2 Platform, Enterprise Edition (J2EE) em uma ferramenta de montagem, a ferramenta de montagem cria arquivos descritores de implementação para o aplicativo ou o módulo. Aplicativos e módulos Java Platform, Enterprise Edition (Java EE) 5 ou posteriores podem usar anotações em vez de descritores de implementação.
Depois de um aplicativo ou módulo ser instalado em um servidor, você pode visualizar seu descritor de implementação no console administrativo. Não é possível visualizar anotações do Java EE 5 ou mais recente.
A menos que um aplicativo suporte Java EE 5 ou posterior, um archive corporativo (EAR) deve conter um arquivo application.xml. O application.xml identifica cada módulo de um aplicativo. Um aplicativo Java EE 5 não é necessário para fornecer um arquivo application.xml no arquivo EAR. Quando um arquivo application.xml não existir, o produto avalia o conteúdo do arquivo JAR (Arquivo de Java) para determinar se o arquivo JAR é um módulo EJB (Enterprise Bean) ou um módulo de aplicativo cliente. Um arquivo JAR não deve conter mais de um descritor de implementação. Quando um arquivo ejb-jar.xml está localizado em um arquivo JAR, o produto o considera um módulo EJB. Se um arquivo ejb-jar.xml não for localizado e um application-client.xml for localizado, o produto considerará o arquivo JAR como um módulo de aplicativo cliente. Se ambos os arquivos, ejb-jar.xml e application-client.xml, existirem no arquivo JAR, o produto pode considerar um arquivo JAR destinado a ser um módulo de aplicativo cliente como sendo um módulo EJB ou um arquivo JAR destinado a ser um módulo EJB como sendo um módulo de aplicativo cliente. Um arquivo JAR não deve conter mais do que um tipo de descritor de implementação.
Procedimento
Resultados
O descritor de implementação do aplicativo ou módulo é exibido.
Exemplo
O descritor de implementação do produto DefaultApplication é o seguinte:
<application id="Application_ID" >
<display-name> DefaultApplication.ear</display-name>
<descrição> Esse é o Aplicativo IBM WebSphere Application Server Padrão.</<descrição>
<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> Todas as Funções dos Usuários Autenticados.</description>
<role-name> Todas as Funções</role-name>
</security-role>
</application>
O que Fazer Depois
Ao exibir um descritor de implementação na página do console, execute o seguinte procedimento:
- Examine o conteúdo do descritor de implementação, incluindo suas configurações
para ligações de aplicativos, funções de segurança, referências a
outros recursos, ou nomes da Java Naming and Directory Interface (JNDI).
Por exemplo, examine os arquivos JAR do módulo Java EE 5 ou posterior para assegurar-se de que cada arquivo JAR não contenha mais de um tipo de descritor de implementação. Se um arquivo JAR contiver mais de um tipo de descritor de implementação, continue na próxima etapa e remova o descritor de implementação externo. Assim, se os arquivos ejb-jar.xml e application-client.xml existirem em um arquivo JAR, remova o descritor de implementação que o seu módulo não precisa.
- Altere um descritor de implementação conforme necessário.
É possível editar um arquivo do descritor de implementação manualmente. No entanto, é preferível editar um descritor de implementação usando o console ou em um editor do descritor de implementação da ferramenta de montagem para assegurar-se de que o descritor de implementação tenha propriedades válidas e que suas referências contenham valores apropriados.
Se o módulo Java EE 5 ou mais recente não tiver um atributo metadata-complete ou o atributo metadata-complete estiver configurado como false, você poderá orientar o produto para gravar o descritor de implementação do módulo inteiro, incluindo informações de implementação de anotações, no formato XML. Na página Metadados para Módulos, selecione metadata-complete attribute.
