QNetworkAccessManager Class

QNetworkAccessManager *manager = new QNetworkAccessManager(this);
connect(manager, &QNetworkAccessManager::finished,
        this, &MyClass::replyFinished);

manager->get(QNetworkRequest(QUrl("http://qt-project.org")));

QNetworkRequest request;
request.setUrl(QUrl("http://qt-project.org"));
request.setRawHeader("User-Agent", "MyOwnBrowser 1.0");

QNetworkReply *reply = manager->get(request);
connect(reply, &QIODevice::readyRead, this, &MyClass::slotReadyRead);
connect(reply, &QNetworkReply::errorOccurred,
        this, &MyClass::slotError);
connect(reply, &QNetworkReply::sslErrors,
        this, &MyClass::slotSslErrors);

QNetworkRequest networkRequest(url);
networkRequest.setTcpKeepAliveIdleTimeBeforeProbes(20s);
networkRequest.setTcpKeepAliveIntervalBetweenProbes(2s);
networkRequest.setTcpKeepAliveProbeCount(5);

Dokumentation zu den Member-Funktionen

[explicit] QNetworkAccessManager::QNetworkAccessManager(QObject *parent = nullptr)

Erstellt ein `QNetworkAccessManager`-Objekt, das das Herzstück der Netzwerkzugriffs-API bildet, und legt ` parent ` als übergeordnetes Objekt fest.

[virtual noexcept] QNetworkAccessManager::~QNetworkAccessManager()

Löscht das „ QNetworkAccessManager “-Objekt und gibt alle Ressourcen frei. Beachten Sie, dass Objekte vom Typ „ QNetworkReply “, die von dieser Klasse zurückgegeben werden, dieses Objekt als übergeordnetes Objekt haben. Das bedeutet, dass sie zusammen mit diesem gelöscht werden, wenn Sie für sie nicht die Methode „ QObject::setParent()“ aufrufen.

void QNetworkAccessManager::addStrictTransportSecurityHosts(const QList<QHstsPolicy> &knownHosts)

Fügt HTTP-Strict-Transport-Security-Richtlinien in den HSTS-Cache ein. Die Datei „ knownHosts “ enthält die bekannten Hosts, für die Informationen zu „ QHstsPolicy “ vorliegen.

Siehe auch strictTransportSecurityHosts(), enableStrictTransportSecurityStore() und QHstsPolicy.

[signal] void QNetworkAccessManager::authenticationRequired(QNetworkReply *reply, QAuthenticator *authenticator)

Dieses Signal wird immer dann ausgelöst, wenn ein Endserver eine Authentifizierung anfordert, bevor er die angeforderten Inhalte bereitstellt. Der mit diesem Signal verbundene Slot sollte die Anmeldedaten für die Inhalte (die durch Überprüfung des Objekts ` reply ` ermittelt werden können) in das Objekt ` authenticator ` eintragen.

QNetworkAccessManager speichert die Anmeldedaten intern im Cache und sendet dieselben Werte, wenn der Server erneut eine Authentifizierung verlangt, ohne das Signal `authenticationRequired()` auszulösen. Wenn die Anmeldedaten abgelehnt werden, wird dieses Signal erneut ausgelöst.

Siehe auch proxyAuthenticationRequired(), QAuthenticator::setUser() und QAuthenticator::setPassword().

bool QNetworkAccessManager::autoDeleteReplies() const

Gibt „true“ zurück, wenn „ QNetworkAccessManager “ derzeit so konfiguriert ist, dass „QNetworkReplies“ automatisch gelöscht werden; andernfalls „false“.

Siehe auch „ setAutoDeleteReplies “ und „ QNetworkRequest::AutoDeleteReplyOnFinishAttribute “.

QAbstractNetworkCache *QNetworkAccessManager::cache() const

Gibt den Cache zurück, der zum Speichern von aus dem Netzwerk bezogenen Daten verwendet wird.

Siehe auch ` setCache()`.

void QNetworkAccessManager::clearAccessCache()

