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

  1. Acesse uma visualização do descritor de implementação.

    Clique na opção de navegação declarada em Acessando uma Visualização de Console, para visualizar o descritor de implementação para um determinado módulo:

    Tabela 1. Acessando Páginas Visualizar Descritor de Implementação no Console. Clique nos links na árvore de navegação e nas páginas do console.
    Módulo Arquivo do Descritor de Implementação Acessando uma Visualização de Console
    Aplicativo Corporativo application.xml Aplicativos > Tipos de Aplicativo > WebSphere Enterprise Applications > application_name > Visualizar Descritor de Implementação
    aplicativo da Web WEB-INF/web.xml Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications > application_name > Gerenciar Módulos > module_name > Visualizar Descritor de Implementação
    WEB-INF/portlet.xml Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications > application_name > Gerenciar Módulos > module_name > Visualizar Descritor de Implementação de Portlet
    Enterprise bean ejb-jar.xml Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications > application_name > Gerenciar Módulos > module_name > Visualizar Descritor de Implementação
    Cliente Aplicativo application-client.xml Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications > application_name > Gerenciar Módulos > module_name > Visualizar Descritor de Implementação
    Serviço da Web webservices.xml Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere > application_name > Gerenciar Módulos > module_name >
    • Visualizar extensão de descritor de implementação de cliente de serviços da Web
    • Visualizar descritor de implementação do servidor de serviços da Web
    • Visualização de extensão do descritor de implementação do servidor de serviços da Web
    Para obter informações sobre as visualizações, consulte o tópico sobre como visualizar descritores de implementação de serviços da Web no console administrativo.
    Adaptador de recursos integrado no aplicativo corporativo ra.xml Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos do WebSphere > application_name > Gerenciar Módulos > ra_module_name > Visualizar o descritor de implementação
    Adaptador de Recursos independente ra.xml Recursos > Adaptadores de Recursos > Adaptadores de Recursos > module_name > Visualizar Descritor de Implementação
  2. Clique em Expandir Todos para visualizar o conteúdo do descritor de implementação.

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:

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

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

Evitar Problemas Evitar Problemas: Se o aplicativo Java EE 5 ou mais recente usar anotações e uma biblioteca compartilhada, não selecione o atributo metadata-complete. Quando o aplicativo usa anotações e uma biblioteca compartilhada, configurar o atributo metadata-complete como true faz com que o produto represente incorretamente uma anotação @EJB no descritor de implementação como <ejb-ref>, em vez de <ejb-local-ref>. Para módulos da Web, a configuração do atributo metadata-complete para true pode causar erros de InjectionException. Se você tiver que configurar o atributo metadata-complete como true, evite erros não utilizando uma biblioteca compartilhada, colocando a biblioteca compartilhada no diretório classes ou lib do servidor de aplicativos ou especificando completamente os metadados nos descritores de implementação.gotcha

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_deploymtdesc
Nome do arquivo: trun_app_deploymtdesc.html