パッケージ jakarta.jms

インターフェース XATopicConnectionFactory

すべてのスーパーインターフェース:
ConnectionFactoryTopicConnectionFactoryXAConnectionFactory

public interface XATopicConnectionFactory extends XAConnectionFactory, TopicConnectionFactory
XATopicConnectionFactory は、TopicConnectionFactory と同じ作成オプションを提供します(オプション)。

XATopicConnectionFactory インターフェースはオプションです。Jakarta Messaging プロバイダーは、このインターフェースをサポートする必要はありません。このインターフェースは、トランザクション環境をサポートするために Jakarta Messaging プロバイダーが使用するためのものです。クライアントプログラムでは、これらの XA インターフェースを直接使用するのではなく、環境で利用可能なトランザクションサポートを使用することを強くお勧めします。

導入:
JMS 1.0
バージョン:
Jakarta Messaging 2.0
関連事項:
  • メソッドの詳細

    • createXATopicConnection

      XATopicConnection createXATopicConnection() throws JMSException
      デフォルトのユーザー ID で XA トピック接続を作成します。接続は停止モードで作成されます。Connection.start メソッドが明示的に呼び出されるまで、メッセージは配信されません。
      戻り値:
      新しく作成された XA トピック接続
      例外:
      JMSException - 内部エラーが原因で Jakarta Messaging プロバイダーが XA トピック接続の作成に失敗した場合
      JMSSecurityException - 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。
    • createXATopicConnection

      XATopicConnection createXATopicConnection(StringSE userName, StringSE password) throws JMSException
      指定されたユーザー ID で XA トピック接続を作成します。接続は停止モードで作成されます。Connection.start メソッドが明示的に呼び出されるまで、メッセージは配信されません。
      パラメーター:
      userName - 呼び出し元のユーザー名
      password - 呼び出し元のパスワード
      戻り値:
      新しく作成された XA トピック接続
      例外:
      JMSException - 内部エラーが原因で Jakarta Messaging プロバイダーが XA トピック接続の作成に失敗した場合
      JMSSecurityException - 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。