Criando um bean acionado por mensagens utilizando assistentes

É 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

  1. Na perspectiva Java EE, clique com o botão direito em seu projeto e selecione Novo > Bean Acionado por Mensagens. O assistente Criar bean acionado por mensagens EJB 3.x é aberto.
  2. No campo Source folder, selecione a pasta de origem do novo bean.
  3. No campo Pacote, digite o nome do pacote para o novo bean.
  4. 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.
  5. No campo Nome do Destino, digite o nome que deseja designar ao destino.
  6. Selecione JMS para utilizar o serviço de sistema de mensagensJava ou desmarque JMS para utilizar outro serviço de sistema de mensagens.
  7. No campo Tipo de Destino, selecione o tipo de destinoFila ou Tópico e clique em Avançar.
  8. 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.
  9. 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.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcreatingmessdrivwiz.html