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

IConnection

Connection オブジェクトは、アプリケーションによるブローカーへのアクティブな接続を表します。

継承の階層:
IBM.XMS.IPropertyContext
|
+----IBM.XMS.IConnection

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

.NET プロパティー

.NET プロパティーの要約:
.NET プロパティー 説明
ClientID 接続のクライアント ID を取得および設定します。
ExceptionListener 接続に登録されている例外リスナーを取得し、例外リスナーを接続に登録します。
MetaData 接続のメタデータを取得します。

ClientID – クライアント ID の取得および設定

インターフェース:
String ClientID
{
get;
set;
}

接続のクライアント ID を取得および設定します。

クライアント ID は、管理者が ConnectionFactory で事前に構成するか、ClientID を設定することにより割り当てることができます。

クライアント ID は、パブリッシュ/サブスクライブ・ドメイン内の永続サブスクリプションをサポートするためだけに使用され、Point-to-Point ドメインでは無視されます。

アプリケーションが接続のクライアント ID を設定する場合、アプリケーションは、接続の作成の直後に、接続で他の操作を実行する前にこの設定を行う必要があります。アプリケーションが、この時点よりも後に、このクライアント ID の設定を試行すると、呼び出しは例外 IllegalStateException をスローします。

ブローカーへのリアルタイム接続の場合、このプロパティーは無効です。

例外:
  • XMSException
  • IllegalStateException
  • InvalidClientIDException

ExceptionListener – 例外リスナーの取得および設定

インターフェース:
ExceptionListener ExceptionListener
{
get;
set;
}

接続に登録されている例外リスナーを取得し、例外リスナーを接続に登録します。

接続に例外リスナーが登録されていない場合、このメソッドでは NULL が戻されます。接続に例外リスナーが既に登録されている場合は、この例外リスナーの代わりに NULL を指定すれば、登録を取り消すことができます。

例外リスナーの使用について詳しくは、.NET でのメッセージ・リスナーおよび例外リスナーの使用法を参照してください。

例外:
  • XMSException

MetaData – メタデータの取得

インターフェース:
IConnectionMetaData MetaData
{
get;
}

接続のメタデータを取得します。

例外:
  • XMSException

メソッド

メソッドの要約:
メソッド 説明
Close 接続を閉じます。
CreateSession セッションを作成します。
Start 接続の着信メッセージの配信を開始または再開します。
Stop 接続の着信メッセージの配信を停止します。

Close – 接続のクローズ

インターフェース:
void Close();

接続を閉じます。

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

パラメーター:
なし
戻り値:
Void
例外:
  • XMSException

CreateSession – セッションの作成

インターフェース:
ISession CreateSession(Boolean transacted,
AcknowledgeMode acknowledgeMode);

セッションを作成します。

パラメーター:
transacted (入力)
True は、セッションが処理済みであることを意味します。値 False は、セッションが処理されていないことを意味します。

ブローカーへのリアルタイム接続の場合、値は False である必要があります。

acknowledgeMode (入力)
アプリケーションが受信するメッセージが応答される方法を示します。値は、以下の AcknowledgeMode 列挙子のいずれかにする必要があります。
  • AcknowledgeMode.AutoAcknowledge
  • AcknowledgeMode.ClientAcknowledge
  • AcknowledgeMode.DupsOkAcknowledge
ブローカーへのリアルタイム接続の場合、値は AcknowledgeMode.AutoAcknowledge または AcknowledgeMode.DupsOkAcknowledge である必要があります。

セッションが処理済みの場合、このパラメーターは無視されます。肯定応答モードについて詳しくは、セッションでのメッセージの受信の確認を参照してください。

戻り値:
Session オブジェクト。
例外:
  • XMSException

Start – 接続の開始

インターフェース:
void Start();

接続の着信メッセージの配信を開始または再開します。接続が既に開始されている場合、呼び出しは無視されます。

パラメーター:
なし
戻り値:
Void
例外:
  • XMSException

Stop – 接続の停止

インターフェース:
void Stop();

接続の着信メッセージの配信を停止します。接続が既に停止されている場合、呼び出しは無視されます。

パラメーター:
なし
戻り値:
Void
例外:
  • XMSException

継承されたプロパティーおよびメソッド


Reference topic

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

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