XAConnection

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS (src) NEXT CLASS (src)

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.jms
Interface XAConnection

All Superinterfaces:: Connection (src)

All Known Subinterfaces:: XAQueueConnection (src) , XATopicConnection (src)

All Known Implementing Classes:: JBossConnection (src) , SpyXAConnection (src)

public interface XAConnection
extends Connection (src)

The XAConnection interface extends the capability of Connection by providing an XASession (optional).

The XAConnection interface is optional. JMS providers are not required to support this interface. This interface is for use by JMS 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.

See Also:: XAQueueConnection (src) , XATopicConnection (src)

Method Summary
`Session (src)`	`createSession(boolean transacted, int acknowledgeMode)` Creates an `Session` object.
`XASession (src)`	`createXASession()` Creates an `XASession` object.

Methods inherited from interface javax.jms.Connection (src)

close, createConnectionConsumer, createDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Method Detail

createXASession

public XASession (src)  createXASession()
                          throws JMSException (src)

Creates an XASession object.

Returns:: a newly created XASession
Throws:: JMSException (src) - if the XAConnection object fails to create an XASession due to some internal error.
Since:: 1.1

createSession

public Session (src)  createSession(boolean transacted,
                             int acknowledgeMode)
                      throws JMSException (src)

Creates an Session object.

Specified by:: createSession in interface Connection (src)

Parameters:: transacted - usage undefined; acknowledgeMode - usage undefined
Returns:: a Session object
Throws:: JMSException (src) - if the XAConnection object fails to create an Session due to some internal error.
Since:: 1.1
See Also:: Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE