QABinaryMessage-Klasse

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

Syntax

public class QABinaryMessage : QAMessage

Mitglieder

Alle Mitglieder der Klasse QABinaryMessage, einschließlich aller geerbten Mitglieder.

Name	Beschreibung
QABinaryMessage-Dekonstruktor	Virtueller Destruktor.
beginEnumPropertyNames-Methode	Beginnt eine Enumeration von Nachrichteneigenschaftsnamen.
castToBinaryMessage-Methode	Wandelt QAMessage in QABinaryMessage um.
castToTextMessage-Methode	Wandelt QAMessage in QATextMessage um.
clearProperties-Methode	Löscht die Eigenschaften einer Nachricht.
endEnumPropertyNames-Methode	Gibt die Ressourcen frei, die mit der Enumeration von Eigenschaftsnamen für Nachrichten verbunden sind.
getAddress-Methode	Ruft die Zieladresse für die QAMessage-Instanz ab.
getBodyLength-Methode	Gibt die Größe des Nachrichtenhauptteils in Byte zurück.
getBooleanProperty-Methode	Ruft den Wert der qa_bool-Eigenschaft mit dem angegebenen Namen ab.
getByteProperty-Methode	Ruft den Wert der qa_byte-Eigenschaft mit dem angegebenen Namen ab.
getDoubleProperty-Methode	Ruft den Wert der qa_double-Eigenschaft mit dem angegebenen Namen ab.
getExpiration-Methode	Ruft die Ablaufzeit der Nachricht ab.
getFloatProperty-Methode	Ruft den Wert der qa_float-Eigenschaft mit dem angegebenen Namen ab.
getInReplyToID-Methode	Ruft die ID der Nachricht ab, die diese Nachricht beantwortet.
getIntProperty-Methode	Ruft den Wert der qa_int-Eigenschaft mit dem angegebenen Namen ab.
getLongProperty-Methode	Ruft den Wert der qa_long-Eigenschaft mit dem angegebenen Namen ab.
getMessageID-Methode	die Nachricht-ID.
getPriority-Methode	Ruft die Prioritätsstufe einer Nachricht ab.
getPropertyType-Methode	Gibt den Typ einer Eigenschaft mit dem angegebenen Namen zurück.
getRedelivered-Methode	Gibt an, ob die Nachricht vorher empfangen, aber nicht quittiert wurde.
getReplyToAddress-Methode	Ruft die Adresse ab, an die eine Antwort auf diese Nachricht gesendet werden soll.
getShortProperty-Methode	Ruft den Wert der qa_short-Eigenschaft mit dem angegebenen Namen ab.
getStringProperty-Methode	Ruft den Wert der qa_string-Eigenschaft mit dem angegebenen Namen ab.
getTimestamp-Methode	Ruft den Nachrichtenzeitstempel ab.
getTimestampAsString-Methode	Ruft den Nachrichtenzeitstempel als formatierte Zeichenfolge ab.
nextPropertyName-Methode	Gibt den Nachrichteneigenschaftsnamen für die gegebene Enumeration zurück und -1, wenn keine weiteren Eigenschaftsnamen mehr vorhanden sind.
propertyExists-Methode	Zeigt an, ob ein Eigenschaftswert existiert.
readBinary-Methode	Liest eine festgelegte Anzahl von Bytes beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils einer QABinaryMessage-Instanz.
readBoolean-Methode	Liest einen Wert vom Typ boolean beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readByte-Methode	Liest einen 8-Bit-Wert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readChar-Methode	Liest einen Zeichenwert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readDouble-Methode	Liest einen double-Wert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readFloat-Methode	Liest einen Gleitkommawert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readInt-Methode	Liest einen 32-Bit-Ganzzahlwert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readLong-Methode	Liest einen 64-Bit-Ganzzahlwert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readShort-Methode	Liest einen 16-Bit-Wert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
readString-Methode	Liest einen Zeichenfolgenwert beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz.
reset-Methode	Setzt eine Nachricht zurück, sodass das Lesen der Werte am Beginn des Nachrichtenhauptteils beginnt.
setAddress-Methode	Stellt die Zieladresse für diese Nachricht ein.
setBooleanProperty-Methode	Legt die qa_bool-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setByteProperty-Methode	Legt die qa_byte-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setDoubleProperty-Methode	Legt die qa_double-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setFloatProperty-Methode	Legt die qa_float-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setInReplyToID-Methode	Stellt die In-Reply-To-ID für die Nachricht ein.
setIntProperty-Methode	Legt die qa_int-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setLongProperty-Methode	Legt die qa_long-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setMessageID-Methode	Legt die Nachricht-ID fest.
setPriority-Methode	Stellt die Prioritätsstufe für diese Nachricht ein.
setRedelivered-Methode	Setzt einen Hinweis, ob die Nachricht erneut zugestellt wurde.
setReplyToAddress-Methode	Stellt die Adresse ein, an die eine Antwort auf diese Nachricht gesendet werden soll.
setShortProperty-Methode	Legt die qa_short-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setStringProperty-Methode	Legt die qa_string-Eigenschaft mit dem angegebenen Namen auf den angegebenen Wert fest.
setTimestamp-Methode	Stellt den Nachrichtenzeitstempel ein.
writeBinary-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen Byte-Array-Wert an
writeBoolean-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen Wert vom Typ boolean an.
writeByte-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen Bytewert an.
writeChar-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen char-Wert an.
writeDouble-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen double-Wert an.
writeFloat-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen float-Wert an.
writeInt-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen int-Wert an.
writeLong-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen long-Wert an.
writeShort-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen short-Wert an.
writeString-Methode	Hängt dem Nachrichtenhauptteil einer QABinaryMessage-Instanz einen String-Wert an.
DEFAULT_PRIORITY-Variable	Die Standard-Nachrichtenpriorität.
DEFAULT_TIME_TO_LIVE-Variable	Der Standard-Nachrichtenrestzeitwert.

Bemerkungen

QABinaryMessage 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 Methode QABinaryMessage::reset 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.

Beispiel

Im folgenden Beispiel werden mithilfe der Methode QABinaryMessage::writeString 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 QABinaryMessage::readString() "Q" zurück, der nächste Aufruf von QABinaryMessage::readString() gibt "Anywhere" zurück.

Die Nachricht wird vom QAnywhere Agent gesendet.

Weitere Hinweise finden Sie unter Zeitpunkt der Nachrichtenübermittlung auf dem Client festlegen und Schreiben von QAnywhere-Clientanwendungen.

QABinaryMessage-Dekonstruktor
getBodyLength-Methode
readBinary-Methode
readBoolean-Methode
readByte-Methode
readChar-Methode
readDouble-Methode
readFloat-Methode
readInt-Methode
readLong-Methode
readShort-Methode
readString-Methode
reset-Methode
writeBinary-Methode
writeBoolean-Methode
writeByte-Methode
writeChar-Methode
writeDouble-Methode
writeFloat-Methode
writeInt-Methode
writeLong-Methode
writeShort-Methode
writeString-Methode

Kommentieren Sie diese Seite in DocCommentXchange.