Package org.glassfish.ejb.api

Interface 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

  • Method Details

    • createMessageBeanListener

      MessageBeanListener createMessageBeanListener(com.sun.appserv.connectors.internal.api.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 jakarta.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

      com.sun.enterprise.deployment.runtime.BeanPoolDescriptor getPoolDescriptor()
      Returns the message-bean container's pool properties.