QNetworkCookieJar Class

Dokumentation der Mitgliedsfunktionen

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

Erzeugt ein QNetworkCookieJar-Objekt und setzt das übergeordnete Objekt auf parent.

Die Keksdose wird auf leer initialisiert.

[virtual noexcept] QNetworkCookieJar::~QNetworkCookieJar()

Zerstört dieses Cookie-Jar-Objekt und verwirft alle darin gespeicherten Cookies. In der Standardimplementierung von QNetworkCookieJar werden Cookies nicht auf der Festplatte gespeichert.

Wenn Sie die Cookies auf der Festplatte speichern möchten, müssen Sie von QNetworkCookieJar ableiten und die Cookies selbst auf der Festplatte speichern.

[protected] QList<QNetworkCookie> QNetworkCookieJar::allCookies() const

Gibt alle in diesem Cookie-Jar gespeicherten Cookies zurück. Diese Funktion eignet sich für abgeleitete Klassen zum Speichern von Cookies auf der Festplatte sowie zur Implementierung von Cookie-Ablauf- und anderen Richtlinien.

Siehe auch setAllCookies() und cookiesForUrl().

[virtual] QList<QNetworkCookie> QNetworkCookieJar::cookiesForUrl(const QUrl &url) const

Gibt die Cookies zurück, die hinzugefügt werden sollen, wenn eine Anfrage an url gesendet wird. Diese Funktion wird von der Standardfunktion QNetworkAccessManager::createRequest() aufgerufen, die die von dieser Funktion zurückgegebenen Cookies zu der gesendeten Anfrage hinzufügt.

Wenn mehr als ein Cookie mit demselben Namen, aber mit unterschiedlichen Pfaden gefunden wird, wird dasjenige mit dem längeren Pfad vor demjenigen mit dem kürzeren Pfad zurückgegeben. Mit anderen Worten: Diese Funktion gibt Cookies zurück, die absteigend nach Pfadlänge sortiert sind.

Die Standardklasse QNetworkCookieJar implementiert nur eine sehr einfache Sicherheitsrichtlinie (sie stellt sicher, dass die Domäne und der Pfad der Cookies mit denen der Antwort übereinstimmen). Um die Sicherheitsrichtlinien mit Ihren eigenen Algorithmen zu erweitern, überschreiben Sie cookiesForUrl().

Siehe auch setCookiesFromUrl() und QNetworkAccessManager::setCookieJar().

[virtual] bool QNetworkCookieJar::deleteCookie(const QNetworkCookie &cookie)

Löscht aus dem Cookie-Jar das Cookie, das den gleichen Bezeichner wie cookie hat.

Gibt true zurück, wenn ein Cookie gelöscht wurde, andernfalls false.

Siehe auch QNetworkCookie::hasSameIdentifier().

[virtual] bool QNetworkCookieJar::insertCookie(const QNetworkCookie &cookie)

Fügt cookie zu dieser Keksdose hinzu.

Gibt true zurück, wenn cookie hinzugefügt wurde, andernfalls false.

Wenn ein Cookie mit demselben Bezeichner bereits in der Keksdose vorhanden ist, wird er überschrieben.

[protected] void QNetworkCookieJar::setAllCookies(const QList<QNetworkCookie> &cookieList)

Setzt die interne Liste der Cookies, die in diesem Cookie-Jar gespeichert sind, auf cookieList. Diese Funktion ist für abgeleitete Klassen geeignet, um das Laden von Cookies aus dem permanenten Speicher oder ihre eigenen Cookie-Akzeptanzrichtlinien zu implementieren, indem sie setCookiesFromUrl() reimplementieren.

Siehe auch allCookies() und setCookiesFromUrl().

[virtual] bool QNetworkCookieJar::setCookiesFromUrl(const QList<QNetworkCookie> &cookieList, const QUrl &url)

Fügt die Cookies aus der Liste cookieList in diese Keksdose ein. Vor dem Einfügen werden die Cookies normalisiert.

Gibt true zurück, wenn ein oder mehrere Cookies für url gesetzt sind, andernfalls false.

Wenn bereits ein Cookie in der Cookie-Dose vorhanden ist, wird es durch das Cookie in cookieList überschrieben.

Die Standardklasse QNetworkCookieJar implementiert nur eine sehr einfache Sicherheitsrichtlinie (sie stellt sicher, dass die Domäne und der Pfad der Cookies mit denen der Antwort übereinstimmen). Um die Sicherheitsrichtlinie mit Ihren eigenen Algorithmen zu erweitern, überschreiben Sie setCookiesFromUrl().

Außerdem gibt es auf QNetworkCookieJar keine maximale Größe des Cookie-Behälters. Implementieren Sie diese Funktion neu, um ältere Cookies zu verwerfen und Platz für neue zu schaffen.

Siehe auch cookiesForUrl(), QNetworkAccessManager::setCookieJar(), und QNetworkCookie::normalize().

[virtual] bool QNetworkCookieJar::updateCookie(const QNetworkCookie &cookie)

Wenn ein Cookie mit der gleichen Kennung wie cookie in dieser Cookie-Dose existiert, wird es aktualisiert. Diese Funktion verwendet insertCookie().

Gibt true zurück, wenn cookie aktualisiert wurde, false, wenn kein Cookie in der Jar mit dem Bezeichner von cookie übereinstimmt.

Siehe auch QNetworkCookie::hasSameIdentifier().

[virtual protected] bool QNetworkCookieJar::validateCookie(const QNetworkCookie &cookie, const QUrl &url) const

Gibt true zurück, wenn die Domäne und der Pfad von cookie gültig sind, andernfalls false. Der Parameter url wird verwendet, um festzustellen, ob die im Cookie angegebene Domäne zulässig ist.