public interface XAConnectionFactory
XAConnectionFactory
インターフェースは、XAQueueConnectionFactory
および XATopicConnectionFactory
インターフェースの基本インターフェースです。 一部のアプリケーションサーバーは、JTA 対応のリソース使用を分散トランザクションにグループ化するためのサポートを提供します(オプション)。JTA トランザクションに Jakarta Messaging API トランザクションを含めるには、アプリケーションサーバーに JTA 対応の JMS プロバイダーが必要です。Jakarta Messaging プロバイダーは、アプリケーションサーバーが XAConnection
オブジェクトを作成するために使用する XAConnectionFactory
オブジェクトを使用して JTA サポートを公開します。
XAConnectionFactory
オブジェクトは、ConnectionFactory
オブジェクトと同様に、Jakarta Messaging が管理するオブジェクトです。アプリケーションサーバーは、Java Naming and Directory Interface(JNDI)API を使用して見つけることが期待されています。
XAConnectionFactory
インターフェースはオプションです。Jakarta Messaging プロバイダーは、このインターフェースをサポートする必要はありません。このインターフェースは、トランザクション環境をサポートするために Jakarta Messaging プロバイダーが使用するためのものです。クライアントプログラムでは、これらの XA インターフェースを直接使用するのではなく、環境で利用可能なトランザクションサポートを使用することを強くお勧めします。
修飾子と型 | メソッドと説明 |
---|---|
XAConnection | createXAConnection() デフォルトのユーザー ID で XAConnection を作成します。 |
XAConnection | createXAConnection(StringSE userName, StringSE password) 指定されたユーザー ID で XAConnection を作成します。 |
XAJMSContext | createXAContext() デフォルトのユーザー ID で XAJMSContext を作成します |
XAJMSContext | createXAContext(StringSE userName, StringSE password) 指定されたユーザー ID で JMSContext を作成します |
XAConnection createXAConnection() throws JMSException
XAConnection
を作成します。接続は停止モードで作成されます。Connection.start
メソッドが明示的に呼び出されるまで、メッセージは配信されません。XAConnection
JMSException
- 内部エラーが原因で Jakarta Messaging プロバイダーが XA 接続の作成に失敗した場合。JMSSecurityException
- 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。XAConnection createXAConnection(StringSE userName, StringSE password) throws JMSException
XAConnection
を作成します。接続は停止モードで作成されます。Connection.start
メソッドが明示的に呼び出されるまで、メッセージは配信されません。userName
- 呼び出し元のユーザー名 password
- 発信者のパスワード XAConnection
JMSException
- 内部エラーが原因で Jakarta Messaging プロバイダーが XA 接続の作成に失敗した場合。JMSSecurityException
- 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。XAJMSContext createXAContext()
XAJMSContext
を作成します 新しい XAJMSContext
で使用するために、接続とセッションが作成されます。接続は停止モードで作成されますが、JMSConsumer
が作成されると自動的に開始されます。
XAJMSContext
JMSRuntimeException
- 内部エラーが原因で Jakarta Messaging プロバイダーが XAJMSContext
の作成に失敗した場合。JMSSecurityRuntimeException
- 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。XAJMSContext createXAContext(StringSE userName, StringSE password)
新しい XAJMSContext
で使用するために、接続とセッションが作成されます。接続は停止モードで作成されますが、JMSConsumer
が作成されると自動的に開始されます。
userName
- 呼び出し元のユーザー名 password
- 発信者のパスワード JMSRuntimeException
- 内部エラーのために Jakarta Messaging プロバイダーが JMSContext の作成に失敗した場合 JMSSecurityRuntimeException
- 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.