QRestReply Class

Dokumentation zu den Mitgliedsfunktionen

[explicit] QRestReply::QRestReply(QNetworkReply *reply)

Erstellt ein `QRestReply`-Objekt und initialisiert das darin enthaltene ` QNetworkReply ` mit dem Wert ` reply`.

[noexcept] QRestReply::QRestReply(QRestReply &&other)

Die Antwort wird aus other per „Move“ konstruiert.

[noexcept] QRestReply::~QRestReply()

Löscht dieses „ QRestReply “-Objekt.

QNetworkReply::NetworkError QRestReply::error() const

Gibt den letzten Fehler zurück, sofern vorhanden. Zu den Fehlern zählen beispielsweise Netzwerk- und Protokollfehler; Fälle, in denen der Server erfolgreich mit einem HTTP-Status geantwortet hat, sind jedoch ausgeschlossen.

Siehe auch httpStatus(), isSuccess(), hasError() und errorString().

QString QRestReply::errorString() const

Gibt eine für Menschen lesbare Beschreibung des letzten Netzwerkfehlers zurück.

Siehe auch httpStatus(), isSuccess(), hasError() und error().

bool QRestReply::hasError() const

Gibt zurück, ob ein Fehler aufgetreten ist. Dies umfasst Fehler wie Netzwerk- und Protokollfehler, schließt jedoch Fälle aus, in denen der Server erfolgreich mit einem HTTP-Fehlerstatus geantwortet hat (zum Beispiel 500 Internal Server Error). Verwenden Sie httpStatus() oder isHttpStatusSuccess(), um die HTTP-Statusinformationen abzurufen.

Siehe auch httpStatus(), isSuccess(), error() und errorString().

int QRestReply::httpStatus() const

Gibt den in der Serverantwort empfangenen HTTP-Status zurück. Der Wert ist 0, wenn dieser nicht verfügbar ist (die Statuszeile wurde noch nicht empfangen).

Siehe auch ` isSuccess()`, ` hasError()` und ` error()`.

bool QRestReply::isHttpStatusSuccess() const

Gibt zurück, ob der HTTP-Status im Bereich von 200 bis 299 liegt.

Siehe auch isSuccess(), httpStatus(), hasError() und error().

bool QRestReply::isSuccess() const

Gibt zurück, ob der HTTP-Status im Bereich von 200 bis 299 liegt und beim Empfang der Antwort keine weiteren Fehler aufgetreten sind (z. B. eine plötzliche Unterbrechung der Verbindung während des Empfangs der Hauptdaten). Diese Funktion bietet eine bequeme Möglichkeit, zu überprüfen, ob die Antwort als erfolgreich gilt.

Siehe auch httpStatus(), hasError() und error().

QNetworkReply *QRestReply::networkReply() const

Gibt einen Zeiger auf das zugrunde liegende ` QNetworkReply ` zurück, das von diesem Objekt umschlossen wird.

QByteArray QRestReply::readBody()

Gibt die empfangenen Daten als ` QByteArray` zurück.

Der Aufruf dieser Funktion verbraucht die bisher empfangenen Daten, und alle weiteren Aufrufe zum Abrufen von Antwortdaten liefern leere Ergebnisse, bis weitere Daten empfangen wurden.

Siehe auch „ readJson()“, „ readText()“, „ QNetworkReply::bytesAvailable()“ und „ QNetworkReply::readyRead()“.

std::optional<QJsonDocument> QRestReply::readJson(QJsonParseError *error = nullptr)

Gibt die empfangenen Daten als ` QJsonDocument` zurück.

Der Rückgabewert wird in ` std::optional` verpackt. Wenn die Konvertierung der empfangenen Daten fehlschlägt (leere Daten oder JSON-Parsing-Fehler), wird ` std::nullopt ` zurückgegeben und ` error ` mit Details gefüllt.

Der Aufruf dieser Funktion verbraucht die empfangenen Daten, und alle weiteren Aufrufe zum Abrufen von Antwortdaten liefern leere Ergebnisse.

Diese Funktion gibt ` std::nullopt ` zurück und verarbeitet keine Daten, solange die Antwort noch nicht vollständig ist. Wird ` error ` übergeben, wird dieses Feld auf ` QJsonParseError::NoError ` gesetzt, um diesen Fall von einem tatsächlichen Fehler zu unterscheiden.

Siehe auch ` readBody()` und ` readText()`.

QString QRestReply::readText()

Gibt die empfangenen Daten als „ QString “ zurück.

Die empfangenen Daten werden in ein ` QString ` (UTF-16) dekodiert. Falls verfügbar, wird bei der Dekodierung der Parameter „charset“ des `Content-Type` -Headers verwendet, um die Quellkodierung zu ermitteln. Sind die Kodierungsinformationen nicht verfügbar oder werden sie von ` QStringConverter` nicht unterstützt, wird standardmäßig UTF-8 verwendet.

Der Aufruf dieser Funktion verbraucht die bisher empfangenen Daten. Gibt einen standardmäßig konstruierten Wert zurück, wenn keine neuen Daten verfügbar sind, die Dekodierung von QStringConverter nicht unterstützt wird oder die Dekodierung Fehler aufweist (z. B. ungültige Zeichen).

Siehe auch readJson(), readBody() und QNetworkReply::readyRead().

[noexcept] QRestReply &QRestReply::operator=(QRestReply &&other)

Weist „ other “ per Move-Zuweisung zu und gibt eine Referenz auf diese Antwort zurück.