QNetworkRequest Class

Dokumentation zu den Member-Funktionen

QNetworkRequest::QNetworkRequest()

Erstellt ein QNetworkRequest-Objekt ohne anzufragende URL. Verwenden Sie setUrl(), um eine URL festzulegen.

Siehe auch ` url()` und ` setUrl()`.

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

Erstellt ein QNetworkRequest-Objekt mit url als anzufordernder URL.

Siehe auch url() und setUrl().

QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)

Erstellt eine Kopie von „ other “.

[noexcept] QNetworkRequest::~QNetworkRequest()

Entfernt das „ QNetworkRequest “-Objekt.

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

Gibt das Attribut zurück, das dem Code „ code “ zugeordnet 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 auf „Archive Bombs“ zurück.

Ist die entpackte Größe einer Antwort kleiner als dieser Wert, entpackt Qt sie einfach, ohne weitere Überprü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 Raw-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, sofern dieser in dieser Anfrage vorhanden ist. Ist er nicht vorhanden, 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 in dieser Netzwerkanfrage gesetzten Header zurück.

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 zugrunde liegende HTTP/2-Verbindung verwendet. Dabei handelt es sich entweder um eine zuvor von einer Anwendung festgelegte Konfiguration oder um eine Standardkonfiguration.

Die von QNetworkAccessManager verwendeten Standardwerte lauten:

• Die Fenstergröße für die Flusssteuerung auf Verbindungsebene beträgt 2147483647 Oktette
• Die Fenstergröße für die Flusssteuerung auf Stream-Ebene beträgt 214748364 Oktette
• Die maximale Frame-Größe beträgt 16384

Standardmäßig ist „Server Push“ deaktiviert, während die Huffman-Komprimierung und die Zeichenfolgenindizierung aktiviert sind.

Siehe auch setHttp2Configuration.

int QNetworkRequest::maximumRedirectsAllowed() const

Gibt die maximale Anzahl an Weiterleitungen zurück, denen für diese Anfrage gefolgt werden darf.

Siehe auch ` setMaximumRedirectsAllowed()`.

QObject *QNetworkRequest::originatingObject() const

Gibt eine Referenz auf das Objekt zurück, das diese Netzwerkanfrage ausgelöst hat; gibt „ nullptr “ zurück, wenn diese nicht gesetzt ist oder das Objekt zerstört wurde.

Siehe auch „ setOriginatingObject()“.

QString QNetworkRequest::peerVerifyName() const

Gibt den für die Zertifikatsvalidierung festgelegten Hostnamen zurück, wie er unter setPeerVerifyName festgelegt wurde. Standardmäßig wird hier eine leere 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. Ist kein solcher Header vorhanden, wird ein leerer QByteArray zurückgegeben, der möglicherweise nicht von einem vorhandenen Header ohne Inhalt zu unterscheiden ist (verwenden Sie hasRawHeader(), um festzustellen, ob der Header vorhanden ist oder nicht).

Roh-Header können mit ` setRawHeader()` oder mit ` setHeader()` gesetzt werden.

Siehe auch header() und setRawHeader().

QList<QByteArray> QNetworkRequest::rawHeaderList() const

Gibt eine Liste aller Raw-Header zurück, die in dieser Netzwerkanfrage gesetzt wurden. Die Liste ist in der Reihenfolge sortiert, 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 “ verknüpfte Attribut auf den Wert „ value “. Ist das Attribut bereits gesetzt, wird der bisherige Wert verworfen. Insbesondere gilt: Ist „ value “ ein ungültiges „ QVariant “, wird das Attribut zurückgesetzt.

Siehe auch attribute() und QNetworkRequest::Attribute.

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

Legt die „ threshold “ für die Überprüfung auf „Archive Bombs“ fest.

Einige unterstützte Komprimierungsalgorithmen können in einer winzigen komprimierten Datei eine spektakulär große dekomprimierte Datei kodieren. Dies ist nur möglich, wenn der entpackte Inhalt extrem monoton ist, was bei echten Dateien, die in gutem Glauben übertragen werden, selten der Fall ist: Dateien mit solch wahnsinnig hohen Kompressionsverhältnissen sind typischerweise Nutzdaten von Pufferüberlauf-Angriffen oder Denial-of-Service-Angriffen (durch übermäßigen Speicherverbrauch). Folglich sollten Dateien, die sich auf riesige Größen dekomprimieren lassen – insbesondere aus winzigen komprimierten Formen –, am besten als mutmaßliche Malware zurückgewiesen werden.

Wenn die entpackte Größe einer Antwort diesen Schwellenwert überschreitet (standardmäßig 10 MiB, d. h. 10 * 1024 * 1024), überprüft Qt das Kompressionsverhältnis: Ist dieses unverhältnismäßig hoch (40:1 für GZip und Deflate bzw. 100:1 für Brotli und ZStandard), wird die Antwort als Fehler behandelt. Durch Setzen des Schwellenwerts auf „ -1 “ wird diese Überprüfung deaktiviert.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch decompressedSafetyCheckThreshold().

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

Setzt den Wert des bekannten Header- header s auf „ value “ und überschreibt dabei alle zuvor festgelegten Header. Dieser Vorgang setzt auch den entsprechenden rohen HTTP-Header.

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

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

Legt „ newHeaders “ als Header in dieser Netzwerkanfrage fest und überschreibt dabei alle zuvor festgelegten Header.

Wenn einige Header mit den bekannten Headern übereinstimmen, werden die Werte geparst und die entsprechende geparste Form 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)

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 aus „ configuration “.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch http1Configuration, QNetworkAccessManager und QHttp1Configuration.

void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)

Legt die HTTP/2-Parameter der Anfrage aus „ configuration “ fest.

Siehe auch http2Configuration, QNetworkAccessManager und QHttp2Configuration.

void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)

Legt die maximale Anzahl der Umleitungen fest, denen für diese Anfrage zu maxRedirectsAllowed gefolgt werden darf.

Siehe auch maximumRedirectsAllowed().

void QNetworkRequest::setOriginatingObject(QObject *object)

Ermöglicht die Festlegung einer Referenz auf den „ object “, der die Anfrage initiiert hat.

Beispielsweise setzt Qt WebKit das Ursprungsobjekt auf den QWebFrame, der die Anfrage initiiert hat.

Siehe auch ` originatingObject()`

void QNetworkRequest::setPeerVerifyName(const QString &peerName)

Legt „ peerName “ als Hostnamen für die Zertifikatsüberprüfung fest, anstelle des für die TCP-Verbindung verwendeten Hostnamens.

Siehe auch peerVerifyName.

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

Legen Sie die Priorität dieser Anfrage auf „ priority “ fest.

Siehe auch „ priority()“.

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

Setzt den Header „ headerName “ auf den Wert „ headerValue “. Wenn „ headerName “ einem bekannten Header entspricht (siehe QNetworkRequest::KnownHeaders), wird das Rohformat geparst und der entsprechende „aufbereitete“ Header ebenfalls gesetzt.

Beispiel:

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

wird auch der bekannte Header „ LastModifiedHeader “ auf das QDateTime -Objekt des geparsten Datums gesetzt.

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

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

Legt die SSL-Konfiguration dieser Netzwerkanfrage auf „ config “ fest. Die geltenden Einstellungen sind der private Schlüssel, das lokale Zertifikat, das TLS-Protokoll (z. B. TLS 1.3), die CA-Zertifikate und die Verschlüsselungsalgorithmen, die das SSL-Backend verwenden darf.

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

[since 6.11] void QNetworkRequest::setTcpKeepAliveIdleTimeBeforeProbes(std::chrono::seconds idle)

Legt die Zeit fest, die die Verbindung inaktiv bleiben muss, bevor TCP mit dem Senden von Keepalive-Anfragen beginnt, um als „ idle “ zu gelten, sofern die TCP-Keepalive-Funktion aktiviert wurde.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch ` tcpKeepAliveIdleTimeBeforeProbes()`.

