QNetworkRequest Class

Dokumentation der Mitgliedsfunktionen

QNetworkRequest::QNetworkRequest()

Konstruiert ein QNetworkRequest-Objekt ohne anzufordernde URL. Verwenden Sie setUrl(), um eine zu setzen.

Siehe auch url() und setUrl().

[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)

Konstruiert ein QNetworkRequest-Objekt mit url als anzufordernde URL.

Siehe auch url() und setUrl().

QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)

Erzeugt eine Kopie von other.

[noexcept] QNetworkRequest::~QNetworkRequest()

Beseitigt das Objekt QNetworkRequest.

QVariant QNetworkRequest::attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const

Gibt das Attribut zurück, das mit dem Code code verbunden ist. Wenn das Attribut nicht gesetzt wurde, wird defaultValue zurückgegeben.

Siehe auch setAttribute() und QNetworkRequest::Attribute.

[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const

Gibt den Schwellenwert für die Überprüfung von Archivbomben zurück.

Wenn die dekomprimierte Größe einer Antwort kleiner als dieser Wert ist, dekomprimiert Qt sie einfach, ohne weitere Prüfung.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setDecompressedSafetyCheckThreshold().

bool QNetworkRequest::hasRawHeader(QAnyStringView headerName) const

Gibt true zurück, wenn der rohe Header headerName in dieser Netzwerkanfrage vorhanden ist.

Siehe auch rawHeader() und setRawHeader().

QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const

Gibt den Wert des bekannten Netzwerk-Headers header zurück, wenn er in dieser Anfrage vorhanden ist. Wenn er nicht vorhanden ist, wird QVariant() zurückgegeben (d. h. eine ungültige Variante).

Siehe auch KnownHeaders, rawHeader(), und setHeader().

[since 6.8] QHttpHeaders QNetworkRequest::headers() const

Gibt die Header zurück, die in dieser Netzwerkanfrage gesetzt sind.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch setHeaders().

[since 6.5] QHttp1Configuration QNetworkRequest::http1Configuration() const

Gibt die aktuellen Parameter zurück, die QNetworkAccessManager für die zugrunde liegende HTTP/1-Verbindung dieser Anfrage verwendet.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setHttp1Configuration.

QHttp2Configuration QNetworkRequest::http2Configuration() const

Gibt die aktuellen Parameter zurück, die QNetworkAccessManager für diese Anfrage und die ihr zugrunde liegende HTTP/2-Verbindung verwendet. Dies ist entweder eine Konfiguration, die zuvor von einer Anwendung festgelegt wurde, oder eine Standardkonfiguration.

Die Standardwerte, die QNetworkAccessManager verwendet, sind:

• Die Fenstergröße für die Flusskontrolle auf Verbindungsebene ist 2147483647 octets
• Die Fenstergröße für die Flusskontrolle auf Streamebene ist 214748364 octets
• Die maximale Framegröße beträgt 16384

Standardmäßig ist Server-Push deaktiviert, Huffman-Kompression und String-Indizierung sind aktiviert.

Siehe auch setHttp2Configuration.

int QNetworkRequest::maximumRedirectsAllowed() const

Gibt die maximale Anzahl von Umleitungen zurück, die für diese Anfrage verfolgt werden dürfen.

Siehe auch setMaximumRedirectsAllowed().

QObject *QNetworkRequest::originatingObject() const

Gibt einen Verweis auf das Objekt zurück, das diese Netzwerkanfrage ausgelöst hat; gibt nullptr zurück, wenn es nicht gesetzt ist oder das Objekt zerstört wurde.

Siehe auch setOriginatingObject().

QString QNetworkRequest::peerVerifyName() const

Gibt den Hostnamen zurück, der für die Zertifikatsüberprüfung festgelegt wurde, wie von setPeerVerifyName festgelegt. Standardmäßig wird eine Null-Zeichenkette zurückgegeben.

Siehe auch setPeerVerifyName.

QNetworkRequest::Priority QNetworkRequest::priority() const

Gibt die Priorität dieser Anfrage zurück.

Siehe auch setPriority().

QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const

Gibt die Rohform des Headers headerName zurück. Wenn keine solche Kopfzeile vorhanden ist, wird ein leeres QByteArray zurückgegeben, das nicht von einer Kopfzeile zu unterscheiden ist, die zwar vorhanden ist, aber keinen Inhalt hat (verwenden Sie hasRawHeader(), um herauszufinden, ob die Kopfzeile existiert oder nicht).

Rohe Header können mit setRawHeader() oder mit setHeader() gesetzt werden.

Siehe auch header() und setRawHeader().

QList<QByteArray> QNetworkRequest::rawHeaderList() const

Gibt eine Liste aller rohen Header zurück, die in dieser Netzwerkanfrage gesetzt wurden. Die Liste ist in der Reihenfolge, in der die Header gesetzt wurden.

Siehe auch hasRawHeader() und rawHeader().

void QNetworkRequest::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)

