org.glassfish.ejb.api

Interface MessageBeanProtocolManager

All Known Implementing Classes:

MessageBeanContainer

public interface MessageBeanProtocolManager

MessageBeanProtocolManager is implemented by the MessageBeanContainer and allows MessageBeanClients to create message bean listeners capable of receiving messages. Each MessageBeanListener logically represents a single message-driven bean instance, although there is no guarantee as to exactly when the container creates that instance. MessageBeanListeners are single-threaded. Each MessageBeanListener is held exclusively by a MessageBeanClient.

Author:

Kenneth Saks

Method Summary

Modifier and Type	Method and Description
MessageBeanListener	createMessageBeanListener(ResourceHandle resourceHandle) Create a MessageBeanListener.
Object	createMessageBeanProxy(InvocationHandler handler)
void	destroyMessageBeanListener(MessageBeanListener listener) Return the MessageBeanListener to the container.
BeanPoolDescriptor	getPoolDescriptor() Returns the message-bean container's pool properties.
boolean	isDeliveryTransacted(Method method) This is used by the message provider to find out whether message deliveries will be transacted or not.

Method Detail

createMessageBeanListener

MessageBeanListener createMessageBeanListener(ResourceHandle resourceHandle)
                                       throws ResourcesExceededException

Create a MessageBeanListener.

Parameters:

resourceHandle - handle associated with this listener. can be null.

Throws:

Exception - if the MessageBeanContainer was not able to create the MessageBeanListener

ResourcesExceededException

destroyMessageBeanListener

void destroyMessageBeanListener(MessageBeanListener listener)

Return the MessageBeanListener to the container. Since a MessageBeanListener is typically associated with active resources in the MessageBeanContainer, it is the responsibility of the MessageBeanClient to manage them judiciously.

createMessageBeanProxy

Object createMessageBeanProxy(InvocationHandler handler)
                       throws Exception

Throws:

Exception

isDeliveryTransacted

boolean isDeliveryTransacted(Method method)

This is used by the message provider to find out whether message deliveries will be transacted or not. The message delivery preferences must not change during the lifetime of a message endpoint. This information is only a hint and may be useful to perform optimizations on message delivery.

Parameters:

method - One of the methods used to deliver messages, e.g. onMessage method for javax.jms.MessageListener. Note that if the method is not one of the methods for message delivery, the behavior of this method is not defined.

getPoolDescriptor

BeanPoolDescriptor getPoolDescriptor()

Returns the message-bean container's pool properties.