QNetworkCookieJar Class

Dokumentation zu Member-Funktionen

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

Erstellt ein QNetworkCookieJar-Objekt und legt „ parent “ als übergeordnetes Objekt fest.

Das Cookie-Jar wird als leeres Objekt initialisiert.

[virtual noexcept] QNetworkCookieJar::~QNetworkCookieJar()

Löscht 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üssen, müssen Sie eine Klasse ableiten, die von ` QNetworkCookieJar ` abgeleitet ist, und die Cookies selbst auf der Festplatte speichern.

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

Gibt alle in diesem Cookie-Speicher abgelegten Cookies zurück. Diese Funktion eignet sich für abgeleitete Klassen, um Cookies auf der Festplatte zu speichern sowie die Gültigkeitsdauer von Cookies und andere Richtlinien zu implementieren.

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 der zu sendenden Anfrage hinzufügt.

Werden mehrere Cookies mit demselben Namen, aber unterschiedlichen Pfaden gefunden, wird das Cookie mit dem längeren Pfad vor dem mit dem kürzeren Pfad zurückgegeben. Mit anderen Worten: Diese Funktion gibt die Cookies nach absteigender Pfadlänge sortiert zurück.

Die Standardklasse „ QNetworkCookieJar “ implementiert nur eine sehr grundlegende Sicherheitsrichtlinie (sie stellt sicher, dass die Domain und der Pfad der Cookies mit denen der Antwort übereinstimmen). Um die Sicherheitsrichtlinie mit eigenen Algorithmen zu erweitern, überschreiben Sie die Methode `cookiesForUrl()`.

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

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

Löscht das Cookie aus dem Cookie-Speicher, dessen Kennung mit der von cookie übereinstimmt.

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 diesem Cookie-Speicher hinzu.

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

Wenn bereits ein Cookie mit derselben Kennung im Cookie-Speicher vorhanden ist, wird dieses überschrieben.

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

Legt die interne Liste der von diesem „Cookie Jar“ gespeicherten Cookies auf „ cookieList “ fest. Diese Funktion eignet sich für abgeleitete Klassen, um das Laden von Cookies aus dem permanenten Speicher oder ihre eigenen Richtlinien zur Cookie-Akzeptanz zu implementieren, indem sie die Funktion „ setCookiesFromUrl()“ neu implementieren.

Siehe auch allCookies() und setCookiesFromUrl().

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

Fügt die Cookies aus der Liste „ cookieList “ zu diesem Cookie-Speicher hinzu. 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 ein Cookie bereits im Cookie-Speicher vorhanden ist, wird es durch die Cookies aus „ cookieList “ überschrieben.

Die Standardklasse „ QNetworkCookieJar “ implementiert nur eine sehr grundlegende Sicherheitsrichtlinie (sie stellt sicher, dass die Domain und der Pfad der Cookies mit denen der Antwort übereinstimmen). Um die Sicherheitsrichtlinie mit eigenen Algorithmen zu erweitern, überschreiben Sie die Methode „setCookiesFromUrl()“.

Außerdem gibt es bei ` QNetworkCookieJar ` keine maximale Größe für den Cookie-Speicher. Implementieren Sie diese Funktion neu, um ältere Cookies zu löschen und Platz für neue zu schaffen.

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

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

Wenn in diesem Cookie-Speicher ein Cookie mit derselben Kennung wie cookie vorhanden ist, wird es aktualisiert. Diese Funktion verwendet insertCookie().

Gibt „ true “ zurück, wenn „ cookie “ aktualisiert wurde, andernfalls „false“, wenn kein Cookie im Speicher die Kennung von „ cookie “ aufweist.

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.