-
- All Superinterfaces:
AutoCloseable
,Connection
- All Known Subinterfaces:
XAQueueConnection
,XATopicConnection
public interface XAConnection extends Connection
TheXAConnection
interface extends the capability ofConnection
by providing anXASession
(optional).The
XAConnection
interface is optional. Jakarta Messaging providers are not required to support this interface. This interface is for use by Jakarta Messaging providers to support transactional environments. Client programs are strongly encouraged to use the transactional support available in their environment, rather than use these XA interfaces directly.- Since:
- JMS 1.0
- Version:
- Jakarta Messaging 2.0
- See Also:
XAQueueConnection
,XATopicConnection
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Session
createSession(boolean transacted, int acknowledgeMode)
Creates anSession
object.XASession
createXASession()
Creates anXASession
object.-
Methods inherited from interface jakarta.jms.Connection
close, createConnectionConsumer, createDurableConnectionConsumer, createSession, createSession, createSharedConnectionConsumer, createSharedDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop
-
-
-
-
Method Detail
-
createXASession
XASession createXASession() throws JMSException
Creates anXASession
object.- Returns:
- a newly created
XASession
- Throws:
JMSException
- if theXAConnection
object fails to create anXASession
due to some internal error.- Since:
- JMS 1.1
-
createSession
Session createSession(boolean transacted, int acknowledgeMode) throws JMSException
Creates anSession
object.- Specified by:
createSession
in interfaceConnection
- Parameters:
transacted
- usage undefinedacknowledgeMode
- usage undefined- Returns:
- a newly created
Session
- Throws:
JMSException
- if theXAConnection
object fails to create aSession
due to some internal error.- Since:
- JMS 1.1
- See Also:
Session.AUTO_ACKNOWLEDGE
,Session.CLIENT_ACKNOWLEDGE
,Session.DUPS_OK_ACKNOWLEDGE
,Connection.createSession(int)
,Connection.createSession()
-
-