Leert den internen Cache mit Authentifizierungsdaten und Netzwerkverbindungen.

Diese Funktion ist nützlich für die Durchführung von automatisierten Tests.

Siehe auch ` clearConnectionCache()`.

void QNetworkAccessManager::clearConnectionCache()

Leert den internen Cache der Netzwerkverbindungen. Im Gegensatz zu clearAccessCache() bleiben die Authentifizierungsdaten erhalten.

Siehe auch ` clearAccessCache()`.

void QNetworkAccessManager::connectToHost(const QString &hostName, quint16 port = 80)

Stellt eine Verbindung zu dem unter hostName angegebenen Host am Port port her. Diese Funktion ist nützlich, um den TCP-Handshake mit einem Host abzuschließen, bevor die HTTP-Anfrage gesendet wird, was zu einer geringeren Netzwerklatenz führt.

Siehe auch connectToHostEncrypted(), get(), post(), put() und deleteResource().

void QNetworkAccessManager::connectToHostEncrypted(const QString &hostName, quint16 port = 443, const QSslConfiguration &sslConfiguration = QSslConfiguration::defaultConfiguration())

Stellt eine Verbindung zu dem unter hostName angegebenen Host am Port port her, wobei sslConfiguration verwendet wird. Diese Funktion ist nützlich, um den TCP- und SSL-Handshake mit einem Host abzuschließen, bevor die HTTPS-Anfrage gestellt wird, was zu einer geringeren Netzwerklatenz führt.

Siehe auch connectToHost(), get(), post(), put() und deleteResource().

void QNetworkAccessManager::connectToHostEncrypted(const QString &hostName, quint16 port, const QSslConfiguration &sslConfiguration, const QString &peerName)

Stellt eine Verbindung zu dem unter hostName angegebenen Host am Port port her, wobei sslConfiguration verwendet wird und peerName als Hostname für die Zertifikatsvalidierung festgelegt ist. Diese Funktion ist nützlich, um den TCP- und SSL-Handshake mit einem Host abzuschließen, bevor die HTTPS-Anfrage gestellt wird, was zu einer geringeren Netzwerklatenz führt.

Siehe auch connectToHost(), get(), post(), put() und deleteResource().

QNetworkCookieJar *QNetworkAccessManager::cookieJar() const

Gibt das „ QNetworkCookieJar “ zurück, in dem sowohl aus dem Netzwerk bezogene Cookies als auch Cookies, die versendet werden sollen, gespeichert werden.

Siehe auch setCookieJar().

[virtual protected] QNetworkReply *QNetworkAccessManager::createRequest(QNetworkAccessManager::Operation op, const QNetworkRequest &originalReq, QIODevice *outgoingData = nullptr)

Gibt ein neues „ QNetworkReply “-Objekt zurück, um die Operation „ op “ und die Anfrage „ originalReq “ zu verarbeiten. Der Parameter „device“ outgoingData ist bei GET- und HEAD-Anfragen immer 0, wird jedoch bei diesen Operationen als Wert an die Methoden „ post()“ und „ put()“ übergeben (die „ QByteArray “-Varianten übergeben ein „ QBuffer “-Objekt).

Die Standardimplementierung ruft ` QNetworkCookieJar::cookiesForUrl()` für den mit ` setCookieJar()` eingerichteten Cookie-Speicher auf, um die an den Remote-Server zu sendenden Cookies abzurufen.

Das zurückgegebene Objekt muss sich im geöffneten Zustand befinden.

QNetworkReply *QNetworkAccessManager::deleteResource(const QNetworkRequest &request)

Sendet eine Anforderung zum Löschen der Ressource, die durch die URL request identifiziert wird.

Siehe auch get(), post(), put() und sendCustomRequest().

void QNetworkAccessManager::enableStrictTransportSecurityStore(bool enabled, const QString &storeDir = QString())

