Conjunto de implementação do Java EE

As páginas de propriedade do conjunto de implementação permitem que você inclua recurso flexível e mapeamento de dependência em seus aplicativos.

Para acessar a página do conjunto de implementação, clique com o botão direito em seu projeto Java™ EE e selecione Propriedades > Conjunto de Implementação. Para módulos Java EE, a página consiste em duas guias:

Em projetos EAR, somente a guia Conjunto de Implementação está visível.

A guia de Conjunto de Implementação

A tabela Conjunto de Implementação consiste em duas colunas: a coluna Caminho de Implementação e a coluna Origem.
  • Caminho de Implementação:

    A coluna Caminho de Implementação representa o caminho no qual a referência está localizada dentro do archive empacotado. É possível modificar esta localização para customizar como você deseja que o seu archive fechado seja organizado. No entanto, a remoção de mapeamentos de pasta padrão ou a modificação de seus caminhos de implementação deve ser feita com cuidado, uma vez que podem ser encontrados problemas com a implementação se as mudanças violarem os requisitos da especificação do Java EE.

  • A Coluna Origem

    A coluna Origem representa a localização do recurso relativo para o projeto, o sistema de arquivos ou a área de trabalho, dependendo de qual tipo de dependência foi incluído.

Incluindo dependências

  • Archive a partir da Área de Trabalho: Se você incluir um archive a partir da referência de área de trabalho, poderá, então, incluir uma referência em um archive que esteja dentro de qualquer projeto na área de trabalho. A inclusão desta referência coloca o archive escolhido no caminho de implementação especificado.
  • Archives do Sistema de Arquivos: Se você incluir um Archive a partir da referência do Sistema de Arquivos, poderá, então, incluir uma referência em um archive que esteja em qualquer lugar no sistema de arquivos. A inclusão desta referência coloca o archive escolhido no caminho de implementação especificado.
  • Entradas do Caminho de Construção Java: Esta opção não está disponível para projetos EAR. Se você incluir uma referência de Entradas de Caminho de Construção Java, poderá, então, incluir uma referência em uma Entrada de Caminho de Construção Java que já esteja definido em seu projeto. É possível incluir referências nos seguintes tipos de Entrada de Caminho de Construção Java.
    • É possível incluir referências para perder arquivos JAR que são incluídos em um caminho de classe do projeto diretamente pela folha de propriedade de Caminho de Construção Java.
    • É possível incluir referências em variáveis que são definidas nas preferências da área de trabalho. Acesse essas variáveis selecionando Janela > Preferências > Java > Caminho de Construção > Página de Preferências do Caminho de Construção.
    • É possível incluir referências em bibliotecas do usuário que estão definidas nas preferências da área de trabalho. Acesse essas bibliotecas selecionando Janela > Preferências > Java > Caminho de Construção > Página de Preferências de Bibliotecas de Usuário. Todos os archives que estão contidos na biblioteca são colocados no caminho de implementação especificado. Ao incluir uma referência de Entradas de Caminho de Construção Java, o caminho de implementação é WEB-INF/lib para projetos da web. Para outros módulos que não são módulos da web, o caminho de implementação padrão é relativo ao módulo EAR pai. Se o módulo EAR pai for versão 5 e acima, o caminho de implementação será o diretório lib, tal como ../lib. Se o módulo EAR pai for versão 1.4 ou abaixo, o caminho de implementação colocará a Entrada do Caminho de Construção Java no mesmo nível que o módulo, tal como ../.
  • Projeto: Se você incluir uma referência do projeto, poderá, então, empacotar o projeto de área de trabalho escolhido em um archive, e colocar o archive no caminho de implementação especificado.
  • Pasta: Se você incluir uma referência de pasta, poderá, então, selecionar qualquer pasta do projeto, e mapear a pasta para um caminho de implementação dentro do archive. Por padrão, os caminhos de implementação de mapeamentos de pasta incluídos são configurados na pasta raiz do archive.

A guia Entradas do Manifest

Gerenciamento do caminho de classe Java EE

A experiência de desenvolvimento do Java EE em sua área de trabalho simula exatamente o ambiente de tempo de execução, reduzindo a possibilidade de problemas imprevistos que possam aparecer depois de publicar seu aplicativo. Cada arquivo MANIFEST do módulo é gerenciado capturando a visibilidade do tempo de execução através da duplicação de arquivos JAR dependentes ou outros projetos no caminho de classe do projeto. A guia MANIFEST do conjunto de implementação captura as entradas existentes e permite que você inclua entradas adicionais no escopo do módulo EAR pai. A lista de entradas disponíveis é limitada a arquivos do tipo JAR que residem dentro do módulo EAR implementado e não estão incluídos no diretório designado EAR lib. No Java EE 5, a pasta da biblioteca foi introduzida para os módulos EAR como uma técnica simples para compartilhar arquivos JAR usados por outros módulos contidos, mas que não são mais necessários para incluir entradas em cada arquivo MANIFEST respectivo. A página Conjunto de Implementação para projetos EAR inclui um campo para alterar o local padrão desta pasta. Por padrão, qualquer JAR na pasta /lib é compartilhado, e seu caminho de classe de projeto incluirá esses arquivos JAR automaticamente. Além disso, o arquivo JAR não é obrigado a residir fisicamente nesta pasta se for criado um mapeamento a partir de seu local de desenvolvimento para a pasta de tempo de execução /lib do arquivo EAR.

Os Módulos da Web também têm uma pasta especial que permite o compartilhamento de bibliotecas em WEB-INF/lib. Semelhante à pasta de biblioteca do EAR, qualquer arquivo JAR solto ou projeto da área de trabalho mapeado para este local aparecerá automaticamente no caminho de classe do projeto da web.

Configuração livre do WebSphere Application Server

O WebSphere Test Environment prepara seu projeto para implementação à medida que você está desenvolvendo, e usa o conteúdo do projeto simples conforme estão sendo mapeados para uma estrutura de tempo de execução Java EE padrão que o WebSphere Application Server pode entender. Esse mapeamento no WebSphere Application Server é chamado de configuração livre e permite a implementação ativa de aplicativos Java EE sem a necessidade de empacotamento especial antes da publicação. O novo recurso de conjunto permite usar layouts não padrão do projeto, e mapeamentos de artefato que podem requerer algum empacotamento no momento da publicação, e poderiam impactar o desempenho da publicação. Nestes casos, as mensagens de validação advertem para esses problemas em potencial. Se nenhuma mensagem aparecer, o seu aplicativo pode ser executado no estado em que se encontra, sem nenhuma penalidade de desempenho.

Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: cdeploymentassembly.html