public interface XAJMSContext extends JMSContext
XAJMSContext
インターフェースは、Jakarta Messaging プロバイダーの Java Transaction API(JTA)(オプション)のサポートへのアクセスを追加することにより、JMSContext
の機能を継承します。このサポートは、javax.transaction.xa.XAResource
オブジェクトの形式を取ります。このオブジェクトの機能は、標準の X/Open XA Resource インターフェースで定義されている機能とよく似ています。 アプリケーションサーバーは、XAResource
を取得することにより、XASession
のトランザクション割り当てを制御します。XAResource
を使用して、セッションをトランザクションに割り当てたり、トランザクションの作業を準備してコミットしたりします。
XAResource
は、複数のトランザクションで作業をインターリーブしたり、進行中のトランザクションのリストを回復したりするためのかなり洗練された機能を提供します。JTA 対応の Jakarta Messaging プロバイダーは、この機能を完全に実装する必要があります。これは、XA をサポートするデータベースのサービスを使用して行うことができます。または、Jakarta Messaging プロバイダーは、この機能を最初から実装することを選択できます。
アプリケーションサーバーのクライアントには、通常の JMSContext
であると思われるものが与えられます。背後では、アプリケーションサーバーが基になる XAJMSContext
のトランザクション管理を制御します。
XAJMSContext
インターフェースはオプションです。Jakarta Messaging プロバイダーは、このインターフェースをサポートする必要はありません。このインターフェースは、トランザクション環境をサポートするために Jakarta Messaging プロバイダーが使用するためのものです。クライアントプログラムでは、これらの XA インターフェースを直接使用するのではなく、環境で利用可能なトランザクションサポートを使用することを強くお勧めします。
AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED
修飾子と型 | メソッドと説明 |
---|---|
void | commit() XAJMSContext オブジェクトに対して呼び出されるべきではないため、TransactionInProgressRuntimeException をスローします。 |
JMSContext | getContext() この XAJMSContext に関連付けられた JMSContext オブジェクトを返します。 |
boolean | getTransacted() セッションがトランザクションモードかどうかを返します。このメソッドは常に true を返します。 |
XAResourceSE | getXAResource() 呼び出し元に XAResource を返します。 |
void | rollback() XAJMSContext オブジェクトに対して呼び出されるべきではないため、TransactionInProgressRuntimeException をスローします。 |
acknowledge, close, createBrowser, createBrowser, createBytesMessage, createConsumer, createConsumer, createConsumer, createContext, createDurableConsumer, createDurableConsumer, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createProducer, createQueue, createSharedConsumer, createSharedConsumer, createSharedDurableConsumer, createSharedDurableConsumer, createStreamMessage, createTemporaryQueue, createTemporaryTopic, createTextMessage, createTextMessage, createTopic, getAutoStart, getClientID, getExceptionListener, getMetaData, getSessionMode, recover, setAutoStart, setClientID, setExceptionListener, start, stop, unsubscribe
JMSContext getContext()
XAJMSContext
に関連付けられた JMSContext
オブジェクトを返します。XAJMSContext
に関連付けられた JMSContext
オブジェクト XAResourceSE getXAResource()
XAResource
を返します。XAResource
boolean getTransacted()
JMSContext
の getTransacted
void commit()
XAJMSContext
オブジェクトに対して呼び出されるべきではないため、TransactionInProgressRuntimeException
をスローします。JMSContext
の commit
TransactionInProgressRuntimeException
- メソッドが XAJMSContext
で呼び出された場合。void rollback()
XAJMSContext
オブジェクトに対して呼び出されるべきではないため、TransactionInProgressRuntimeException
をスローします。JMSContext
の rollback
TransactionInProgressRuntimeException
- メソッドが XAJMSContext
で呼び出された場合。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.