Message Queue, v4.5.1 API Specification

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

See Also:
Message

Method Summary
 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()

Message Queue, v4.5.1 API Specification

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