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

マップ・メッセージ

マップ・メッセージの本文には、名前値のペアが 1 組含まれており、それぞれの値には関連付けられたデータ型があります。

それぞれの名前値ペアにおいて、名前は値を識別するストリングであり、その値は、表 1 にリストされている XMS データ型のいずれか 1 つを持つアプリケーション・データのエレメントです。名前値ペアの順序は定義されていません。MapMessage クラスには、名前値ペアを設定および取得するメソッドが含まれています。

アプリケーションは、その名前を指定することによって名前値ペアにランダムにアクセスできます。別の方法として、C または C++ アプリケーションでは、イテレーターを使用して名前値ペアに順番にアクセスすることもできます。アプリケーションは、MapMessage クラスの Get Name-Value Pairs メソッドを呼び出して、Property オブジェクトのリストをカプセル化するイテレーターを作成できます。そのイテレーターで、各 Property オブジェクトは名前値ペアをカプセル化します。次にアプリケーションは、Iterator クラスのメソッドを使用して各 Property オブジェクトを順番に取得してから、Property クラスのメソッドを使用して各名前値ペアの名前、データ型、および値を取得します。名前値ペアはプロパティーではありませんが、Property クラスのメソッドは名前値ペアをプロパティーのように扱います。

.NETアプリケーションは、Get Map Names .NET プロパティーを使用して、マップ・メッセージの本文にある名前の列挙を取得できます。

アプリケーションが名前と値のペアの値を取得する場合、その値は XMS によって別のデータ型に変換できます。例えば、マップ・メッセージの本文から整数を取得するため、アプリケーションは MapMessage クラスの Get String メソッドを呼び出すことができ、これにより整数がストリングとして戻されます。サポートされる型変換は、XMS によってプロパティーの値が 1 つのデータ型から別のデータ型に変換される場合にサポートされる型変換と同じです。したがって、サポートされる型変換について詳しくは、プロパティー値のデータ型の暗黙的な変換を参照してください。

アプリケーションがマップ・メッセージを作成した後のメッセージの本文は、読み取り可能と書き込み可能です。本文は、アプリケーションがメッセージを送信した後も、読み取り可能と書き込み可能の状態のままになります。アプリケーションがマップ・メッセージを受信するときのメッセージの本文は、読み取り専用です。マップ・メッセージの本文が読み取り専用のときに、アプリケーションが Message クラスの Clear Body メソッドを呼び出すと、本文は読み取り可能と書き込み可能になります。このメソッドにより、本文もクリアされます。

関連概念
プロパティー値のデータ型の暗黙的な変換
関連資料
バイト・メッセージ
オブジェクト・メッセージ
ストリーム・メッセージ
テキスト・メッセージ
MapMessage (for the C class)
MapMessage (for the C++ class)
IMapMessage (for the .NET interface)

Reference topic

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

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