QNetworkCookie Class

Dokumentation der Mitgliedsfunktionen

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

Erstellen Sie ein neues QNetworkCookie-Objekt, indem Sie den Cookie-Namen auf name und seinen Wert auf value initialisieren.

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

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

Erzeugt ein neues QNetworkCookie-Objekt, indem der Inhalt von other kopiert wird.

[noexcept] QNetworkCookie::~QNetworkCookie()

Zerstört dieses QNetworkCookie Objekt.

QString QNetworkCookie::domain() const

Gibt die Domäne zurück, der dieses Cookie zugeordnet ist. Dies entspricht dem Feld "domain" des Cookie-Strings.

Beachten Sie, dass die Domain hier mit einem Punkt beginnen kann, was kein gültiger Hostname ist. Es 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 für dieses Cookie zurück. Handelt es sich bei diesem Cookie um einen Sitzungscookie, ist die zurückgegebene QDateTime nicht gültig. Liegt das Datum in der Vergangenheit, ist dieser Cookie bereits abgelaufen und sollte nicht erneut an einen entfernten Server zurückgesendet werden.

Das Verfallsdatum entspricht den Parametern des "expires"-Eintrags im Cookie-String.

Siehe auch isSessionCookie() und setExpirationDate().

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

Gibt true zurück, wenn dieser Cookie das gleiche Bezeichner-Tupel wie other hat. Das Bezeichner-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 nur über die Netzwerkanfragen und -antworten gesetzt und abgerufen, d. h. über das HTTP-Protokoll. Es ist für Skripte, die auf Browsern laufen, nicht zugänglich.

Siehe auch isSecure().

bool QNetworkCookie::isSecure() const

Gibt true zurück, wenn die Option "secure" im Cookie-String angegeben wurde, andernfalls false.

Sichere Cookies können private Informationen enthalten und sollten nicht über unverschlüsselte Verbindungen weitergesendet werden.

Siehe auch setSecure().

bool QNetworkCookie::isSessionCookie() const

Gibt true zurück, wenn dieses Cookie ein Sitzungscookie ist. Ein Sitzungscookie ist ein Cookie, das kein Ablaufdatum hat, was bedeutet, dass es verworfen werden sollte, wenn das Konzept der Sitzung der Anwendung vorbei ist (normalerweise, wenn die Anwendung beendet wird).

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 den er nicht als gültig angesehen wird.

Siehe auch setName() und value().

void QNetworkCookie::normalize(const QUrl &url)

Diese Funktion normalisiert den Pfad und die Domäne des Cookies, wenn diese zuvor leer waren. Der Parameter url wird verwendet, um die richtige Domäne und den richtigen Pfad zu ermitteln.

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

Analysiert die Cookie-Zeichenkette cookieString, wie sie von einer Serverantwort im "Set-Cookie:"-Header empfangen wurde. Bei einem Fehler beim Parsen gibt diese Funktion eine leere Liste zurück.

Da der HTTP-Header mehr als ein Cookie gleichzeitig setzen kann, gibt diese Funktion eine QList<QNetworkCookie> zurück, eine für jedes Cookie, das geparst wird.

Siehe auch toRawForm().

QString QNetworkCookie::path() const

Gibt den mit diesem Cookie verbundenen Pfad zurück. Dies entspricht dem Feld "path" des Cookie-Strings.

Siehe auch setPath().

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

Gibt die Option "SameSite" zurück, wenn sie im Cookie-String angegeben ist, oder SameSite::Default, wenn sie nicht vorhanden ist.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch setSameSitePolicy().

void QNetworkCookie::setDomain(const QString &domain)

Setzt die mit diesem Cookie verbundene Domain auf domain.

Siehe auch domain().

void QNetworkCookie::setExpirationDate(const QDateTime &date)

Setzt das Ablaufdatum dieses Cookies auf date. Wenn Sie diesem Cookie ein ungültiges Ablaufdatum zuweisen, bedeutet dies, dass es sich um ein Sitzungscookie handelt.

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)

Setzt den Namen dieses Cookies auf cookieName. Beachten Sie, dass das Setzen eines Cookie-Namens auf ein leeres QByteArray dieses Cookie ungültig macht.

Siehe auch name() und value().

void QNetworkCookie::setPath(const QString &path)

Setzt den mit diesem Cookie verbundenen Pfad auf path.

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 private Informationen enthalten und sollten nicht über unverschlüsselte Verbindungen weitergesendet 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)

Tauscht diesen Cookie mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

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

Gibt die Rohform dieser QNetworkCookie zurück. Die von dieser Funktion zurückgegebene QByteArray eignet sich für einen HTTP-Header, entweder in einer Server-Antwort (der Set-Cookie-Header) oder in der Client-Anfrage (der Cookie-Header). Sie können eines von zwei Formaten wählen, indem Sie form verwenden.

Siehe auch parseCookies().

QByteArray QNetworkCookie::value() const

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

Cookie-Name-Wert-Paare werden als undurchsichtig für die Anwendung betrachtet: 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 dieser Cookie nicht gleich other ist.

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 dieser Cookie gleich other ist. Diese Funktion gibt true nur zurück, wenn alle Felder des Cookies gleich sind.

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

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