Para cada bean acionado por mensagens (MDB) definido em um arquivo ejb-jar.xml, um arquivo web.xml ou em uma anotação @MessageDriven na unidade de composição, é possível especificar as configurações necessárias para ligar um listener MDB ao MDB.
Ao ligar um listener a um MDB, você configura a associação do MDB com o destino JMS a partir do qual o MDB recebe mensagens.
Esse painel mostra uma linha de informações para cada MDB. As três colunas finais, Nome JNDI de Especificação de Ativação, Nome JNDI de Destino e Alias de Autenticação, especificam as informações de ligação.
Se uma configuração de ligação estiver definida em um arquivo de configuração XML ou em uma anotação @MessageDriven, essa configuração será exibida na coluna correspondente, caso contrário, a coluna estará vazia. É possível modificar qualquer configuração de ligação existente e especificar novas, conforme necessário, inserindo valores nas colunas apropriadas.
Para visualizar esse painel no console administrativo, clique em um dos seguintes caminhos:
Nota: A etapa do assistente Ligar Listeners aos Beans Acionados por Mensagens e a propriedade Listeners para Beans Acionados por Mensagens estarão visíveis apenas se o aplicativo OSGi contiver pelo menos um pacote configurável EJB que tenha pelo menos um MDB.
Propriedades Gerais
- Nome Simbólico do Pacote Configurável
- O nome não localizável para este pacote configurável.
- Versão do Pacote Configurável
- A versão deste pacote configurável.
O nome simbólico do pacote configurável, juntamente com a versão do pacote configurável, identifica exclusivamente um pacote configurável.
- URI
- O URI do local no qual o MDB está definido. A tabela a seguir descreve a sintaxe do URI dependendo do local da definição MDB:
| Local da definição do MDB |
Sintaxe do URI |
Exemplos |
|---|
| Arquivo ejb-jar.xml |
Caminho para o arquivo, seguido pelo nome
do MDB. |
META-INF/ejb-jar.xml/CustomerDetails ou WEB-INF/ejb-jar.xml/CustomerDetails |
| Anotação @MessageDriven em um enterprise bean |
Caminho para o arquivo ejb-jar.xml que contém a definição
do MDB no qual a anotação @MessageDriven é declarada, seguida pelo
nome do MDB. |
META-INF/ejb-jar.xml/CustomerDetails ou WEB-INF/ejb-jar.xml/CustomerDetails |
- Nome JNDI da Especificação de Ativação
- O nome JNDI da especificação de ativação que você deseja associar ao MDB. A especificação de ativação fornece a configuração necessária para o MDB receber mensagens de um destino JMS.
- Nome JNDI de Destino
- O nome JNDI do destino JMS a partir do qual o MDB recebe mensagens. Especifique um valor apenas se você deseja substituir o destino JMS que está configurado na especificação de ativação.
- Alias de Autenticação da Especificação de Ativação
- Se a especificação de ativação estiver protegida, especifique o alias de autenticação associado que define o ID do usuário e a senha. Especifique um valor apenas se você deseja substituir o alias de autenticação que está configurado na especificação de ativação.
Aplicar Diversos Mapeamentos
É possível aplicar uma configuração de ligação a dois ou mais MDBs em uma única operação. Execute as seguintes etapas:
- Marque as caixas de seleção, na coluna Selecionar, próxima aos MDBs aos quais você deseja aplicar a configuração de ligação.
- Expanda Aplicar Vários Mapeamentos.
- Selecione a configuração de ligação Nome JNDI de Especificação de Ativação, Nome JNDI
de Destino ou Alias de Autenticação de Especificação
de Ativação que deseja aplicar aos MDBs selecionados e clique no botão
Aplicar correspondente.
A configuração de ligação é aplicada aos MDBs selecionados.
Links marcados (on-line) requerem acesso à Internet. Cada link inicia uma procura para o tópico no centro de informações on-line. Quando os resultados da procura forem listados, selecione o tópico que corresponda
melhor à sua configuração.