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. |
Methods inherited from interface javax.jms.Session |
close, commit, createBytesMessage, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createStreamMessage, createTextMessage, createTextMessage, getMessageListener, getTransacted, recover, rollback, run, setMessageListener |
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.
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
jBroker is a registered trademark of Novell, Inc.
Copyright 1998-2003 Novell, Inc. All Rights Reserved.