7.4.9 QueueConnectionFactory（ConnectionFactory）インタフェース
QueueConnectionFactory（ConnectionFactory）インタフェースは，QueueConnectionオブジェクトを生成するためのファクトリです。JNDIに登録されているQueueConnectionFactoryのJNDI登録名をアプリケーションがlookupすることによってQueueConnectionFactoryオブジェクトを取得します。
- 〈この項の構成〉
(1) キューコネクションの生成
createQueueConnection()メソッドを発行することによってQueueConnectionオブジェクトを生成します。
(2) 形式
public interface ConnectionFactory
{ }
public interface QueueConnectionFactory
extends ConnectionFactory
{
public QueueConnection
createQueueConnection() throws JMSException;
public QueueConnection
createQueueConnection(java.lang.String userName,
java.lang.String password) throws JMSException;
}
(3) フィールド
ありません。
(4) メソッド
「(2) 形式」に記載した順序で各メソッドを説明します。
(a) createQueueConnectionメソッド
public QueueConnection createQueueConnection() throws JMSException
キューコネクションを作成します。QueueConnection.start()メソッドが明示的に発行されるまで，メッセージは配送されません。
-
引数
ありません。
-
戻り値
新規に作成されたキューコネクション。
-
例外
例外クラス
説明
JMSException
内部エラーのためにJMSプロバイダがキューコネクションの作成に失敗しました。
JMSSecurityException
無効なユーザ名またはパスワードが指定されたために，JMSクライアント認証が失敗しました。
例外クラスには障害コードと障害情報が設定されます。障害コードと対処については，「7.9 障害コードの詳細」を参照してください。
(b) createQueueConnectionメソッド
public QueueConnection createQueueConnection( java.lang.String userName, java.lang.String password) throws JMSException
デフォルトのユーザ識別情報を使用してキューコネクションを作成します。QueueConnection.start()メソッドが明示的に発行されるまで，メッセージは配送されません。
-
引数
引数名
説明
userName
呼び出し側のユーザ名
password
呼び出し側のパスワード
-
戻り値
新規に作成されたキューコネクション。
-
例外
例外クラス
説明
JMSException
内部エラーのためにJMSプロバイダがキューコネクションの作成に失敗しました。
JMSSecurityException
無効なユーザ名またはパスワードが指定されたために，JMSクライアント認証が失敗しました。
例外クラスには障害コードと障害情報が設定されます。障害コードと対処については，「7.9 障害コードの詳細」を参照してください。