public class QABinaryMessage : QAMessage

• QAMessage クラス [QAnywhere C++]

継承されたメンバーを含む QABinaryMessage クラスのすべてのメンバー。

これは QAMessage クラスを継承したもので、メッセージ本文にバイトストリームが追加されます。QABinaryMessage には、メッセージ本文からのバイトストリームの読み込み／書き込みを行うためのさまざまなメソッドがあります。

メッセージが最初に作成された時点では、メッセージ本文は書き込み専用になっています。メッセージ送信元のクライアントは、メッセージを送信した後、そのメッセージを保持し変更できます。ただし、それによって、送信されたメッセージが変更されることはありません。同じメッセージオブジェクトを複数回送信できます。

メッセージが受信された時点でプロバイダーは QABinaryMessage::reset メソッドを呼び出します。これによりメッセージ本文が読み込み専用モードになり、メッセージ本文の先頭から値の読み込みが開始されます。クライアントが読み込み専用モードのメッセージに書き込もうとすると、COMMON_MSG_NOT_WRITEABLE_ERROR が設定されます。

次の例では QABinaryMessage::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();
}

受信が終了すると、最初の QABinaryMessage::readString() の呼び出しから "Q" が返され、2 番目の QABinaryMessage::readString() の呼び出しから "Anywhere" が返されます。

メッセージは QAnywhere Agent から送信されます。

詳細については、クライアントにメッセージを転送するタイミングの決定とQAnywhere クライアントアプリケーションの作成を参照してください。