Interface Message


  • public interface Message
    The com.sun.messaging.jms.Message interface defines enhanced capabilities of a JMS Message in Oracle GlassFish(tm) Server Message Queue.

    It defines

    • Additional methods available for custom message acknowledgement behavior.
    See Also:
    Message
    • Method Detail

      • acknowledgeThisMessage

        void acknowledgeThisMessage()
                             throws jakarta.jms.JMSException
        Acknowledges this consumed message only.

        All consumed JMS messages in Oracle GlassFish(tm) Server Message Queue support the acknowledgeThisMessage method for use when a client has specified that its JMS session's consumed messages are to be explicitly acknowledged. By invoking acknowledgeThisMessage on a consumed message, a client acknowledges only the specific message that the method is invoked on.

        Calls to acknowledgeThisMessage are ignored for both transacted sessions and sessions specified to use implicit acknowledgement modes.

        Throws:
        jakarta.jms.JMSException - if the messages fail to get acknowledged due to an internal error.
        jakarta.jms.IllegalStateException - if this method is called on a closed session.
        See Also:
        Session.CLIENT_ACKNOWLEDGE, jakarta.jms.Message.acknowledge(), acknowledgeUpThroughThisMessage()
      • acknowledgeUpThroughThisMessage

        void acknowledgeUpThroughThisMessage()
                                      throws jakarta.jms.JMSException
        Acknowledges consumed messages of the session up through and including this consumed message.

        All consumed JMS messages in Oracle GlassFish(tm) Server Message Queue support the acknowledgeUpThroughThisMessage method for use when a client has specified that its JMS session's consumed messages are to be explicitly acknowledged. By invoking acknowledgeUpThroughThisMessage on a consumed message, a client acknowledges messages starting with the first unacknowledged message and ending with this message that were consumed by the session that this message was delivered to.

        Calls to acknowledgeUpThroughThisMessage are ignored for both transacted sessions and sessions specified to use implicit acknowledgement modes.

        Throws:
        jakarta.jms.JMSException - if the messages fail to get acknowledged due to an internal error.
        jakarta.jms.IllegalStateException - if this method is called on a closed session.
        See Also:
        Session.CLIENT_ACKNOWLEDGE, jakarta.jms.Message.acknowledge(), acknowledgeThisMessage()