You can configure the message-driven
beans deployment attributes
for an enterprise bean, to override the deployment attributes defined
within the application EAR file.
Before you begin
Listener
ports are stabilized. For more information, read the article on stabilized
features. You should only configure your application against a listener
port for compatability with existing message-driven bean applications.
Otherwise, you should configure
your application against JCA 1.5-compliant resources.
Se você possuir beans acionados por mensagens existentes que usam o provedor do sistema de mensagens do IBM MQ (ou um provedor JMS de terceiro compatível) com portas do listener e, em vez de desejar usar beans acionados por mensagens EJB 3 com portas do listener, esses novos beans poderão continuar a usar o mesmo provedor de sistemas de mensagens.
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.
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.
- Specify general deployment attributes.
- Na área de janela de propriedade, clique na guia Bean.
- No painel principal, configure o atributo Tipo de Transação.
Esse atributo determina se as mensagens do bean acionado por mensagem possui suas próprias transações ou se o contêiner gerencia as transações em nome do bean.
- Bean
- O bean acionado por mensagens gerencia suas próprias transações.
- Contêiner
- O contêiner gerencia as transações em nome do bean.
- Em Configuração de Ativação, revise os seguintes 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.
- Specify the bindings deployment
attribute.
- Under WebSphere
Bindings, specify
the following attribute:
- Listener
port name
- Type the name of the listener port for this message-driven
bean.
- 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.