Wenn „ enabled “ auf „ true “ gesetzt ist, nutzt der interne HSTS-Cache einen persistenten Speicher zum Lesen und Schreiben von HSTS-Richtlinien. „ storeDir “ legt fest, wo sich dieser Speicher befindet. Der Standardspeicherort wird durch „ QStandardPaths::CacheLocation “ definiert. Wenn kein beschreibbarer „QStandartPaths::CacheLocation“-Pfad vorhanden ist und „ storeDir “ eine leere Zeichenkette ist, befindet sich der Speicher im Arbeitsverzeichnis des Programms.

Ein Angreifer mit Schreibzugriff auf die Speicher-Datei könnte HSTS-Einträge für bestimmte Domänen entfernen, was dazu führen würde, dass die Anwendung bei nachfolgenden Anfragen HTTP-Verbindungen im Klartext zu diesen Domänen zulässt und potenziell SSL-Stripping-Angriffe ermöglicht. Anwendungen, die auf HSTS angewiesen sind, sollten sicherstellen, dass das Speicherverzeichnis durch geeignete Dateisystemberechtigungen geschützt ist.

Siehe auch isStrictTransportSecurityStoreEnabled(), setStrictTransportSecurityEnabled() und QStandardPaths::standardLocations().

[signal] void QNetworkAccessManager::encrypted(QNetworkReply *reply)

Dieses Signal wird ausgegeben, wenn eine SSL/TLS-Sitzung den anfänglichen Handshake erfolgreich abgeschlossen hat. Zu diesem Zeitpunkt wurden noch keine Benutzerdaten übertragen. Das Signal kann verwendet werden, um zusätzliche Prüfungen der Zertifikatskette durchzuführen, beispielsweise um Benutzer zu benachrichtigen, wenn sich das Zertifikat einer Website geändert hat. Der Parameter ` reply ` gibt an, welche Netzwerkantwort dafür verantwortlich ist. Entspricht die Antwort nicht den erwarteten Kriterien, sollte sie durch den Aufruf von ` QNetworkReply::abort()` durch einen mit diesem Signal verbundenen Slot abgebrochen werden. Die verwendete SSL-Konfiguration kann mit der Methode ` QNetworkReply::sslConfiguration()` überprüft werden.

Intern kann ` QNetworkAccessManager ` mehrere Verbindungen zu einem Server öffnen, um Anfragen parallel verarbeiten zu können. Diese Verbindungen können wiederverwendet werden, was bedeutet, dass das Signal `encrypted()` nicht ausgelöst wird. Das bedeutet, dass Sie dieses Signal garantiert nur für die erste Verbindung zu einer Website während der Lebensdauer von ` QNetworkAccessManager` erhalten.

Siehe auch ` QSslSocket::encrypted()` und ` QNetworkReply::encrypted()`.

[signal] void QNetworkAccessManager::finished(QNetworkReply *reply)

Dieses Signal wird ausgelöst, sobald eine ausstehende Netzwerkantwort abgeschlossen ist. Der Parameter „ reply “ enthält einen Zeiger auf die soeben abgeschlossene Antwort. Dieses Signal wird zusammen mit dem Signal „ QNetworkReply::finished()“ ausgelöst.

Informationen zum Status, in dem sich das Objekt befinden wird, finden Sie unter „ QNetworkReply::finished()“.

Siehe auch QNetworkReply::finished() und QNetworkReply::error().

QNetworkReply *QNetworkAccessManager::get(const QNetworkRequest &request)

Sendet eine Anfrage, um den Inhalt der Ziel- request abzurufen, und gibt ein neues, zum Lesen geöffnetes „ QNetworkReply “-Objekt zurück, das bei jedem Eintreffen neuer Daten das Signal „ readyRead()“ ausgibt.

Sowohl der Inhalt als auch die zugehörigen Header werden heruntergeladen.

Siehe auch „ post()“, „ put()“, „ deleteResource()“ und „ sendCustomRequest()“.

[since 6.7] QNetworkReply *QNetworkAccessManager::get(const QNetworkRequest &request, QIODevice *data)

Diese Funktion wurde in Qt 6.7 eingeführt.

