É possível utilizar o assistente Criar bean acionado por mensagens EJB 3.x para criar um bean acionado por mensagens e incluí-lo em um projeto.
Antes de Iniciar
Deve haver um projeto Java™, um projeto EJB ou um projeto da web criado em sua área de trabalho.
Sobre Esta Tarefa
A principal diferença entre um bean acionado por
mensagens e um bean de sessão é que o primeiro não possui interface
local ou remota, possui apenas uma classe de bean.
Procedimento
- Na perspectiva Java EE,
clique com o botão direito em seu projeto e selecione . O assistente Criar bean acionado por mensagens EJB 3.x é aberto.
- No campo Source folder, selecione a pasta de origem do novo bean.
- No campo Pacote, digite o nome do pacote
para o novo bean.
- No campo Nome, digite o nome que deseja designar ao bean acionado por mensagens. Convencionalmente, os nomes de beans começam com letras maiúsculas.
- No campo Nome do Destino, digite o nome que deseja designar ao destino.
- Selecione JMS para utilizar o serviço de sistema de mensagensJava ou desmarque JMS para utilizar outro serviço de sistema de mensagens.
- No campo Tipo de Destino, selecione o tipo de destinoFila ou Tópico e clique em Avançar.
- Na página Informações Específicas do Bean Acionado por Mensagens, no
campo Tipo de Transação, selecione Contêiner para
transações gerenciadas por contêiner ou Bean para
transações gerenciadas por bean.
- Clique em Concluir. O editor Java contém o código padrão para sua classe de bean acionado por mensagens:
package com.ibm.test;
import javax.ejb.ActivationConfigProperty;
import javax.ejb.MessageDriven;
import javax.jms.Message;
import javax.jms.MessageListener;
/**
* Message-Driven Bean implementation class for: TestMdb
*
*/
@MessageDriven(
activationConfig = { @ActivationConfigProperty(
propertyName = "destinationType", propertyValue = "javax.jms.Queue"
) })
public class TestMdb implements MessageListener {
/**
* Construtor padrão.
*/
public TestMdb() {
// TODO Auto-generated constructor stub
}
/**
* @see MessageListener#onMessage(Message)
*/
public void onMessage(Message message) {
// TODO Stub de método gerado automaticamente
}
}
Neste exemplo de código de bean acionado por mensagens padrão,
os seguintes pontos são importantes a observar:
- No EJB 3.x, a anotação @MessageDriven especifica um conjunto de parâmetros de configuração de ativação. Esses parâmetros são exclusivos a um tipo particular de adaptador JCA 1.5 utilizado para orientar o bean acionado por mensagens. Alguns adaptadores têm parâmetros de configuração que permitem especificar a fila de destino do bean acionado por mensagens.
No caso em que o adaptador não oferece suporte a isso, o nome do destino deve ser especificado utilizando uma entrada <message-destination> no arquivo de ligação XML.
- A classe de bean precisa implementar a interface MessageListener, que define somente um método, onMessage. Quando chega uma mensagem na fila monitorada por esse MDB, o contêiner chama o método onMessage da classe de bean e passa a mensagem recebida como um parâmetro.
- O ActivationConfigProperty da anotação @MessageDriven fornece informações de configuração específicas do sistema de mensagens.