public QABinaryMessageQABinaryMessage オブジェクトは、未解釈のバイト・ストリームが含まれるメッセージの送信に使用します。
これは QAMessage クラスを継承したもので、メッセージ本文にバイト・ストリームが追加されます。QABinaryMessage には、メッセージ本文からのバイト・ストリームの読み込み／書き込みを行うためのさまざまなメソッドがあります。
メッセージが最初に作成された時点では、メッセージ本文は書き込み専用になっています。メッセージ送信元のクライアントは、メッセージを送信した後、そのメッセージを保持し変更できます。ただし、それによって、送信されたメッセージが変更されることはありません。同じメッセージ・オブジェクトを複数回送信できます。
メッセージが受信された時点でプロバイダは reset メソッドを呼び出します。これによりメッセージ本文が読み込み専用モードになり、メッセージ本文の先頭から値の読み込みが開始されます。クライアントが読み込み専用モードのメッセージに書き込もうとすると、COMMON_MSG_NOT_WRITEABLE_ERROR が設定されます。
次の例では writeString メソッドを使用して、QABinaryMessage インスタンスのメッセージ本文に文字列 "Q" と "Anywhere" を書き込みます。
// Create a binary message instance.
QABinaryMessage * binary_message;
binary_message = qa_manager->createBinaryMessage();
// Set optional message properties.
binary_message->setReplyToAddress("my-queue-name");
// Write to the message body.
binary_message->writeString("Q");
binary_message->writeString("Anywhere");
// Put the message in the local database, ready for sending.
if (!qa_manager->putMessage("store-id\\queue-name", msg)) {
handleError();
} |
受信が終了すると、最初の readString の呼び出しから "Q" が返され、2 番目の readString の呼び出しから "Anywhere" が返されます。
メッセージは QAnywhere Agent から送信されます。
詳細については、クライアントにメッセージを転送するタイミングの決定とQAnywhere クライアント・アプリケーションの作成を参照してください。
QABinaryMessage のすべてのメンバ (継承されたメンバも含みます) を以下に示します。
getBodyLength 関数
readBinary 関数
readBoolean 関数
readByte 関数
readChar 関数
readDouble 関数
readFloat 関数
readInt 関数
readLong 関数
readShort 関数
readString 関数
reset 関数
writeBinary 関数
writeBoolean 関数
writeByte 関数
writeChar 関数
writeDouble 関数
writeFloat 関数
writeInt 関数
writeLong 関数
writeShort 関数
writeString 関数
~QABinaryMessage 関数
| Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |