com.sssw.jms.api
Interface JMQSession

All Superinterfaces:

Runnable, Session

public interface JMQSession

extends Session

A JMQSession defines additional message acknowledgement modes and supports a factory method for creating XML and SOAP messages.

Since:

jBroker MQ 2.0

See Also:

Session

Field Summary

static int

INDIVIDUAL_ACKNOWLEDGE With this acknowledgement mode, the client acknowledges a message by calling a message's acknowledge method.

Fields inherited from interface javax.jms.Session

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE

Method Summary

JMQFileMessage	createFileMessage() Creates a JMQFileMessage object.
JMQSOAPMessage	createSOAPMessage() Creates a JMQSOAPMessage object.
JMQXMLMessage	createXMLMessage() Creates a JMQXMLMessage object.

Methods inherited from interface javax.jms.Session

close, commit, createBytesMessage, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createStreamMessage, createTextMessage, createTextMessage, getMessageListener, getTransacted, recover, rollback, run, setMessageListener

Field Detail

INDIVIDUAL_ACKNOWLEDGE

public static final int INDIVIDUAL_ACKNOWLEDGE

With this acknowledgement mode, the client acknowledges a message by calling a message's acknowledge method. Only the message for which the acknowledge method is called will be affected. This mode allows consumers to consume individual messages from a destination.

Using this acknowledgement mode requires extra care in the consumer to prevent un-acknowledged messages from exhausting resources in the JMS provider. The consumer may for instance recover the session once in a while to check for any un-acknowledged messages.

See Also:

Constant Field Values

Method Detail

createXMLMessage

public JMQXMLMessage createXMLMessage()
                               throws JMSException

Creates a JMQXMLMessage object. A JMQXMLMessage object is used to send a message containing a org.w3c.dom.Document object.

Returns:

a writeable JMQXMLMessage object

Throws:

JMSException - if the JMS provider fails to create this message due to some internal error

createSOAPMessage

public JMQSOAPMessage createSOAPMessage()
                                 throws JMSException

Creates a JMQSOAPMessage object. A JMQSOAPMessage object is used to send a message containing a javax.xml.soap.SOAPMessage object.

Returns:

a writeable JMQSOAPMessage object

Throws:

JMSException - if the JMS provider fails to create this message due to some internal error

createFileMessage

public JMQFileMessage createFileMessage()
                                 throws JMSException

Creates a JMQFileMessage object. A JMQFileMessage object is used to send a message containing one or more files (java.io.File objects).

Returns:

a writeable JMQFileMessage object

Throws:

JMSException - if the JMS provider fails to create this message due to some internal error

Since:

jBroker MQ 2.1