Editando e validando projetos de contextos e injeção de dependência

É possível usar o editor do descritor de implementação de contextos e injeção de dependência para editar e validar o arquivo beans.xml.

Antes de Iniciar

Crie um projeto com máscara Java™ EE (isto é, um projeto de utilitário, EJB, da web, de conector ou de aplicativo cliente) em sua área de trabalho. Para obter informações sobre como criar um desses projetos, consulte: Criando e configurando projetos Java EE usando assistentes.

Sobre Esta Tarefa

No CDI 1.0, o arquivo beans.xml é necessário no empacotamento e na implementação de um projeto ativado para CDI. A presença do arquivo beans.xml indica para o contêiner que o módulo implementado é um archive de bean. O descritor de implementação é gerado ao instalar o aspecto de CDI. Consulte Criando aplicativos que usam Contextos e Injeção de Dependência (CDI). Inicialmente, o arquivo beans.xml fica vazio, o que significa que os interceptores anotados, decoradores ou alternativas existentes no módulo ficam desativados. Para ativar essas classes, é possível configurá-las utilizando o editor do descritor de implementação de CDI.

A partir do CDI 1.2, o arquivo beans.xml é opcional no empacotamento e na implementação de um projeto ativado para CDI. Esse arquivo não é criado ao incluir o aspecto do CDI 1.2. É possível gerar esse arquivo clicando com o botão direito no projeto e selecionando Ferramentas Java EE > Gerar stub do descritor de implementação de beans de CDI no menu.

Procedimento

  1. Para abrir o editor do descritor de implementação de contexto e injeção de dependência, dê um clique duplo no arquivo beans.xml.
  2. Clique em Incluir para incluir alternativas, decoradores e interceptores no arquivo beans.xml.

    A partir do CDI 1.2, também é possível clicar em Incluir para especificar scan, o que pode ser usado para configurar filtros de exclusão. Os filtros de exclusão impedem que as classes sejam descobertas como beans.

  3. No editor do CDI 1.2, use os valores de modo de descoberta de bean a seguir para especificar como varrer o archive de bean: all,annotated ou none.

    O editor do descritor de implementação de CDI emite erros de validação nas seguintes condições:

    • Se houver classes alternativas, classes de decoradores ou classes de interceptores vazias.
    • Se houver classes alternativas, classes de decoradores ou classes de interceptores não existentes.
    • Se houver classes alternativas, classes de decoradores ou classes de interceptores duplicadas.
    • Se houver classes que não possuem as anotações @Alternative, @Interceptor ou @Decorator adequadas.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcdideploymentdescriptoreditor.html