QNetworkDatagram Class

Dokumentation der Mitgliedsfunktionen

Erzeugt ein neues QNetworkDatagram, das eine Antwort auf dieses eingehende Datagramm darstellt, und setzt die Nutzdaten auf payload. Diese Funktion ist eine sehr bequeme Art, auf ein Datagramm zurück an den ursprünglichen Absender zu antworten.

Beispiel:

    void Server::readPendingDatagrams()
    {
        while (udpSocket->hasPendingDatagrams()) {
            QNetworkDatagram datagram = udpSocket->receiveDatagram();
            QByteArray replyData = processThePayload(datagram.data());
            udpSocket->writeDatagram(datagram.makeReply(replyData));
        }
    }

Diese Funktion ist besonders praktisch, da sie automatisch Parameter aus diesem Datagramm in das neue Datagramm kopiert, wenn dies erforderlich ist:

• Absenderadresse und Port dieses Datagramms werden in die Zieladresse und den Port des neuen Datagramms kopiert;
• der Schnittstellenindex dieses Datagramms, falls vorhanden, wird in den Schnittstellenindex des neuen Datagramms kopiert;
• die Zieladresse und der Port dieses Datagramms werden nur dann auf die Absenderadresse und den Port des neuen Datagramms kopiert, wenn es sich um eine globale IPv6-Adresse (Nicht-Multicast-Adresse) handelt;
• die Hop-Count-Grenze des neuen Datagramms wird auf den Standardwert (-1) zurückgesetzt;

Wenn QNetworkDatagram in einer zukünftigen Version von Qt geändert wird, um weitere Metadaten zu übertragen, wird diese Funktion diese Metadaten entsprechend kopieren.

Die Zieladresse dieses Datagramms wird nicht kopiert, wenn es sich um eine IPv4-Adresse handelt, da es nicht möglich ist, eine IPv4-Broadcast-Adresse von einer regulären IPv4-Adresse zu unterscheiden, ohne alle diesem Rechner zugewiesenen Adressen zu durchsuchen. Der Versuch, ein Datagramm zu senden, bei dem die Absenderadresse gleich der Broadcast-Adresse ist, wird wahrscheinlich fehlschlagen. Dies sollte die Kommunikation jedoch nicht beeinträchtigen, da Netzwerkschnittstellen mit mehreren IPv4-Adressen selten sind, so dass die vom Betriebssystem gewählte Adresse wahrscheinlich von der Gegenstelle verstanden wird.

    udpSocket->writeDatagram(std::move(datagram).makeReply(replyData));

QNetworkDatagram::QNetworkDatagram()

Erzeugt ein QNetworkDatagram-Objekt ohne Nutzdaten und mit undefinierter Zieladresse.

Die Nutzdaten können mit setData() geändert werden, und die Zieladresse kann mit setDestination() festgelegt werden.

Wenn die Zieladresse nicht definiert ist, versucht QUdpSocket::writeDatagram(), das Datagramm an die Adresse zu senden, die zuletzt mit QUdpSocket::connectToHost() verknüpft war.

QNetworkDatagram::QNetworkDatagram(const QByteArray &data, const QHostAddress &destinationAddress = QHostAddress(), quint16 port = 0)

Erzeugt ein QNetworkDatagram-Objekt und setzt data als Nutzdaten sowie destinationAddress und port als Zieladresse des Datagramms.

QNetworkDatagram::QNetworkDatagram(const QNetworkDatagram &other)

Erzeugt eine Kopie des Datagramms other, einschließlich der Nutzlast und der Metadaten.

Um ein Datagramm zu erstellen, das zum Senden einer Antwort geeignet ist, verwenden Sie QNetworkDatagram::makeReply();

void QNetworkDatagram::clear()

Löscht die Nutzdaten und Metadaten in diesem QNetworkDatagram Objekt und setzt sie auf ihre Standardwerte zurück.

QByteArray QNetworkDatagram::data() const

Gibt die Nutzdaten dieses Datagramms zurück. Bei einem vom Netz empfangenen Datagramm enthält es die Nutzlast des Datagramms. Bei einem ausgehenden Datagramm handelt es sich um das zu sendende Datagramm.

Beachten Sie, dass Datagramme ohne Daten übertragen werden können, so dass die zurückgegebene QByteArray leer sein kann.

Siehe auch setData().

QHostAddress QNetworkDatagram::destinationAddress() const

Gibt die mit diesem Datagramm verbundene Zieladresse zurück. Bei einem aus dem Netz empfangenen Datagramm handelt es sich um die Adresse, an die der Peer-Knoten das Datagramm gesendet hat, die entweder eine lokale Adresse dieses Rechners oder eine Multicast- oder Broadcast-Adresse sein kann. Bei ausgehenden Datagrammen ist dies die Adresse, an die das Datagramm gesendet werden soll.

Wenn für dieses Datagramm keine Zieladresse festgelegt wurde, meldet das zurückgegebene Objekt true an QHostAddress::isNull().

Siehe auch senderAddress(), destinationPort(), und setDestination().

int QNetworkDatagram::destinationPort() const

Gibt die Portnummer des mit diesem Datagramm verbundenen Ziels zurück. Bei einem aus dem Netz empfangenen Datagramm handelt es sich um die lokale Portnummer, an die der Peer-Knoten das Datagramm gesendet hat. Bei einem ausgehenden Datagramm handelt es sich um den Peer-Port, an den das Datagramm gesendet werden sollte.

Wenn diesem Datagramm keine Zieladresse zugeordnet wurde, gibt diese Funktion -1 zurück.

Siehe auch destinationAddress(), senderPort(), und setDestination().

int QNetworkDatagram::hopLimit() const

Gibt die mit diesem Datagramm verknüpfte Hopcount-Grenze zurück. Die Hop-Count-Grenze ist die Anzahl der Knoten, die das IP-Paket weiterleiten dürfen, bevor es abläuft und ein Fehler an den Absender des Datagramms zurückgeschickt wird. In IPv4 wird dieser Wert normalerweise als "time to live" (TTL) bezeichnet.

Wenn dieses Datagramm vom Netz empfangen wurde, ist dies der verbleibende Hop Count des Datagramms nach dem Empfang und wurde von jedem Knoten, der das Paket weitergeleitet hat, um 1 dekrementiert. Ein Wert von -1 zeigt an, dass die Hop-Limit-Anzahl nicht erreicht werden kann.

Handelt es sich um ein ausgehendes Datagramm, ist dies der Wert, der beim Senden in den IP-Header gesetzt wird. Ein Wert von -1 zeigt an, dass das Betriebssystem den Wert wählen sollte.

Siehe auch setHopLimit().

uint QNetworkDatagram::interfaceIndex() const

Gibt den Schnittstellenindex zurück, dem dieses Datagramm zugeordnet ist. Der Schnittstellenindex ist eine positive Zahl, die die Netzwerkschnittstelle im Betriebssystem eindeutig identifiziert. Diese Zahl entspricht dem Wert, der von QNetworkInterface::index() für die Schnittstelle zurückgegeben wird.

Wenn dieses Datagramm vom Netz empfangen wurde, ist dies der Index der Schnittstelle, von der das Paket empfangen wurde. Handelt es sich um ein ausgehendes Datagramm, so ist dies der Index der Schnittstelle, über die das Datagramm gesendet werden soll.

Ein Wert von 0 bedeutet, dass der Schnittstellenindex unbekannt ist.

Siehe auch setInterfaceIndex().

bool QNetworkDatagram::isNull() const

Gibt true zurück, wenn dieses QNetworkDatagram Objekt null ist. Diese Funktion ist das Gegenteil von isValid().

bool QNetworkDatagram::isValid() const

Gibt true zurück, wenn dieses QNetworkDatagram Objekt gültig ist. Ein gültiges QNetworkDatagram Objekt enthält mindestens eine Absender- oder Empfängeradresse. Gültige Datagramme können leere Payloads enthalten.

QHostAddress QNetworkDatagram::senderAddress() const

Gibt die mit diesem Datagramm verbundene Absenderadresse zurück. Bei einem aus dem Netz empfangenen Datagramm handelt es sich um die Adresse des Peer-Knotens, der das Datagramm gesendet hat. Bei einem ausgehenden Datagramm ist es die lokale Adresse, die beim Senden verwendet wird.

Wenn für dieses Datagramm keine Absenderadresse festgelegt wurde, meldet das zurückgegebene Objekt true an QHostAddress::isNull().

Siehe auch destinationAddress(), senderPort(), und setSender().

int QNetworkDatagram::senderPort() const

Gibt die Portnummer des mit diesem Datagramm verbundenen Absenders zurück. Bei einem aus dem Netz empfangenen Datagramm handelt es sich um die Portnummer, von der aus der Peer-Knoten das Datagramm gesendet hat. Bei einem ausgehenden Datagramm handelt es sich um den lokalen Port, von dem aus das Datagramm gesendet werden sollte.

Wenn diesem Datagramm keine Absenderadresse zugeordnet wurde, gibt diese Funktion -1 zurück.

Siehe auch senderAddress(), destinationPort(), und setSender().

void QNetworkDatagram::setData(const QByteArray &data)

Setzt die Datennutzlast dieses Datagramms auf data. Es ist normalerweise nicht notwendig, diese Funktion bei empfangenen Datagrammen aufzurufen. Für ausgehende Datagramme legt diese Funktion die Daten fest, die über das Netz gesendet werden sollen.

Da Datagramme leer sein können, ist ein leeres QByteArray ein gültiger Wert für data.

Siehe auch data().

void QNetworkDatagram::setDestination(const QHostAddress &address, quint16 port)

Setzt die mit diesem Datagramm verknüpfte Zieladresse auf die Adresse address und die Portnummer port. Die Zieladresse und die Portnummern werden normalerweise von QUdpSocket beim Empfang gesetzt, so dass es nicht notwendig ist, diese Funktion für ein empfangenes Datagramm aufzurufen.

Für ausgehende Datagramme kann diese Funktion verwendet werden, um die Adresse festzulegen, an die das Datagramm gesendet werden soll. Dabei kann es sich um die Unicast-Adresse handeln, die für die Kommunikation mit der Gegenstelle verwendet wird, oder um eine Broadcast- oder Multicast-Adresse, die an eine Gruppe von Geräten gesendet wird.

Siehe auch QUdpSocket::writeDatagram(), destinationAddress(), destinationPort(), und setSender().

void QNetworkDatagram::setHopLimit(int count)

Setzt das diesem Datagramm zugeordnete Hop-Count-Limit auf count. Das Hop-Count-Limit ist die Anzahl der Knoten, die das IP-Paket weiterleiten dürfen, bevor es abläuft und ein Fehler an den Absender des Datagramms zurückgeschickt wird. In IPv4 wird dieser Wert gewöhnlich als "time to live" (TTL) bezeichnet.

Bei Datagrammen, die vom Netz empfangen werden, ist es normalerweise nicht notwendig, diese Funktion aufzurufen.

Handelt es sich um ein ausgehendes Paket, ist dies der Wert, der beim Senden in den IP-Header gesetzt wird. Der gültige Bereich für den Wert ist 1 bis 255. Diese Funktion akzeptiert auch einen Wert von -1, um anzugeben, dass das Betriebssystem den Wert wählen soll.

Siehe auch hopLimit().

void QNetworkDatagram::setInterfaceIndex(uint index)

Setzt den Schnittstellenindex, dem dieses Datagramm zugeordnet ist, auf index. Der Schnittstellenindex ist eine positive Zahl, die die Netzwerkschnittstelle im Betriebssystem eindeutig identifiziert. Diese Zahl entspricht dem Wert, der von QNetworkInterface::index() für die Schnittstelle zurückgegeben wird.

Normalerweise ist es nicht notwendig, diese Funktion bei Datagrammen, die vom Netz empfangen werden, aufzurufen.

Handelt es sich um ein ausgehendes Paket, ist dies der Index der Schnittstelle, über die das Datagramm gesendet werden soll. Ein Wert von 0 zeigt an, dass das Betriebssystem die Schnittstelle auf der Grundlage anderer Faktoren auswählen sollte.

Beachten Sie, dass der Schnittstellenindex für IPv6-Zieladressen auch mit QHostAddress::setScopeId() und anschließend mit setDestination() gesetzt werden kann. Wenn die Scope-ID in der Zieladresse und index unterschiedlich sind und keine davon Null ist, ist es unbestimmt, über welche Schnittstelle das Betriebssystem das Datagramm senden wird.

Siehe auch interfaceIndex() und setInterfaceIndex().

void QNetworkDatagram::setSender(const QHostAddress &address, quint16 port = 0)

Setzt die Absenderadresse, die mit diesem Datagramm verbunden ist, auf die Adresse address und die Portnummer port. Die Absenderadresse und die Portnummern werden normalerweise von QUdpSocket beim Empfang gesetzt, so dass es nicht notwendig ist, diese Funktion für ein empfangenes Datagramm aufzurufen.

Für ausgehende Datagramme kann diese Funktion verwendet werden, um die Adresse zu setzen, die das Datagramm tragen soll. Die Adresse address muss in der Regel eine der diesem Rechner zugewiesenen lokalen Adressen sein, die mit QNetworkInterface ermittelt werden kann. Wird sie nicht angegeben, wählt das Betriebssystem die für das betreffende Ziel am besten geeignete Adresse.

Die Portnummer port muss die Portnummer sein, die mit dem Socket verbunden ist, sofern ein solcher vorhanden ist. Der Wert 0 kann verwendet werden, um anzuzeigen, dass das Betriebssystem die Portnummer wählen soll.

Siehe auch QUdpSocket::writeDatagram(), senderAddress(), senderPort(), und setDestination().

[noexcept] void QNetworkDatagram::swap(QNetworkDatagram &other)

Tauscht dieses Datagramm mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QNetworkDatagram &QNetworkDatagram::operator=(const QNetworkDatagram &other)

Kopiert das Datagramm other, einschließlich der Nutzlast und der Metadaten.

Um ein Datagramm zu erstellen, das zum Senden einer Antwort geeignet ist, verwenden Sie QNetworkDatagram::makeReply();