QNetworkCookie Class

Dokumentation der Mitgliedsfunktionen

[explicit] QNetworkCookie::QNetworkCookie(const QByteArray &name = QByteArray(), const QByteArray &value = QByteArray())

Erstellen Sie ein neues QNetworkCookie-Objekt, wobei der Name des Cookies auf „ name “ und dessen Wert auf „ value “ gesetzt wird.

Ein Cookie ist nur gültig, wenn es einen Namen hat. Der Wert ist für die Anwendung jedoch undurchsichtig und kann, wenn er leer ist, für den Remote-Server von Bedeutung sein.

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

Erstellt ein neues QNetworkCookie-Objekt, indem der Inhalt von „ other “ kopiert wird.

[noexcept] QNetworkCookie::~QNetworkCookie()

Löscht dieses „ QNetworkCookie “-Objekt.

QString QNetworkCookie::domain() const

Gibt die Domäne zurück, der dieses Cookie zugeordnet ist. Dies entspricht dem Feld „domain“ der Cookie-Zeichenkette.

Beachten Sie, dass die Domäne hier mit einem Punkt beginnen kann, der kein gültiger Hostname ist. Dies bedeutet jedoch, dass dieses Cookie mit allen Hostnamen übereinstimmt, die mit diesem Domänennamen enden.

Siehe auch ` setDomain()`.

QDateTime QNetworkCookie::expirationDate() const

Gibt das Ablaufdatum dieses Cookies zurück. Handelt es sich bei diesem Cookie um ein Sitzungscookie, ist der zurückgegebene Wert „ QDateTime “ ungültig. Liegt das Datum in der Vergangenheit, ist dieses Cookie bereits abgelaufen und sollte nicht erneut an einen Remote-Server gesendet werden.

Das Ablaufdatum entspricht den Parametern des Eintrags „expires“ in der Cookie-Zeichenkette.

Siehe auch isSessionCookie() und setExpirationDate().

bool QNetworkCookie::hasSameIdentifier(const QNetworkCookie &other) const

Gibt „ true “ zurück, wenn dieses Cookie dasselbe Identifikator-Tupel wie „ other “ aufweist. Das Identifikator-Tupel setzt sich aus dem Namen, der Domäne und dem Pfad zusammen.

Siehe auch operator==().

bool QNetworkCookie::isHttpOnly() const

Gibt „ true “ zurück, wenn das „HttpOnly“-Flag für dieses Cookie aktiviert ist.

Ein „HttpOnly“-Cookie wird ausschließlich über Netzwerkanfragen und -antworten, d. h. über das HTTP-Protokoll, gesetzt und abgerufen. Es ist für Skripte, die im Browser ausgeführt werden, nicht zugänglich.

Siehe auch isSecure().

bool QNetworkCookie::isSecure() const

Gibt „ true “ zurück, wenn die Option „secure“ in der Cookie-Zeichenkette angegeben wurde, andernfalls „false“.

Sichere Cookies können vertrauliche Informationen enthalten und sollten nicht über unverschlüsselte Verbindungen erneut gesendet werden.

Siehe auch setSecure().

bool QNetworkCookie::isSessionCookie() const

Gibt „ true “ zurück, wenn es sich bei diesem Cookie um ein Sitzungscookie handelt. Ein Sitzungscookie ist ein Cookie ohne Ablaufdatum, was bedeutet, dass es gelöscht werden sollte, sobald die von der Anwendung definierte Sitzung beendet ist (in der Regel beim Beenden der Anwendung).

Siehe auch expirationDate() und setExpirationDate().

QByteArray QNetworkCookie::name() const

Gibt den Namen dieses Cookies zurück. Das einzige Pflichtfeld eines Cookies ist sein Name; ohne diesen gilt es als ungültig.

Siehe auch setName() und value().

void QNetworkCookie::normalize(const QUrl &url)

Diese Funktion normalisiert den Pfad und die Domäne des Cookies, falls diese zuvor leer waren. Der Parameter „ url “ wird verwendet, um die korrekte Domäne und den korrekten Pfad zu ermitteln.

[static] QList<QNetworkCookie> QNetworkCookie::parseCookies(QByteArrayView cookieString)

Analysiert die Cookie-Zeichenkette „ cookieString “, wie sie in der Serverantwort im „Set-Cookie:“-Header empfangen wurde. Bei einem Analysefehler gibt diese Funktion eine leere Liste zurück.

Da der HTTP-Header mehrere Cookies gleichzeitig setzen kann, gibt diese Funktion ein QList<QNetworkCookie> zurück, und zwar eines für jedes analysierte Cookie.

Siehe auch ` toRawForm()`.

QString QNetworkCookie::path() const

Gibt den diesem Cookie zugeordneten Pfad zurück. Dieser entspricht dem Feld „path“ der Cookie-Zeichenkette.

Siehe auch setPath().

[since 6.1] QNetworkCookie::SameSite QNetworkCookie::sameSitePolicy() const

Gibt die Option „SameSite “ zurück, sofern sie in der Cookie-Zeichenkette angegeben ist; andernfalls „ SameSite::Default “.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch setSameSitePolicy().

void QNetworkCookie::setDomain(const QString &domain)

Legt die diesem Cookie zugeordnete Domäne auf „ domain “ fest.

Siehe auch domain().

void QNetworkCookie::setExpirationDate(const QDateTime &date)

Legt das Ablaufdatum dieses Cookies auf „ date “ fest. Wird für dieses Cookie ein ungültiges Ablaufdatum festgelegt, handelt es sich um ein Sitzungscookie.

Siehe auch isSessionCookie() und expirationDate().

void QNetworkCookie::setHttpOnly(bool enable)

Setzt das „HttpOnly“-Flag dieses Cookies auf „ enable “.

Siehe auch isHttpOnly().

void QNetworkCookie::setName(const QByteArray &cookieName)

Legt den Namen dieses Cookies auf „ cookieName “ fest. Beachten Sie, dass die Festlegung eines leeren Cookie-Namens („ QByteArray “) dazu führt, dass dieses Cookie ungültig wird.

Siehe auch name() und value().

void QNetworkCookie::setPath(const QString &path)

Legt den mit diesem Cookie verknüpften Pfad auf path fest.

Siehe auch path().

[since 6.1] void QNetworkCookie::setSameSitePolicy(QNetworkCookie::SameSite sameSite)

Setzt die Option „SameSite “ dieses Cookies auf „ sameSite “.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch sameSitePolicy().

void QNetworkCookie::setSecure(bool enable)

Setzt das Sicherheitsflag dieses Cookies auf „ enable “.

Sichere Cookies können vertrauliche Informationen enthalten und sollten nicht über unverschlüsselte Verbindungen erneut gesendet werden.

Siehe auch isSecure().

void QNetworkCookie::setValue(const QByteArray &value)

Setzt den Wert dieses Cookies auf „ value “.

Siehe auch value() und name().

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

Ersetzt dieses Cookie durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QByteArray QNetworkCookie::toRawForm(QNetworkCookie::RawForm form = Full) const

Gibt die Rohdaten dieses „ QNetworkCookie “ zurück. Das von dieser Funktion zurückgegebene „ QByteArray “ eignet sich für einen HTTP-Header, entweder in einer Serverantwort (dem „Set-Cookie“-Header) oder in einer Client-Anfrage (dem „Cookie“-Header). Sie können mithilfe von „ form “ zwischen zwei Formaten wählen.

Siehe auch parseCookies().

QByteArray QNetworkCookie::value() const

Gibt den Wert dieses Cookies zurück, wie er in der Cookie-Zeichenkette angegeben ist. Beachten Sie, dass ein Cookie auch dann noch gültig ist, wenn sein Wert leer ist.

Cookie-Name-Wert-Paare gelten für die Anwendung als undurchsichtig: Das heißt, ihre Werte haben keine Bedeutung.

Siehe auch setValue() und name().

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

Gibt „ true “ zurück, wenn dieses Cookie nicht mit „ other “ übereinstimmt.

Siehe auch operator==().

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

Kopiert den Inhalt des Objekts „ QNetworkCookie “ other in dieses Objekt.

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

Gibt „ true “ zurück, wenn dieses Cookie mit „ other “ übereinstimmt. Diese Funktion gibt nur dann „ true “ zurück, wenn alle Felder des Cookies identisch sind.

In manchen Kontexten können jedoch zwei Cookies mit demselben Namen als identisch angesehen werden.

Siehe auch operator!=() und hasSameIdentifier().