パッケージ jakarta.jms

インターフェース XAQueueConnectionFactory

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

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

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

    • メソッドの詳細

      • createXAQueueConnection

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

      • createXAQueueConnection

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