[since 6.7] QNetworkReply *QNetworkAccessManager::get(const QNetworkRequest &request, const QByteArray &data)

Diese Funktion wurde in Qt 6.7 eingeführt.

QNetworkReply *QNetworkAccessManager::head(const QNetworkRequest &request)

Sendet eine Anfrage, um die Netzwerk-Header für request abzurufen, und gibt ein neues QNetworkReply -Objekt zurück, das diese Header enthält.

Die Funktion ist nach der zugehörigen HTTP-Anfrage (HEAD) benannt.

bool QNetworkAccessManager::isStrictTransportSecurityEnabled() const

Gibt „true“ zurück, wenn HTTP Strict Transport Security (HSTS) aktiviert wurde. Standardmäßig ist HSTS deaktiviert.

Siehe auch „ setStrictTransportSecurityEnabled()“.

bool QNetworkAccessManager::isStrictTransportSecurityStoreEnabled() const

Gibt „true“ zurück, wenn der HSTS-Cache einen permanenten Speicher zum Laden und Speichern von HSTS-Richtlinien verwendet.

Siehe auch ` enableStrictTransportSecurityStore()`.

QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, QIODevice *data)

Sendet eine HTTP-POST-Anfrage an das unter request angegebene Ziel und gibt ein neues, zum Lesen geöffnetes QNetworkReply -Objekt zurück, das die vom Server gesendete Antwort enthält. Der Inhalt des Geräts data wird auf den Server hochgeladen.

data muss zum Lesen geöffnet sein und muss gültig bleiben, bis das Signal ` finished()` für diese Antwort ausgelöst wird.

Siehe auch „ get()“, „ put()“, „ deleteResource()“ und „ sendCustomRequest()“.

QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, QHttpMultiPart *multiPart)

Sendet den Inhalt der Nachricht „ multiPart “ an das unter „ request “ angegebene Ziel.

Dies kann zum Versenden von MIME-Multipart-Nachrichten über HTTP verwendet werden.

Siehe auch QHttpMultiPart, QHttpPart und put().

QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, const QByteArray &data)

Sendet den Inhalt des Byte-Arrays „ data “ an das durch „ request “ angegebene Ziel.

[since 6.8] QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, std::nullptr_t nptr)

Sendet die unter request angegebene POST-Anfrage ohne Body und gibt ein neues QNetworkReply -Objekt zurück.

Diese Funktion wurde in Qt 6.8 eingeführt.

[signal] void QNetworkAccessManager::preSharedKeyAuthenticationRequired(QNetworkReply *reply, QSslPreSharedKeyAuthenticator *authenticator)

Dieses Signal wird ausgegeben, wenn beim SSL/TLS-Handshake eine PSK-Verschlüsselungssuite ausgehandelt wird und daher anschließend eine PSK-Authentifizierung erforderlich ist. Das „ reply “-Objekt ist der „ QNetworkReply “, der solche Verschlüsselungssuiten aushandelt.

Bei Verwendung von PSK muss der Client dem Server eine gültige Identität und einen gültigen vorab geteilten Schlüssel senden, damit der SSL-Handshake fortgesetzt werden kann. Anwendungen können diese Informationen in einem mit diesem Signal verbundenen Slot bereitstellen, indem sie das übergebene „ authenticator “-Objekt entsprechend ihren Anforderungen ausfüllen.

Siehe auch „ QSslPreSharedKeyAuthenticator “.

QNetworkProxy QNetworkAccessManager::proxy() const

Gibt den „ QNetworkProxy “ zurück, den die mit diesem „ QNetworkAccessManager “-Objekt gesendeten Anfragen verwenden werden. Der Standardwert für den Proxy lautet QNetworkProxy::DefaultProxy.

Siehe auch setProxy(), setProxyFactory() und proxyAuthenticationRequired().

[signal] void QNetworkAccessManager::proxyAuthenticationRequired(const QNetworkProxy &proxy, QAuthenticator *authenticator)

Dieses Signal wird immer dann ausgegeben, wenn ein Proxy eine Authentifizierung anfordert und „ QNetworkAccessManager “ keine gültigen, zwischengespeicherten Anmeldedaten finden kann. Der mit diesem Signal verbundene Slot sollte die Anmeldedaten für den Proxy „ proxy “ im Objekt „ authenticator “ eintragen.

QNetworkAccessManager QNetworkAccessManager speichert die Anmeldedaten intern im Cache. Wenn der Proxy das nächste Mal eine Authentifizierung anfordert, sendet automatisch dieselben Anmeldedaten, ohne das Signal „proxyAuthenticationRequired“ erneut auszulösen.

Wenn der Proxy die Anmeldedaten ablehnt, sendet „ QNetworkAccessManager “ das Signal erneut aus.

Siehe auch „ proxy()“, „ setProxy()“ und „ authenticationRequired()“.

QNetworkProxyFactory *QNetworkAccessManager::proxyFactory() const

Gibt die Proxy-Factory zurück, die dieses „ QNetworkAccessManager “-Objekt verwendet, um die für Anfragen zu verwendenden Proxys zu ermitteln.

Beachten Sie, dass der von dieser Funktion zurückgegebene Zeiger von ` QNetworkAccessManager ` verwaltet wird und jederzeit gelöscht werden könnte.

Siehe auch „ setProxyFactory()“ und „ proxy()“.

QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, QIODevice *data)

Lädt den Inhalt von data an die Zieladresse request hoch und gibt ein neues QNetworkReply -Objekt zurück, das für die Antwort geöffnet ist.

data muss beim Aufruf dieser Funktion zum Lesen geöffnet sein und muss gültig bleiben, bis das Signal ` finished()` für diese Antwort ausgegeben wird.

Ob aus dem zurückgegebenen Objekt Daten gelesen werden können, hängt vom jeweiligen Protokoll ab. Bei HTTP sendet der Server möglicherweise eine kleine HTML-Seite, die angibt, ob der Upload erfolgreich war (oder nicht). Andere Protokolle enthalten in ihren Antworten wahrscheinlich Inhalte.

Siehe auch get(), post(), deleteResource() und sendCustomRequest().

QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, QHttpMultiPart *multiPart)

Sendet den Inhalt der Nachricht „ multiPart “ an das unter „ request “ angegebene Ziel.

Dies kann zum Versenden von MIME-Multipart-Nachrichten über HTTP verwendet werden.

Siehe auch QHttpMultiPart, QHttpPart und post().

QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, const QByteArray &data)

Sendet den Inhalt des Byte-Arrays „ data “ an das durch „ request “ angegebene Ziel.

[since 6.8] QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, std::nullptr_t nptr)

Sendet die durch ` request ` angegebene PUT-Anfrage ohne Body und gibt ein neues ` QNetworkReply `-Objekt zurück.

Diese Funktion wurde in Qt 6.8 eingeführt.

QNetworkRequest::RedirectPolicy QNetworkAccessManager::redirectPolicy() const

Gibt die Umleitungsrichtlinie zurück, die beim Erstellen neuer Anfragen verwendet wird.

Siehe auch ` setRedirectPolicy()` und ` QNetworkRequest::RedirectPolicy`.

QNetworkReply *QNetworkAccessManager::sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, QIODevice *data = nullptr)

Sendet eine benutzerdefinierte Anfrage an den Server, der durch die URL „ request “ identifiziert wird.

verb Es liegt in der Verantwortung des Benutzers, eine Anfrage an den Server zu senden, die gemäß der HTTP-Spezifikation gültig ist.

Diese Methode bietet die Möglichkeit, andere Verben als die üblichen zu senden, die über „ get()“ oder „ post()“ usw. bereitgestellt werden, beispielsweise das Senden eines HTTP-OPTIONS-Befehls.

Ist ` data ` nicht leer, wird der Inhalt des Geräts ` data ` auf den Server hochgeladen; in diesem Fall müssen die Daten zum Lesen offen sein und gültig bleiben, bis für diese Antwort das Signal ` finished()` ausgegeben wird.

