NET インターフェース

この トピック では、 について説明します。NET クラス・インターフェースとそのプロパティーおよびメソッド。

以下の表に、すべてのインターフェースの要約を示します。これらのインターフェースは、IBM.XMS ネーム・スペースの範囲内で定義されます。

表 1. の要約。NET クラス・インターフェース
インターフェース 説明
IBytesMessage バイト・メッセージとは、本体がバイトのストリームからなるメッセージです。
IConnection Connection オブジェクトは、アプリケーションからメッセージング・サーバーへのアクティブな接続を表します。
IConnectionFactory アプリケーションは、接続ファクトリーを使用して接続を作成します。
IConnectionMetaData ConnectionMetaData オブジェクトは、接続に関する情報を提供します。
IDestination 宛先とは、アプリケーションがメッセージを送信する場所、またはアプリケーションがメッセージを受信する場合の送信元、あるいはその両方のことです。
ExceptionListener アプリケーションは例外リスナーを使用して、接続の問題に関する通知を非同期に受信します。
IllegalStateException XMS は、アプリケーションが誤った時点または不適切な時点でメソッドを呼び出した場合、あるいは XMS が要求された操作に対して適切な状態にない場合に、この例外をスローします。
InitialContext アプリケーションは、InitialContext オブジェクトを使用して、管理対象オブジェクトのリポジトリーから取得したオブジェクト定義によってオブジェクトを作成します。
InvalidClientIDException XMS は、アプリケーションが接続のクライアント ID を設定しようとしたが、そのクライアント ID が無効であるか、既に使用されている場合に、この例外をスローします。
InvalidDestinationException XMS は、アプリケーションが無効な宛先を指定すると、この例外をスローします。
InvalidSelectorException XMS は、構文が無効なメッセージ・セレクター式をアプリケーションが提供すると、この例外をスローします。
IMapMessage マップ・メッセージとは、本体が名前と値のペアで構成されるメッセージです。それぞれの値に、関連付けられたデータ・タイプがあります。
IMessage メッセージ・オブジェクトは、アプリケーションが送信または受信するメッセージを表します。 IMessage は、IMapMessage などの Message クラスのスーパークラスです。
IMessageConsumer アプリケーションは、メッセージ・コンシューマーを使用して、宛先に送信されたメッセージを受信します。
MessageEOFException XMS は、アプリケーションがバイト・メッセージの本体を読み取っているときに XMS がバイト・メッセージ・ストリームの終わりを検出すると、この例外をスローします。
MessageFormatException XMS は、 XMS が無効な形式のメッセージを検出すると、この例外をスローします。
IMessageListener (代行) アプリケーションは、メッセージ・リスナーを使用して、メッセージを非同期に受信します。
MessageNotReadableException XMS は、アプリケーションが書き込み専用のメッセージの本文を読み取ろうとすると、この例外をスローします。
MessageNotWritableException XMS は、アプリケーションが読み取り専用のメッセージの本文に書き込もうとすると、この例外をスローします。
IMessageProducer アプリケーションは、メッセージ・プロデューサーを使用して、メッセージを宛先に送信します。
IObjectMessage オブジェクト・メッセージは、本体がシリアライズされた Java オブジェクトまたは .NET オブジェクトで構成されるメッセージです。
IPropertyContext IPropertyContext は、プロパティーを取得および設定するメソッドを含む抽象スーパークラスです。 これらのメソッドは、その他のクラスによって継承されます。
IQueueBrowser アプリケーションは、キュー・ブラウザーを使用して、キュー上のメッセージを参照します。その際にメッセージは除去されません。
Requestor アプリケーションはリクエスターを使用して、要求メッセージを送信し、応答を待機して受信します。
ResourceAllocationException XMS は、 XMS がメソッドに必要なリソースを割り振ることができない場合に、この例外をスローします。
SecurityException XMS は、アプリケーションを認証するために提供されたユーザー ID とパスワードが拒否されると、この例外をスローします。 また、 XMS は、権限検査が失敗し、メソッドの完了を妨げている場合にも、この例外をスローします。
ISession セッションとは、メッセージ送受信のための単一スレッドのコンテキストのことです。
IStreamMessage ストリーム・メッセージとは、本体が値のストリームで構成されるメッセージです。それぞれの値に、関連付けられたデータ・タイプがあります。
ITextMessage テキスト・メッセージとは、本体がストリングからなるメッセージです。
TransactionInProgressException XMS は、トランザクションが進行中であるために無効な操作をアプリケーションが要求すると、この例外をスローします。
TransactionRolledBackException XMS は、アプリケーションが現行トランザクションをコミットするために Session.commit() を呼び出したが、その後トランザクションがロールバックされた場合に、この例外をスローします。
XMSC の場合。NET, XMS プロパティーの名前と値は、このクラスでパブリック定数として定義されます。 詳しくは、 XMS オブジェクトのプロパティーを参照してください。
XMSException XMS が への呼び出しの処理中にエラーを検出した場合。NET メソッド、 XMS は例外をスローします。 例外とは、エラーに関する情報をカプセル化するオブジェクトのことです。

XMS 例外にはさまざまなタイプがあり、XMSException オブジェクトは例外の 1 つのタイプにすぎません。 ただし、XMSException クラスは、他の XMS 例外クラスのスーパークラスです。 XMS は、他のタイプの例外がいずれも該当しない場合に XMSException オブジェクトをスローします。
XMSFactoryFactory アプリケーションが管理対象オブジェクトを使用していない場合は、このクラスを使用して接続ファクトリー、キュー、およびトピックを作成します。

各メソッドの定義には、メソッドの呼び出しの処理中にエラーが検出された場合に XMS が戻す可能性のある例外コードがリストされています。 各例外コードは、その名前付き定数で表されますが、この定数には対応する例外があります。