Package 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
All Methods Instance Methods Abstract Methods Modifier and Type Method 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 MessageBeanListenerResourcesExceededException
-
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 jakarta.jms.MessageListener. Note that if themethod
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.
-
-