JEEBrasil

Na Listagem 1 está o código dessas duas interfaces.

	public interface javax.jms.MessageListener{
		public void onMessage(Message message);
	}
	
	public interface javax.ejb.MessageDrivenBean extends javax.ejb.EnterpriseBean {
		public void ejbRemove() throws EJBException;
		public void setMessageContext(MessageDrivenContext ctx) throws EJBException;

        }

Listagem 1 - Interfaces Implementadas pelos Message-Drive Beans

A interface javax.jms.MessageListener define o método onMessage (o único método de negócio do componente Message-Driven Bean). Esse realiza o processamente das mensagens consumidas. É necessario identificar o tipo de mensagem e efetuar um cast para um dos cinco tipos de mensagens JMS. Para executar o processamento da mensagem, o MSB pode invocar outros métodos de ajuda ou mesmo um Session Bean.

A interface javax.ejb.MessageDrivenBean define outros dois métodos callback: ejbRemove, chamado quando o servidor de aplicações decidir remover o objeto em questão. O método setMessageContext, por sua vez, informa a instância do componente o contexto de execução do Message-Driven Bean.

Todas as instâncias de um MSB são equivalentes e não mantém nenhuma informação sobre o cliente ou outro contexto. Dessa forma, não é necessário fornecer métodos construtor (ejbCreate) para esse tipo de componente. A criação dos MSBs é de responsabilidade do Container.

Assim como acontece com os Session Stateless Bean, o Container pode criar um Pool de MSBs e permitir o processamento concorrente de várias mensagens.

3. Ciclo de Vida de um MDB

A Figura 3 ilustra o ciclo de vida de um MDB.

Figura 3 - Clico de Vida de um MDB

Assim como os Stateless Session Bean, os MDBs nunca são passivados e portanto possuem dois estados: "não existe" e "pronto para receber mensagens". No fim do ciclo de vida, o container chama o método ejbRemote e o componente está pronto para ser coletado pelo coletor de lixo.

4. Transações

Uma mensagem deve ser consumida dentro de uma transação. Assim, todas as operações dentro do método onMessage fazem parte de uma única transação. Se o processamento de uma mensagem for "rolled back", a mensagem será devolvida para a fila de mensagens.

5. Implementando um simples Message-Driven Bean

O código da Listagem 2 é a implementação de um Message-Driven Bean que recebe uma mensagem e imprime na tela.

package br.com.j2eebrasil.artigo.ejb;

import javax.ejb.*;
import javax.jms.*;


public class MessageBean implements MessageDrivenBean, MessageListener {
	
	protected MessageDrivenContext contexto;

	/* Chamado quando o Bean for inicializado */
	public void ejbCreate() {
		System.out.println("Componente Criado");
	}
	
	/* Informa o contexto a implementação do componente */
	public void setMessageDrivenContext(MessageDrivenContext ctx) {
		contexto = ctx;
	}

	/* Método da lógica de negócio */
	public void onMessage(Message msg) {
	
		if (msg instanceOf TextMessage) {
			
			TextMessage msgTexto = (TextMessage) msg;
			try {
				System.out.println("O texto informado " + msg.getText() );
			}
			catch (JMSException e ) {
				e.printStackTrace();
			}
		}
	}
	
	/* Remove o Bean */
	public void ejbRemove() {
		System.out.println("Sendo removido");
	}
	
}			

Listagem 2 - Implementação de MDB que Recebe Mensagem

O método onMessage imprime a mensagem recebida. Em situações reais esta mensagem poderia acionar um outro componente de negócio, ser armazenada em banco de dados, ou qualquer outra operação de negócio.

6. Configurando o componente

É no deployment descriptor que configuramos o componente e definimos qual será a fila que o componente irá escutar por mensagens, qual o comportamento transacional, aspectos de segurança etc. Na Listagem 3 temos o deployment descriptor do Message-Driven Bean listado anteriormente.

<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Enterprise
JavaBeans 2.0//EN" "http://java.sun.com/dtd/ejb-jar_2_0.dtd">
<ejb-jar>
<enterprise-beans>

<message-driven>
<!-- O nome do componente  -->
<ejb-name>J2EEBrasilMDB</ejb-name>
<!-- Classe do componente -->
<ejb-class>examples.LogBean</ejb-class>
<!-- Tipo de transação -->
<transaction-type>Container</transaction-type>
<!-- Fila associada com o componente -->
<message-driven-destination>
<destination-type>javax.jms.Queue</destination-type>
</message-driven-destination>
</message-driven>
</enterprise-beans>
</ejb-jar>

Listagem 3 - Deployment Descriptor do MDB Anterior

Note que nos parâmetros configurados acima não especificamos qual será o nome da fila. Isso deve ser especificado no deployment descriptor específico do servidor de aplicações.

Isso se deve ao fato dos nomes das filas implantadas no servidor de aplicações serem específicos. Informando o nome da fila na configuração específica do servidor de aplicações tornamos o componente mais portável.

7. Conclusão

Os Message-Driven Beans possuem uma importância fundamental na arquitetura J2EE por fornecer a possibilidade de comunicação assíncrona e desacoplada entre componentes.

Os MDBs estão intimamente relacionados com a API JMS (Java Message Service). Assim, recomendamos fortemente uma leitura nos módulos introdutórios dessa tecnologia disponíveis aqui no J2EEBrasil.

O exemplo ilustrado nesse tutorial não exemplifica o desenvolvimento de um MDB em um container específico nem ilustra como enviar mensagens para serem consumidas. O próximo módulo do tutorial de MDB, no entanto, traz um exemplo mais completo envolvendo o desenvolvimento de uma pequena aplicação MOM (Message-Oriented Middleware) sendo projetada e executada no container JBoss.