Setzt das mit dem Code code verbundene Attribut auf den Wert value. Wenn das Attribut bereits gesetzt ist, wird der vorherige Wert verworfen. Insbesondere, wenn value ein ungültiger QVariant ist, wird das Attribut nicht gesetzt.

Siehe auch attribute() und QNetworkRequest::Attribute.

[since 6.2] void QNetworkRequest::setDecompressedSafetyCheckThreshold(qint64 threshold)

Legt die threshold für Archivbombenprüfungen fest.

Einige unterstützte Kompressionsalgorithmen können in einer winzigen komprimierten Datei eine spektakulär große dekomprimierte Datei kodieren. Dies ist nur möglich, wenn der dekomprimierte Inhalt extrem eintönig ist, was bei echten Dateien, die in gutem Glauben übertragen werden, selten der Fall ist: Dateien, die solch irrsinnig hohe Komprimierungsraten aufweisen, sind in der Regel Nutzlast von Pufferüberlauf-Angriffen oder Denial-of-Service-Angriffen (weil sie zu viel Speicher verbrauchen). Folglich werden Dateien, die zu enormen Größen dekomprimiert werden, insbesondere aus winzigen komprimierten Formen, am besten als mutmaßliche Malware zurückgewiesen.

Wenn die dekomprimierte Größe einer Antwort größer ist als dieser Schwellenwert (standardmäßig 10 MiB, d.h. 10 * 1024 * 1024), prüft Qt das Kompressionsverhältnis: Wenn dieses unangemessen groß ist (40:1 für GZip und Deflate oder 100:1 für Brotli und ZStandard), wird die Antwort als Fehler behandelt. Wenn Sie den Schwellenwert auf -1 setzen, wird diese Prüfung ausgeschaltet.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch decompressedSafetyCheckThreshold().

void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)

Legt den Wert der bekannten Kopfzeile header auf value fest und setzt damit alle zuvor festgelegten Kopfzeilen außer Kraft. Dieser Vorgang setzt auch den entsprechenden rohen HTTP-Header.

Siehe auch KnownHeaders, setRawHeader(), und header().

[since 6.8] void QNetworkRequest::setHeaders(QHttpHeaders &&newHeaders)

Setzt newHeaders als Kopfzeilen in dieser Netzwerkanfrage und überschreibt alle zuvor gesetzten Kopfzeilen.

Wenn einige Header mit den bekannten Headern übereinstimmen, werden die Werte geparst und die entsprechende geparste Form wird ebenfalls gesetzt.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch headers() und KnownHeaders.

[since 6.8] void QNetworkRequest::setHeaders(const QHttpHeaders &newHeaders)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.8 eingeführt.

[since 6.5] void QNetworkRequest::setHttp1Configuration(const QHttp1Configuration &configuration)

Setzt die HTTP/1-Parameter der Anfrage von configuration.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch http1Configuration, QNetworkAccessManager, und QHttp1Configuration.

void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)

Setzt die HTTP/2-Parameter der Anfrage von configuration.

Siehe auch http2Configuration, QNetworkAccessManager, und QHttp2Configuration.

void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)

Setzt die maximale Anzahl von Umleitungen, die für diese Anfrage befolgt werden dürfen, auf maxRedirectsAllowed.

Siehe auch maximumRedirectsAllowed().

void QNetworkRequest::setOriginatingObject(QObject *object)

Ermöglicht das Setzen eines Verweises auf das object, das die Anfrage initiiert.

Zum Beispiel setzt Qt WebKit das originating object auf den QWebFrame, der die Anfrage initiiert hat.

