QABinaryMessage-Schnittstelle

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

Syntax

public interface QABinaryMessage

Mitglieder

Alle Mitglieder der QABinaryMessage-Schnittstelle, einschließlich aller geerbten Mitglieder.

Name	Beschreibung
clearProperties-Methode	Löscht alle Eigenschaften der Nachricht
getAddress-Methode	Gibt die Zieladresse für die QAMessage-Instanz zurück.
getBodyLength-Methode	Gibt die Größe des Nachrichtenhauptteils in Byte zurück
getBooleanProperty-Methode	Ruft eine boolesche Nachrichteneigenschaft ab.
getByteProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ byte (mit Vorzeichen) ab.
getDoubleProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ double ab.
getExpiration-Methode	Gibt entweder den Ablaufwert der Nachricht zurück oder NULL, wenn die Nachricht nicht abläuft oder nicht gesendet wurde.
getFloatProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ float ab.
getInReplyToID-Methode	Gibt die Nachrichten-ID der Nachricht zurück, für die diese Nachricht als Antwort gesendet wird
getIntProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ int ab.
getLongProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ long ab.
getMessageID-Methode	Gibt die global eindeutige Nachrichten-ID der Nachricht zurück.
getPriority-Methode	Gibt die Priorität der Nachricht (von 0 bis 9) zurück
getProperty-Methode	Ruft eine Nachrichteneigenschaft ab.
getPropertyNames-Methode	Ruft einen Enumerator über die Eigenschaftsnamen der Nachricht ab.
getPropertyType-Methode	Gibt den Eigenschaftstyp der angegebenen Eigenschaft zurück.
getRedelivered-Methode	Gibt an, ob die Nachricht vorher empfangen, aber nicht quittiert wurde.
getReplyToAddress-Methode	Gibt die Rückantwortadresse dieser Nachricht zurück
getShortProperty-Methode	Ruft eine Nachrichteneigenschaft vom Typ short ab.
getStringProperty-Methode	Ruft eine Zeichenfolge-Nachrichteneigenschaft ab
getTimestamp-Methode	Gibt den Nachrichtenzeitstempel zurück, d.h. den Zeitpunkt, zu dem die Nachricht erstellt wurde
propertyExists-Methode	Gibt an, ob die angegebene Eigenschaft für diese Nachricht definiert wurde.
readBinary-Methode	Liest eine Anzahl von Bytes aus dem ungelesenen Abschnitt eines QABinaryMessage-Instanzenhauptteils und speichert sie im Array "dest".
readBoolean-Methode	Liest einen Wert vom Typ boolean beginnend mit dem nicht gelesenen Teil des Nachrichtenhauptteils der QABinaryMessage-Instanz
readByte-Methode	Liest einen Wert vom Typ byte beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readChar-Methode	Liest einen Zeichenwert beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readDouble-Methode	Liest einen double-Wert beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readFloat-Methode	Liest einen Wert vom Typ float beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readInt-Methode	Liest einen Wert vom Typ int beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readLong-Methode	Liest einen Wert vom Typ long beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readShort-Methode	Liest einen Wert vom Typ short beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
readString-Methode	Liest einen Wert vom Typ String beginnend mit dem nicht gelesenen Teil eines QABinaryMessage-Nachrichtenhauptteils ein
reset-Methode	Setzt eine Nachricht zurück, sodass das Lesen der Werte am Beginn des Nachrichtenhauptteils beginnt
setBooleanProperty-Methode	Legt einen Eigenschaftswert vom Typ boolean fest.
setByteProperty-Methode	Legt einen Eigenschaftswert vom Typ byte (mit Vorzeichen) fest.
setDoubleProperty-Methode	Legt einen Eigenschaftswert vom Typ double fest.
setFloatProperty-Methode	Legt einen Eigenschaftswert vom Typ float fest.
setInReplyToID-Methode	Legt die Rückantwort-ID fest, die die Nachricht definiert, auf die diese Nachricht antwortet
setIntProperty-Methode	Legt einen Eigenschaftswert vom Typ int fest.
setLongProperty-Methode	Legt einen Eigenschaftswert vom Typ long fest.
setPriority-Methode	Legt die Priorität der Nachricht (von 0 bis 9) fest
setProperty-Methode	Legt eine Eigenschaft fest.
setReplyToAddress-Methode	Stellt die Rückantwortadresse ein
setShortProperty-Methode	Legt einen Eigenschaftswert vom Typ short fest.
setStringProperty-Methode	Legt einen Eigenschaftswert vom Typ String fest.
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 Wert vom Typ byte 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-Restzeitwert

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

Wenn eine Nachricht erstmals erstellt wird, ist der Hauptteil der Nachricht im Nur-Schreiben-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 QABinaryMessage.reset() aufgerufen, damit der Nachrichtenhauptteil in den schreibgeschützten Modus gesetzt wird und das Lesen der Werte ab Beginn des Nachrichtenhauptteils beginnt.

Im folgenden Beispiel werden mit Hilfe der QABinaryMessage.writeString(String) 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.
try {
    qa_manager.putMessage( "store-id\\queue-name", binary_message );
}
catch ( QAException e ) {
    handleError();
}

Hinweis

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.

Siehe auch

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.