WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 オペレーティング・システム: Linux, Windows

ConnectionFactory

アプリケーションは、接続ファクトリーを使用して接続を作成します。

継承の階層:
xms::PropertyContext
|
+----xms::ConnectionFactory

ConnectionFactory オブジェクトの XMS 定義プロパティーのリストについては、ConnectionFactory のプロパティーを参照してください。

関連概念
接続ファクトリーおよび接続
WebSphere サービス統合バスへの接続
関連タスク
管理対象オブジェクトの作成

コンストラクター

コンストラクターの要約:
コンストラクター 説明
ConnectionFactory デフォルトのプロパティーを使用して接続ファクトリーを作成します。

ConnectionFactory – 接続ファクトリーの作成

インターフェース:
ConnectionFactory();

デフォルトのプロパティーを使用して接続ファクトリーを作成します。

パラメーター:
なし
例外:
  • XMS_X_GENERAL_EXCEPTION

メソッド

メソッドの要約:
メソッド 説明
~ConnectionFactory 接続ファクトリーを削除します。
createConnection デフォルトのユーザー ID を使用して接続を作成します。
createConnection 指定されたユーザー ID を使用して接続を作成します。
getHandle C アプリケーションが接続ファクトリーにアクセスするときに使用するハンドルを取得します。
isNull ConnectionFactory オブジェクトがヌル・オブジェクトであるかどうかを判別します。

~ConnectionFactory – 接続ファクトリーの削除

インターフェース:
virtual ~ConnectionFactory();

接続ファクトリーを削除します。

アプリケーションが、既に削除されている接続ファクトリーを削除しようとした場合、呼び出しは無視されます。

パラメーター:
なし
例外:
  • XMS_X_GENERAL_EXCEPTION

createConnection – 接続の作成 (デフォルト・ユーザー ID を使用)

インターフェース:
Connection createConnection();

デフォルトのユーザー ID を使用して接続を作成します。

接続ファクトリーのプロパティー XMSC_USERID および XMSC_PASSWORD は、設定されている場合、アプリケーションの認証に使用されます。これらのプロパティーが設定されていない場合、メッセージング・サーバーが認証なしの接続を許可しているのであれば、アプリケーションを認証せずに接続が作成されます。アプリケーションがバインディング・モードで WebSphere MQ キュー・マネージャーに接続する場合、このプロパティーは無視されます。

接続は停止済みモードで作成されます。 アプリケーションが Connection.start() を呼び出すまで、メッセージは配信されません。

パラメーター:
なし
戻り値:
Connection オブジェクト。
例外:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

createConnection – 接続の作成 (指定されたユーザー ID を使用)

インターフェース:
Connection createConnection(const String & userID,
const String & password);

指定されたユーザー ID を使用して接続を作成します。

アプリケーションの認証に、指定したユーザー ID およびパスワードが使用されます。接続ファクトリーのプロパティー XMSC_USERID および XMSC_PASSWORD は、設定されている場合、無視されます。アプリケーションがバインディング・モードで WebSphere MQ キュー・マネージャーに接続する場合、ユーザー ID およびパスワードは無視されます。

接続は停止済みモードで作成されます。 アプリケーションが Connection.start() を呼び出すまで、メッセージは配信されません。

パラメーター:
userID (入力)
アプリケーションを認証するときに使用するユーザー ID をカプセル化している String オブジェクト。ヌルの String オブジェクトを指定する場合は、代わりに接続ファクトリー・プロパティー XMSC_USERID を使用します。
password (入力)
アプリケーションを認証するときに使用するパスワードをカプセル化している String オブジェクト。ヌルの String オブジェクトを指定する場合は、代わりに接続ファクトリー・プロパティー XMSC_PASSWORD を使用します。
戻り値:
Connection オブジェクト。
例外:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

getHandle – ハンドルの取得

インターフェース:
xmsHConnFact getHandle() const;

C アプリケーションが接続ファクトリーにアクセスするときに使用するハンドルを取得します。

パラメーター:
なし
戻り値:
接続ファクトリーのハンドル。
例外:
  • XMS_X_GENERAL_EXCEPTION

isNull – ヌルであるかどうかを検査

インターフェース:
xmsBOOL isNull() const;

ConnectionFactory オブジェクトがヌル・オブジェクトであるかどうかを判別します。

パラメーター:
なし
戻り値:
  • ConnectionFactory オブジェクトがヌル・オブジェクトの場合は、xmsTRUE
  • ConnectionFactory オブジェクトがヌル・オブジェクトでない場合は、xmsFALSE
例外:
  • XMS_X_GENERAL_EXCEPTION

継承されたメソッド


Reference topic

ご利用条件 | フィードバック (英語のみ)

Timestamp icon最終更新: 8 Jun 2006
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)