Syntax

public QABinaryMessage

Basisklassen

• QAMessage-Klasse

Bemerkungen

Mithilfe eines QABinaryMessage-Objekts wird eine Nachricht versendet, die einen Datenstrom von nichtinterpretierten Bytes enthält.

Es erbt von der QAMessage-Klasse und fügt einen Byte-Nachrichtenhauptteil hinzu. QABinaryMessage bietet eine Reihe von Methoden für das Lesen und Schreiben im Byte-Nachrichtenhauptteil.

Wenn eine Nachricht erstmals erstellt wird, ist der Hauptteil der Nachricht im schreibgeschützten Modus. Nachdem eine Nachricht gesendet wurde, kann sie der absendende Client einbehalten und ändern, ohne dass die gesendete Nachricht davon betroffen ist. Dasselbe Nachrichtenobjekt kann mehrfach gesendet werden.

Wenn eine Nachricht empfangen wird, hat der Provider die reset-Methode aufgerufen, damit der Nachrichtenhauptteil in den schreibgeschützten Modus gesetzt wird und das Lesen der Werte ab Beginn des Nachrichtenhauptteils beginnt. Wenn ein Client versucht, eine Nachricht im schreibgeschützten Modus zu schreiben, wird der Fehler COMMON_MSG_NOT_WRITEABLE_ERROR gesetzt.

Im folgenden Beispiel werden mithilfe der writeString-Methode die Zeichenfolgen "Q" und "Anywhere" in den Nachrichtenhauptteil einer QABinaryMessage-Instanz geschrieben.

 // 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();
     }
 

Auf der Empfängerseite gibt der erste Aufruf von readString "Q" zurück, der nächste Aufruf von readString gibt "Anywhere" zurück.

Die Nachricht wird vom QAnywhere Agent gesendet.

Weitere Hinweise finden Sie unter Festlegen, wann eine Nachrichtenübermittlung auf dem Client durchgeführt werden soll und QAnywhere-Clientanwendungen schreiben.

Mitglieder

Alle Mitglieder von QABinaryMessage, einschließlich aller geerbten Mitglieder

• beginEnumPropertyNames-Funktion
• castToBinaryMessage-Funktion
• castToTextMessage-Funktion
• clearProperties-Funktion
• DEFAULT_PRIORITY-Variable
• DEFAULT_TIME_TO_LIVE-Variable
• endEnumPropertyNames-Funktion
• getAddress-Funktion
• getBodyLength-Funktion
• getBooleanProperty-Funktion
• getByteProperty-Funktion
• getDoubleProperty-Funktion
• getExpiration-Funktion
• getFloatProperty-Funktion
• getInReplyToID-Funktion
• getIntProperty-Funktion
• getLongProperty-Funktion
• getMessageID-Funktion
• getPriority-Funktion
• getPropertyType-Funktion
• getRedelivered-Funktion
• getReplyToAddress-Funktion
• getShortProperty-Funktion
• getStringProperty-Funktion
• getStringProperty-Funktion
• getTimestamp-Funktion
• getTimestampAsString-Funktion
• nextPropertyName-Funktion
• propertyExists-Funktion
• readBinary-Funktion
• readBoolean-Funktion
• readByte-Funktion
• readChar-Funktion
• readDouble-Funktion
• readFloat-Funktion
• readInt-Funktion
• readLong-Funktion
• readShort-Funktion
• readString-Funktion
• reset-Funktion
• setAddress-Funktion
• setBooleanProperty-Funktion
• setByteProperty-Funktion
• setDoubleProperty-Funktion
• setFloatProperty-Funktion
• setInReplyToID-Funktion
• setIntProperty-Funktion
• setLongProperty-Funktion
• setMessageID-Funktion
• setPriority-Funktion
• setRedelivered-Funktion
• setReplyToAddress-Funktion
• setShortProperty-Funktion
• setStringProperty-Funktion
• setTimestamp-Funktion
• writeBinary-Funktion
• writeBoolean-Funktion
• writeByte-Funktion
• writeChar-Funktion
• writeDouble-Funktion
• writeFloat-Funktion
• writeInt-Funktion
• writeLong-Funktion
• writeShort-Funktion
• writeString-Funktion
• ~QABinaryMessage-Funktion