Siehe auch „ get()“, „ post()“, „ put()“ und „ deleteResource()“.

QNetworkReply *QNetworkAccessManager::sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, QHttpMultiPart *multiPart)

Sendet eine benutzerdefinierte Anfrage an den Server, der durch die URL request identifiziert wird.

Sendet den Inhalt der Nachricht „ multiPart “ an das unter request angegebene Ziel.

Dies kann zum Senden von MIME-Multipart-Nachrichten für benutzerdefinierte Verben verwendet werden.

Siehe auch „ QHttpMultiPart“ , „ QHttpPart “ und „ put()“.

QNetworkReply *QNetworkAccessManager::sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, const QByteArray &data)

Sendet den Inhalt des Byte-Arrays „ data “ an das durch „ request “ angegebene Ziel.

void QNetworkAccessManager::setAutoDeleteReplies(bool shouldAutoDelete)

Aktiviert oder deaktiviert das automatische Löschen von „ QNetworkReplies “.

Die Einstellung von „ shouldAutoDelete “ auf „true“ entspricht der Einstellung des Attributs „ QNetworkRequest::AutoDeleteReplyOnFinishAttribute “ auf „true“ für alle zukünftigen „ QNetworkRequests “, die an diese Instanz von „ QNetworkAccessManager “ übergeben werden, es sei denn, das Attribut wurde bereits explizit auf dem „ QNetworkRequest “ gesetzt.

Siehe auch autoDeleteReplies und QNetworkRequest::AutoDeleteReplyOnFinishAttribute.

void QNetworkAccessManager::setCache(QAbstractNetworkCache *cache)

Legt den Netzwerk-Cache des Managers auf das angegebene „ cache “ fest. Der Cache wird für alle vom Manager versendeten Anfragen verwendet.

Verwenden Sie diese Funktion, um das Netzwerk-Cache-Objekt auf eine Klasse festzulegen, die zusätzliche Funktionen implementiert, wie beispielsweise das Speichern der Cookies in einem permanenten Speicher.

QNetworkAccessManager Standardmäßig verfügt der Manager über keinen festgelegten Cache. Qt stellt einen einfachen Festplatten-Cache bereit, „ QNetworkDiskCache “, der verwendet werden kann.

Siehe auch ` cache()` und ` QNetworkRequest::CacheLoadControl`.

void QNetworkAccessManager::setCookieJar(QNetworkCookieJar *cookieJar)

Legt die „Cookie-Jar“ des Managers auf die angegebene „ cookieJar “ fest. Die „Cookie-Jar“ wird von allen vom Manager versendeten Anfragen verwendet.

Verwenden Sie diese Funktion, um das Cookie-Jar-Objekt auf eine Klasse festzulegen, die zusätzliche Funktionen implementiert, wie beispielsweise das Speichern der Cookies in einem permanenten Speicher.

Befindet sich „ cookieJar “ im selben Thread wie dieses „ QNetworkAccessManager “-Objekt, legt es das übergeordnete Element von „ cookieJar “ so fest, dass das Cookie-Jar gelöscht wird, sobald dieses Objekt ebenfalls gelöscht wird. Wenn Sie Cookie-Jars zwischen verschiedenen „ QNetworkAccessManager “-Objekten gemeinsam nutzen möchten, sollten Sie das übergeordnete Element des Cookie-Jars nach dem Aufruf dieser Funktion auf 0 setzen.

QNetworkAccessManager Standardmäßig implementiert „cookieJar“ keine eigene Cookie-Richtlinie: Es akzeptiert alle vom Server gesendeten Cookies, solange diese korrekt formatiert sind und die Mindestsicherheitsanforderungen erfüllen (die Cookie-Domäne stimmt mit der der Anfrage überein und der Cookie-Pfad stimmt mit dem der Anfrage überein). Um eine eigene Sicherheitsrichtlinie zu implementieren, überschreiben Sie die virtuellen Funktionen „ QNetworkCookieJar::cookiesForUrl()“ und „ QNetworkCookieJar::setCookiesFromUrl()“. Diese Funktionen werden von ` QNetworkAccessManager ` aufgerufen, wenn ein neues Cookie erkannt wird.

