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, unsubscribeJMSContext getContext()
XAJMSContext に関連付けられた JMSContext オブジェクトを返します。XAJMSContext に関連付けられた JMSContext オブジェクト XAResourceSE getXAResource()
XAResource を返します。XAResourceboolean 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.