com.sun.messaging.jms

## 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 Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `acknowledgeThisMessage()` Acknowledges this consumed message only.
    `void` | `acknowledgeUpThroughThisMessage()` Acknowledges consumed messages of the session up through and including this consumed message.

- - ### Method Detail

    - #### acknowledgeThisMessage

          void acknowledgeThisMessage()
                                      throws 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:
        `JMSException` - if the messages fail to get acknowledged due to an internal error.
        `IllegalStateException` - if this method is called on a closed session.
      See Also:
        `Session.CLIENT_ACKNOWLEDGE`, `javax.jms.Message.acknowledge()`, `acknowledgeUpThroughThisMessage()`

    - #### acknowledgeUpThroughThisMessage

          void acknowledgeUpThroughThisMessage()
                                               throws 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:
        `JMSException` - if the messages fail to get acknowledged due to an internal error.
        `IllegalStateException` - if this method is called on a closed session.
      See Also:
        `Session.CLIENT_ACKNOWLEDGE`, `javax.jms.Message.acknowledge()`, `acknowledgeThisMessage()`

Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.