[since 6.11] void QNetworkRequest::setTcpKeepAliveIntervalBetweenProbes(std::chrono::seconds interval)

Legt die Zeit zwischen einzelnen Keepalive-Abfragen auf ` interval` fest, sofern die TCP-Keepalive-Funktion aktiviert wurde.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch ` tcpKeepAliveIntervalBetweenProbes()`.

[since 6.11] void QNetworkRequest::setTcpKeepAliveProbeCount(int probes)

Legt die maximale Anzahl an Keepalive- probes fest, die TCP senden soll, bevor die Verbindung getrennt wird, sofern die TCP-Keepalive-Funktion aktiviert wurde.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch ` tcpKeepAliveProbeCount()`

void QNetworkRequest::setTransferTimeout(int timeout)

Legt „ timeout “ als Übertragungszeitlimit in Millisekunden fest.

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

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

Legt das Timeout „ duration “ fest, nach dessen Ablauf die Übertragung abgebrochen wird, wenn keine Daten ausgetauscht wurden.

Übertragungen werden abgebrochen, wenn vor Ablauf des Timeouts keine Bytes übertragen wurden. Der Wert Null bedeutet, dass kein Timer gesetzt ist. Wird kein Argument angegeben, beträgt der Timeout- QNetworkRequest::DefaultTransferTimeout. Wird diese Funktion nicht aufgerufen, ist der Timeout 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 die URL, auf die sich diese Netzwerkanfrage bezieht, auf url fest.

Siehe auch url().

QSslConfiguration QNetworkRequest::sslConfiguration() const

Gibt die SSL-Konfiguration dieser Netzwerkanfrage zurück. Standardmäßig entspricht diese der von QSslConfiguration::defaultConfiguration().

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

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

Tauscht diese Netzwerkanfrage gegen „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIdleTimeBeforeProbes() const

Gibt die Zeit zurück, die die Verbindung im Ruhezustand verbleiben muss, bevor TCP mit dem Senden von Keepalive-Anfragen beginnt, sofern die TCP-Keepalive-Funktion aktiviert wurde.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch ` setTcpKeepAliveIdleTimeBeforeProbes()`.

[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIntervalBetweenProbes() const

Gibt die Zeitspanne zwischen einzelnen Keepalive-Abfragen zurück, sofern die TCP-Keepalive-Funktion aktiviert wurde.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch ` setTcpKeepAliveIntervalBetweenProbes()`.

[since 6.11] int QNetworkRequest::tcpKeepAliveProbeCount() const

Gibt die maximale Anzahl an Keepalive-Anfragen zurück, die TCP senden soll, bevor die Verbindung getrennt wird, sofern die TCP-Keepalive-Funktion aktiviert wurde.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch „ setTcpKeepAliveProbeCount()“.

int QNetworkRequest::transferTimeout() const

Gibt das für Übertragungen verwendete Timeout in Millisekunden zurück.

Wenn „ transferTimeoutAsDuration().count()“ nicht als „ int “ dargestellt werden kann, gibt diese Funktion stattdessen „ INT_MAX “ bzw. „INT_MIN “ zurück.

Siehe auch ` setTransferTimeout()` und ` transferTimeoutAsDuration()`.

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

Gibt die Zeitüberschreitungsdauer zurück, nach deren Ablauf die Übertragung abgebrochen wird, wenn keine Daten ausgetauscht werden.

Die Standarddauer beträgt Null, was bedeutet, dass das Timeout nicht verwendet 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 Netzwerkabfrage bezieht.

Siehe auch ` setUrl()`.

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

Gibt „ false “ zurück, wenn dieses Objekt nicht mit „ other “ übereinstimmt.

Siehe auch operator==().

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

Erstellt eine Kopie von other

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

Gibt „ true “ zurück, wenn dieses Objekt mit „ other “ identisch ist (d. h., wenn beide dieselbe URL, dieselben Header und dieselben Metadaten-Einstellungen aufweisen).

Siehe auch operator!=().