Siehe auch originatingObject().

void QNetworkRequest::setPeerVerifyName(const QString &peerName)

Legt peerName als Hostname für die Zertifikatsüberprüfung fest, anstelle des für die TCP-Verbindung verwendeten Namens.

Siehe auch peerVerifyName.

void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)

Setzen Sie die Priorität dieser Anfrage auf priority.

Siehe auch priority().

void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

Setzt den Header headerName auf den Wert headerValue. Wenn headerName einer bekannten Kopfzeile entspricht (siehe QNetworkRequest::KnownHeaders), wird das Rohformat geparst und die entsprechende "gekochte" Kopfzeile wird ebenfalls gesetzt.

Ein Beispiel:

request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));

setzt auch die bekannte Kopfzeile LastModifiedHeader auf das QDateTime Objekt des geparsten Datums.

Siehe auch KnownHeaders, setHeader(), hasRawHeader(), und rawHeader().

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

Setzt die SSL-Konfiguration dieser Netzwerkanfrage auf config. Die relevanten Einstellungen sind der private Schlüssel, das lokale Zertifikat, das TLS-Protokoll (z. B. TLS 1.3), die CA-Zertifikate und die Chiffren, die das SSL-Backend verwenden darf.

Siehe auch sslConfiguration() und QSslConfiguration::defaultConfiguration().

void QNetworkRequest::setTransferTimeout(int timeout)

Setzt timeout als Übertragungszeitlimit in Millisekunden.

Siehe auch setTransferTimeout(std::chrono::milliseconds), transferTimeout(), und transferTimeoutAsDuration().

[since 6.7] void QNetworkRequest::setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout)

Legt den Timeout duration fest, um die Übertragung abzubrechen, wenn keine Daten ausgetauscht werden.

Übertragungen werden abgebrochen, wenn vor Ablauf der Zeitüberschreitung keine Bytes übertragen werden. Null bedeutet, dass kein Timer gesetzt wird. Wenn kein Argument angegeben wird, ist die Zeitüberschreitung QNetworkRequest::DefaultTransferTimeout. Wenn diese Funktion nicht aufgerufen wird, ist die Zeitüberschreitung deaktiviert und hat den Wert Null.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch transferTimeoutAsDuration().

void QNetworkRequest::setUrl(const QUrl &url)

Legt fest, dass die URL, auf die sich diese Netzwerkanfrage bezieht, url ist.

Siehe auch url().

QSslConfiguration QNetworkRequest::sslConfiguration() const

Gibt die SSL-Konfiguration dieser Netzwerkanfrage zurück. Standardmäßig ist dies die gleiche wie QSslConfiguration::defaultConfiguration().

Siehe auch setSslConfiguration() und QSslConfiguration::defaultConfiguration().

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

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

int QNetworkRequest::transferTimeout() const

Gibt die für Übertragungen verwendete Zeitüberschreitung in Millisekunden zurück.

Wenn transferTimeoutAsDuration().count() nicht in int dargestellt werden kann, gibt diese Funktion stattdessen INT_MAX/INT_MIN zurück.

Siehe auch setTransferTimeout() und transferTimeoutAsDuration().

[since 6.7] std::chrono::milliseconds QNetworkRequest::transferTimeoutAsDuration() const

Gibt die Timeout-Dauer zurück, nach der die Übertragung abgebrochen wird, wenn keine Daten ausgetauscht werden.

Die Standarddauer ist Null, was bedeutet, dass die Zeitüberschreitung nicht genutzt wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch setTransferTimeout(std::chrono::milliseconds).

QUrl QNetworkRequest::url() const

Gibt die URL zurück, auf die sich diese Netzwerkanfrage bezieht.

Siehe auch setUrl().

bool QNetworkRequest::operator!=(const QNetworkRequest &other) const

Gibt false zurück, wenn dieses Objekt nicht mit other identisch ist.

Siehe auch operator==().

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

Erzeugt eine Kopie von other

bool QNetworkRequest::operator==(const QNetworkRequest &other) const

Gibt true zurück, wenn dieses Objekt dasselbe ist wie other (d. h. wenn sie dieselbe URL, dieselben Kopfzeilen und dieselben Metadateneinstellungen haben).

Siehe auch operator!=().