パッケージ jakarta.jms

インターフェース XATopicConnectionFactory

  • すべてのスーパーインターフェース:
    ConnectionFactory、TopicConnectionFactory、XAConnectionFactory
    public interface XATopicConnectionFactory
extends XAConnectionFactory, TopicConnectionFactory
    XATopicConnectionFactory は、TopicConnectionFactory と同じ作成オプションを提供します（オプション）。

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

    導入:
    JMS 1.0
    バージョン:
    Jakarta Messaging 2.0
    関連事項:
    TopicConnectionFactory, XAConnectionFactory

    • メソッドの詳細

      • 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 - 無効なユーザー名またはパスワードが原因でクライアント認証が失敗した場合。