1 Understanding Message-driven Beans

A message-driven bean (MDB) is an enterprise bean that allows Java EE applications to process messages asynchronously. An MDB acts as a JMS or JCA message listener, which is similar to an event listener except that it receives messages instead of events. The messages are sent by any of the Java EE components like application client, another enterprise bean, a Web component, or even a non-Java EE application.

These are the key features of message-driven beans:

  • Clients do not access message-driven beans through interfaces. A message-driven bean has only a bean class.

  • A message-driven bean's instances retain no data or conversational state for a specific client. All instances of a message-driven bean are equivalent, allowing the EJB container to assign a message to any message-driven bean instance. The container can pool these instances to allow streams of messages to be processed concurrently.

When a message arrives, the container calls the message-driven bean's onMessage method to process the message. The onMessage method may call helper methods, or it may invoke a session or entity bean to process the information in the message or to store it in a database.

A message may be delivered to a message-driven bean within a transaction context, so that all operations within the onMessage method are part of a single transaction. If message processing is rolled back, the message will be re-delivered.

For information about design alternatives for message-driven beans, see MDBs and Messaging Models.

For a description of the overall EJB development process, see Developing Enterprise JavaBeans for Oracle WebLogic Server.

JCA-Based MDBs

Learn how to configure MDBs to receive messages from JCA 1.7-compliant resource adapters and to set the resource-adapter-jndi-name deployment descriptor.

See the JCA 1.7 specification and resource-adapter-jndi-name in Developing Enterprise JavaBeans, Version 2.1, for Oracle WebLogic Server.