File Doc Category Size Date Package
MessageBeanProtocolManager.java API Doc Glassfish v2 API 4256 Fri May 04 22:32:54 BST 2007 com.sun.ejb

MessageBeanProtocolManager

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

Fields Summary
Constructors Summary
Methods Summary
public MessageBeanListener createMessageBeanListener(com.sun.enterprise.resource.ResourceHandle resourceHandle)
Create a MessageBeanListener.
param
resource handle associated with this listener. can be null.
throws
Exception if the MessageBeanContainer was not able to create the MessageBeanListener
public 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.
public com.sun.enterprise.deployment.runtime.BeanPoolDescriptor getPoolDescriptor()
Returns the message-bean container's pool properties.
public boolean isDeliveryTransacted(java.lang.reflect.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.
param
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.