Siehe auch cookieJar(), QNetworkCookieJar::cookiesForUrl() und QNetworkCookieJar::setCookiesFromUrl().

void QNetworkAccessManager::setProxy(const QNetworkProxy &proxy)

Legt fest, dass bei zukünftigen Anfragen der Proxy proxy verwendet wird. Dies hat keine Auswirkungen auf bereits gesendete Anfragen. Das Signal „ proxyAuthenticationRequired()“ wird ausgelöst, wenn der Proxy eine Authentifizierung verlangt.

Ein mit dieser Funktion festgelegter Proxy wird für alle von QNetworkAccessManager ausgegebenen Anfragen verwendet. In manchen Fällen kann es erforderlich sein, je nach Art der gesendeten Anfrage oder des Zielhosts unterschiedliche Proxys auszuwählen. In diesem Fall sollten Sie die Verwendung von setProxyFactory() in Betracht ziehen.

Siehe auch proxy() und proxyAuthenticationRequired().

void QNetworkAccessManager::setProxyFactory(QNetworkProxyFactory *factory)

Legt die Proxy-Factory für diese Klasse auf „ factory “ fest. Eine Proxy-Factory wird verwendet, um eine spezifischere Liste von Proxys zu ermitteln, die für eine bestimmte Anfrage verwendet werden sollen, anstatt zu versuchen, für alle Anfragen denselben Proxy-Wert zu verwenden.

Alle von QNetworkAccessManager gesendeten Abfragen haben den Typ „ QNetworkProxyQuery::UrlRequest “.

Beispielsweise könnte eine Proxy-Factory die folgenden Regeln anwenden:

• Wenn sich die Zieladresse im lokalen Netzwerk befindet (z. B. wenn der Hostname keine Punkte enthält oder es sich um eine IP-Adresse im Bereich der Organisation handelt), wird Folgendes zurückgegeben: QNetworkProxy::NoProxy
• Wenn es sich um eine FTP-Anfrage handelt, einen FTP-Proxy zurückgeben
• Wenn es sich um eine HTTP- oder HTTPS-Anfrage handelt, einen HTTP-Proxy zurückgeben
• ansonsten einen SOCKSv5-Proxy-Server zurückgeben

Die Lebensdauer des Objekts ` factory ` wird von ` QNetworkAccessManager` verwaltet. Es löscht das Objekt bei Bedarf.

Siehe auch „ proxyFactory()“, „ setProxy()“ und „ QNetworkProxyQuery “.

void QNetworkAccessManager::setRedirectPolicy(QNetworkRequest::RedirectPolicy policy)

Legt die Umleitungsrichtlinie des Managers so fest, dass sie dem angegebenen „ policy “ entspricht. Diese Richtlinie wirkt sich auf alle nachfolgenden Anfragen aus, die vom Manager erstellt werden.

Verwenden Sie diese Funktion, um HTTP-Weiterleitungen auf der Ebene des Managers zu aktivieren oder zu deaktivieren.

Der Standardwert ist „ QNetworkRequest::NoLessSafeRedirectPolicy “. Clients, die auf eine manuelle Umleitungsverarbeitung angewiesen sind, sollten diese Richtlinie explizit in ihrem Code festlegen.

Siehe auch ` redirectPolicy()` und ` QNetworkRequest::RedirectPolicy`.

void QNetworkAccessManager::setStrictTransportSecurityEnabled(bool enabled)

Wenn enabled auf true gesetzt ist, befolgt QNetworkAccessManager die HTTP Strict Transport Security-Richtlinie (HSTS, RFC 6797). Bei der Verarbeitung einer Anfrage ersetzt QNetworkAccessManager automatisch das Schema „http“ durch „https“ und verwendet für HSTS-Hosts einen sicheren Transport. Falls explizit festgelegt, wird Port 80 durch Port 443 ersetzt.

