QNetworkCookie Class

Documentation des fonctions membres

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

Créez un nouvel objet QNetworkCookie en initialisant le nom du cookie à « name » et sa valeur à « value ».

Un cookie n'est valide que s'il possède un nom. Cependant, la valeur est opaque pour l'application et le fait qu'elle soit vide peut avoir une signification pour le serveur distant.

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

Crée un nouvel objet QNetworkCookie en copiant le contenu de other.

[noexcept] QNetworkCookie::~QNetworkCookie()

Supprime cet objet « QNetworkCookie ».

QString QNetworkCookie::domain() const

Renvoie le domaine auquel ce cookie est associé. Cela correspond au champ « domain » de la chaîne de caractères du cookie.

Notez que le domaine peut ici commencer par un point, ce qui n'est pas un nom d'hôte valide. Cela signifie toutefois que ce cookie correspond à tous les noms d'hôtes se terminant par ce nom de domaine.

Voir également setDomain().

QDateTime QNetworkCookie::expirationDate() const

Renvoie la date d'expiration de ce cookie. Si ce cookie est un cookie de session, l'QDateTime e renvoyée ne sera pas valide. Si la date est antérieure à la date du système, ce cookie a déjà expiré et ne doit plus être envoyé à un serveur distant.

La date d'expiration correspond aux paramètres de l'entrée « expires » dans la chaîne du cookie.

Voir également isSessionCookie() et setExpirationDate().

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

Renvoie « true » si ce cookie possède le même tuple d'identificateurs que « other ». Le tuple d'identificateurs est composé du nom, du domaine et du chemin d'accès.

Voir également operator==().

bool QNetworkCookie::isHttpOnly() const

Renvoie true si l'indicateur « HttpOnly » est activé pour ce cookie.

Un cookie « HttpOnly » n’est défini et récupéré que par les requêtes et réponses réseau, c’est-à-dire via le protocole HTTP. Il n’est pas accessible depuis les scripts s’exécutant dans les navigateurs.

Voir également isSecure().

bool QNetworkCookie::isSecure() const

Renvoie « true » si l'option « secure » a été spécifiée dans la chaîne du cookie, sinon renvoie « false ».

Les cookies sécurisés peuvent contenir des informations confidentielles et ne doivent pas être retransmis via des connexions non chiffrées.

Voir également setSecure().

bool QNetworkCookie::isSessionCookie() const

Renvoie true si ce cookie est un cookie de session. Un cookie de session est un cookie qui n'a pas de date d'expiration, ce qui signifie qu'il doit être supprimé lorsque la session, telle que définie par l'application, prend fin (généralement, à la fermeture de l'application).

Voir également expirationDate() et setExpirationDate().

QByteArray QNetworkCookie::name() const

Renvoie le nom de ce cookie. Le seul champ obligatoire d'un cookie est son nom ; sans celui-ci, il n'est pas considéré comme valide.

Voir également setName() et value().

void QNetworkCookie::normalize(const QUrl &url)

Cette fonction normalise le chemin d'accès et le domaine du cookie s'ils étaient auparavant vides. Le paramètre ` url ` sert à déterminer le domaine et le chemin d'accès corrects.

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

Analyse la chaîne de caractères du cookie cookieString telle qu'elle est reçue dans l'en-tête « Set-Cookie: » d'une réponse du serveur. En cas d'erreur d'analyse, cette fonction renvoie une liste vide.

Étant donné que l'en-tête HTTP peut définir plusieurs cookies à la fois, cette fonction renvoie une liste QList<QNetworkCookie>, contenant un élément pour chaque cookie analysé.

Voir aussi ` toRawForm()`.

QString QNetworkCookie::path() const

Renvoie le chemin associé à ce cookie. Cela correspond au champ « path » de la chaîne de caractères du cookie.

Voir également setPath().

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

Renvoie l'option «SameSite » si elle est spécifiée dans la chaîne du cookie, ou « SameSite::Default » si elle n'est pas présente.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi setSameSitePolicy().

void QNetworkCookie::setDomain(const QString &domain)

Définit le domaine associé à ce cookie sur domain.

Voir également domain().

void QNetworkCookie::setExpirationDate(const QDateTime &date)

Définit la date d'expiration de ce cookie sur date. Si vous attribuez une date d'expiration non valide à ce cookie, cela signifiera qu'il s'agit d'un cookie de session.

Voir également isSessionCookie() et expirationDate().

void QNetworkCookie::setHttpOnly(bool enable)

Définit l'indicateur « HttpOnly » de ce cookie sur « enable ».

Voir également isHttpOnly().

void QNetworkCookie::setName(const QByteArray &cookieName)

Définit le nom de ce cookie sur « cookieName ». Notez que si vous attribuez à un cookie un nom vide ( QByteArray ), celui-ci sera invalidé.

Voir également name() et value().

void QNetworkCookie::setPath(const QString &path)

Définit le chemin d'accès associé à ce cookie sur path.

Voir également path().

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

Définit la valeur de l'option «SameSite » de ce cookie sur « sameSite ».

Cette fonction a été introduite dans Qt 6.1.

Voir également sameSitePolicy().

void QNetworkCookie::setSecure(bool enable)

Définit l'indicateur de sécurité de ce cookie sur « enable ».

Les cookies sécurisés peuvent contenir des informations confidentielles et ne doivent pas être retransmis via des connexions non chiffrées.

Voir également isSecure().

void QNetworkCookie::setValue(const QByteArray &value)

Définit la valeur de ce cookie sur « value ».

Voir également value() et name().

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

Remplace ce cookie par other. Cette opération est très rapide et ne pose jamais de problème.

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

Renvoie la forme brute de cet QNetworkCookie. L'QByteArray e renvoyé par cette fonction est adapté à un en-tête HTTP, que ce soit dans une réponse du serveur (l'en-tête Set-Cookie) ou dans la requête du client (l'en-tête Cookie). Vous pouvez choisir l'un des deux formats, à l'aide de form.

Voir également parseCookies().

QByteArray QNetworkCookie::value() const

Renvoie la valeur de ce cookie, telle qu'elle est spécifiée dans la chaîne de caractères du cookie. Notez qu'un cookie reste valide même si sa valeur est vide.

Les paires nom-valeur des cookies sont considérées comme opaques pour l'application : en d'autres termes, leurs valeurs n'ont aucune signification.

Voir également setValue() et name().

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

Renvoie « true » si ce cookie n'est pas égal à « other ».

Voir également operator==().

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

Copie le contenu de l'objet QNetworkCookie other vers cet objet.

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

Renvoie « true » si ce cookie est identique à « other ». Cette fonction ne renvoie « true » que si tous les champs du cookie sont identiques.

Cependant, dans certains contextes, deux cookies portant le même nom peuvent être considérés comme identiques.

Voir aussi operator!=() et hasSameIdentifier().