You can configure
the message-driven bean deployment attributes
for a Java™ EE Connector Architecture (JCA) 1.5-compliant
enterprise application, to override the deployment attributes defined
within the application EAR file.
Before you begin
Esta tarefa assume que você tenha um arquivo EAR que contenha um aplicativo corporativo,
desenvolvido como um bean acionado por mensagens, que pode
ser implementado no WebSphere® Application Server.
Note: You
can continue to
configure message-driven
beans against a listener port.
É possível que você deseje fazer isso para a compatibilidade com os aplicativos de bean acionado por mensagens existentes. Porém, as portas listener são estabilizadas e você deve planejar a migração de todos os beans acionados
por mensagens para usar os recursos compatíveis com o JCA 1.5 ou 1.6.
About this task
Configure os atributos de implementação de um aplicativo de bean acionado por mensagens utilizando uma ferramenta de montagem. As etapas detalhadas fornecidas nesta tarefa são para o Rational® Application Developer, mas outras ferramentas possuem etapas bem semelhantes.
Procedure
- Inicie sua ferramenta de montagem.
- Edite o arquivo EAR do aplicativo. Por exemplo, use o assistente de importação do Rational
Application Developer para importar o arquivo EAR para a ferramenta do conjunto. Para iniciar o assistente para importação:
- Clique em .
- Clique em Avançar, em seguida, selecione o arquivo EAR.
- Clique em Concluir.
- Abre os atributos de implementação para edição. Na visualização Hierarquia do Java EE, clique com o botão direito
do mouse no módulo EJB para o bean acionado por mensagens e, em seguida, clique em . Um bloco de notas do diálogo de propriedade para o bean acionado por mensagens é exibido na área de janela de propriedade.
- Review and, if needed, change the deployment attributes.
- Na área de janela de propriedade, clique na guia Bean.
- Em Configuração de Ativação, revise os atributos.
Note: Para os beans acionados por mensagens do EJB 3, você deve usar uma anotação EJB 3 para definir as propriedades de configuração de ativação. Não use uma anotação EJB para alterar o que é especificado no descritor de implementação de bean. Se uma propriedade de configuração de ativação for especificada nos dois locais, o valor usado será aquele que for fornecido no descritor de implementação.
- acknowledgeMode
- Esse atributo determina como a sessão reconhece quaisquer mensagens que receber.
- Confirmação Automática
- A sessão reconhece automaticamente a entrega de cada mensagem.
- Confirmação de Recebimento Duplicada
- A sessão confirma com atraso a entrega de mensagens. Essa configuração
provavelmente resulta na entrega de algumas mensagens duplicadas se o JMS falhar,
portanto, ela deve ser usada apenas pelos aplicativos de consumidor que são tolerantes
às mensagens duplicadas.
- destinationType
- Esse atributo determina se o bean acionado por mensagens usa um destino de fila ou de tópico.
- Fila
- O bean acionado por mensagens usa um destino de fila.
- Tópico
- O bean acionado por mensagens usa um destino de tópico.
- subscriptionDurability
- Esse atributo determina se uma assinatura de tópico JMS é durável ou não durável.
- Durável
- Um assinante registra uma assinatura durável com uma identidade exclusiva que é mantida pelo JMS.
Objetos de assinante subsequentes com a mesma identidade retomam a assinatura no estado em que foi deixada pelo assinante anterior. Se não houver nenhum assinante ativo para uma
assinatura durável, o JMS reterá as mensagens de assinatura até que elas
sejam recebidas pela assinatura ou expirem.
- Não-durável
- As assinaturas não duráveis duram o tempo de vida do objeto do
assinante. Isso significa que um cliente vê as mensagens publicadas em um tópico apenas enquanto o assinante está ativo. Se o assinante não estiver ativo, estará faltando mensagens do cliente publicadas neste tópico.
Um assinante não durável somente pode ser utilizado no mesmo contexto de transação (por exemplo, uma transação global
ou um contexto de transação não especificado) que existia quando o assinante
foi criado.
- messageSelector
- Esse atributo determina o seletor de mensagens JMS que é usado para selecionar quais mensagens o bean acionado por mensagens recebe. Por exemplo:
JMSType='car' AND color='blue' AND weight>2500
A cadeia do seletor pode referir-se aos campos no cabeçalho de mensagens do JMS e aos campos nas propriedades da mensagem. Os seletores de mensagens não podem fazer referência a valores do corpo da mensagem.
- Especifique os atributos de implementação de ligações.
Em Ligações do WebSphere, selecione a opção Adaptador JCA e especifique os atributos de implementação de ligações:
- Nome de JNDI de ActivationSpec
- Esse atributo especifica o nome do JNDI da especificação de ativação que é usado para implementar esse bean acionado por mensagem. Este nome deve corresponder ao nome de uma especificação de ativação definida para o WebSphere Application Server.
- Alias de Autorização ActivationSpec
- Esse atributo especifica o nome de um alias de autenticação usado
para autenticação de conexões para o adaptador de recursos JCA. Um alias de
autenticação especifica o ID de usuário e senha que são usados para autenticar
a criação de uma nova conexão com o adaptador de recursos da JCA.
- Nome de JNDI de Destino
- Esse atributo especifica o nome da JNDI que o bean acionado por mensagens usa
para procurar pelo destino da JMS no namespace da JNDI.
- Salve suas alterações no descritor de implementação:
- Feche o Editor do Descritor de Implementação.
- Quando solicitado, clique em Sim para indicar que deseja salvar as mudanças no descritor de implementação.
- Verifique os arquivos archive.
- A partir do menu pop-up para o projeto, clique em Implementar para gerar o código de implementação do EJB.
- Optional: Teste o módulo concluído em uma instalação do WebSphere Application
Server.
Clique com o botão direito do mouse em um módulo, clique em Executar no Servidor e, em seguida, siga as instruções no assistente exibido.
Restriction: Executar no Servidor funciona
apenas nos sistemas operacionais Windows, Linux/Intel e AIX®. Não é possível implementar
remotamente em uma instalação do WebSphere Application
Server em um sistema operacional UNIX como o Solaris.
Important: Use Executar no Servidor apenas para a unidade de teste. Quando um aplicativo é publicado remotamente, a ferramenta de
montagem sobrescreve o arquivo de configuração do servidor. Não utilize em servidores de produção.
What to do next
Depois de montar seu aplicativo, use uma ferramenta de gerenciamento do sistema para implementar o arquivo EAR no servidor de aplicativos que executará o aplicativo; por exemplo, use o console administrativo, conforme descrito em Implementando e Gerenciando Aplicativos.