Wenn HSTS aktiviert ist, aktualisiert QNetworkAccessManager für jede HTTP-Antwort, die einen HSTS-Header enthält und über einen sicheren Transport empfangen wird, seinen HSTS-Cache, indem entweder ein Host mit einer gültigen Richtlinie gespeichert oder ein Host mit einer abgelaufenen oder deaktivierten HSTS-Richtlinie entfernt wird.

Siehe auch isStrictTransportSecurityEnabled().

void QNetworkAccessManager::setTransferTimeout(int timeout)

Legt „ timeout “ als Übertragungszeitlimit in Millisekunden fest.

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

[since 6.7] void QNetworkAccessManager::setTransferTimeout(std::chrono::milliseconds duration = QNetworkRequest::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. Die für die ausgeführten Anfragen festgelegten anfragespezifischen Timeouts, die ungleich Null sind, überschreiben diesen Wert. Das bedeutet: Wenn für „ QNetworkAccessManager “ ein Timeout aktiviert ist, muss dieses deaktiviert werden, um eine Anfrage ohne Timeout auszuführen.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch ` transferTimeoutAsDuration()`.

[signal] void QNetworkAccessManager::sslErrors(QNetworkReply *reply, const QList<QSslError> &errors)

Dieses Signal wird ausgelöst, wenn beim Aufbau der SSL/TLS-Sitzung Fehler aufgetreten sind, darunter auch Fehler bei der Zertifikatsprüfung. Der Parameter ` errors ` enthält die Liste der Fehler, und ` reply ` ist das ` QNetworkReply `, bei dem diese Fehler aufgetreten sind.

Um anzuzeigen, dass die Fehler nicht schwerwiegend sind und die Verbindung fortgesetzt werden soll, sollte die Funktion ` QNetworkReply::ignoreSslErrors()` aus dem mit diesem Signal verbundenen Slot aufgerufen werden. Wird sie nicht aufgerufen, wird die SSL-Sitzung beendet, bevor Daten (einschließlich der URL) ausgetauscht werden.

Dieses Signal kann verwendet werden, um dem Benutzer eine Fehlermeldung anzuzeigen, die darauf hinweist, dass die Sicherheit möglicherweise gefährdet ist, und um die SSL-Einstellungen anzuzeigen (siehe sslConfiguration(), um diese abzurufen). Wenn der Benutzer nach der Analyse des Remote-Zertifikats beschließt, fortzufahren, sollte der Slot ignoreSslErrors() aufrufen.

Siehe auch „ QSslSocket::sslErrors()“, „ QNetworkReply::sslErrors()“, „ QNetworkReply::sslConfiguration()“ und „ QNetworkReply::ignoreSslErrors()“.

QList<QHstsPolicy> QNetworkAccessManager::strictTransportSecurityHosts() const

Gibt die Liste der HTTP-Strict-Transport-Security-Richtlinien zurück. Diese Liste kann von der ursprünglich über addStrictTransportSecurityHosts() festgelegten Liste abweichen, wenn der HSTS-Cache anhand eines „Strict-Transport-Security“-Antwort-Headers aktualisiert wurde.

Siehe auch addStrictTransportSecurityHosts() und QHstsPolicy.

[virtual] QStringList QNetworkAccessManager::supportedSchemes() const

Listet alle vom Zugriffsmanager unterstützten URL-Schemas auf.

Implementieren Sie diese Methode neu, um in einer Unterklasse von ` QNetworkAccessManager ` eigene unterstützte Schemata bereitzustellen. Dies ist beispielsweise erforderlich, wenn Ihre Unterklasse Unterstützung für neue Protokolle bietet.

int QNetworkAccessManager::transferTimeout() const

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

Siehe auch ` setTransferTimeout()`.

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

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

Die Standarddauer ist Null, was bedeutet, dass kein Timeout verwendet wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

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