              
QNetworkCookie Class Reference |
| enum | RawForm { NameAndValueOnly, Full } |
Public Functions
| QNetworkCookie ( const QByteArray & name = QByteArray(), const QByteArray & value = QByteArray() ) | |
| QNetworkCookie ( const QNetworkCookie & other ) | |
| ~QNetworkCookie () | |
| QString | domain () const |
| QDateTime | expirationDate () const |
| bool | isHttpOnly () const |
| bool | isSecure () const |
| bool | isSessionCookie () const |
| QByteArray | name () const |
| QString | path () const |
| void | setDomain ( const QString & domain ) |
| void | setExpirationDate ( const QDateTime & date ) |
| void | setHttpOnly ( bool enable ) |
| void | setName ( const QByteArray & cookieName ) |
| void | setPath ( const QString & path ) |
| void | setSecure ( bool enable ) |
| void | setValue ( const QByteArray & value ) |
| QByteArray | toRawForm ( RawForm form = Full ) const |
| QByteArray | value () const |
| bool | operator!= ( const QNetworkCookie & other ) const |
| QNetworkCookie & | operator= ( const QNetworkCookie & other ) |
| bool | operator== ( const QNetworkCookie & other ) const |
Static Public Members
| QList<QNetworkCookie> | parseCookies ( const QByteArray & cookieString ) |
Detailed Description
The QNetworkCookie class holds one network cookie.
Cookies are small bits of information that stateless protocols like HTTP use to maintain some persistent information across requests.
A cookie is set by a remote server when it replies to a request and it expects the same cookie to be sent back when further requests are sent.
QNetworkCookie holds one such cookie as received from the network. A cookie has a name and a value, but those are opaque to the application (that is, the information stored in them has no meaning to the application). A cookie has an associated path name and domain, which indicate when the cookie should be sent again to the server.
A cookie can also have an expiration date, indicating its validity. If the expiration date is not present, the cookie is considered a "session cookie" and should be discarded when the application exits (or when its concept of session is over).
QNetworkCookie provides a way of parsing a cookie from the HTTP header format using the QNetworkCookie::parseCookies() function. However, when received in a QNetworkReply, the cookie is already parsed.
This class implements cookies as described by the initial cookie specification by Netscape, which is somewhat similar to the RFC 2109 specification, plus the "HttpOnly" extension. The more recent RFC 2965 specification (which uses the Set-Cookie2 header) is not supported.
See also QNetworkCookieJar, QNetworkRequest, and QNetworkReply.
Member Type Documentation
enum QNetworkCookie::RawForm
This enum is used with the toRawForm() function to declare which form of a cookie shall be returned.
| Constant | Value | Description |
|---|---|---|
| QNetworkCookie::NameAndValueOnly | 0 | makes toRawForm() return only the "NAME=VALUE" part of the cookie, as suitable for sending back to a server in a client request's "Cookie:" header. Multiple cookies are separated by a semi-colon in the "Cookie:" header field. |
| QNetworkCookie::Full | 1 | makes toRawForm() return the full cookie contents, as suitable for sending to a client in a server's "Set-Cookie:" header. Multiple cookies are separated by commas in a "Set-Cookie:" header. |
Note that only the Full form of the cookie can be parsed back into its original contents.
See also toRawForm() and parseCookies().
Member Function Documentation
QNetworkCookie::QNetworkCookie ( const QByteArray & name = QByteArray(), const QByteArray & value = QByteArray() )
Create a new QNetworkCookie object, initializing the cookie name to name and its value to value.
A cookie is only valid if it has a name. However, the value is opaque to the application and being empty may have significance to the remote server.
QNetworkCookie::QNetworkCookie ( const QNetworkCookie & other )
Creates a new QNetworkCookie object by copying the contents of other.
QNetworkCookie::~QNetworkCookie ()
Destroys this QNetworkCookie object.
QString QNetworkCookie::domain () const
Returns the domain this cookie is associated with. This corresponds to the "domain" field of the cookie string.
Note that the domain here may start with a dot, which is not a valid hostname. However, it means this cookie matches all hostnames ending with that domain name.
See also setDomain().
QDateTime QNetworkCookie::expirationDate () const
Returns the expiration date for this cookie. If this cookie is a session cookie, the QDateTime returned will not be valid. If the date is in the past, this cookie has already expired and should not be sent again back to a remote server.
The expiration date corresponds to the parameters of the "expires" entry in the cookie string.
See also isSessionCookie() and setExpirationDate().
bool QNetworkCookie::isHttpOnly () const
Returns true if the "HttpOnly" flag is enabled for this cookie.
A cookie that is "HttpOnly" is only set and retrieved by the network requests and replies; i.e., the HTTP protocol. It is not accessible from scripts running on browsers.
This function was introduced in Qt 4.5.
See also isSecure().
bool QNetworkCookie::isSecure () const
Returns true if the "secure" option was specified in the cookie string, false otherwise.
Secure cookies may contain private information and should not be resent over unencrypted connections.
See also setSecure().
bool QNetworkCookie::isSessionCookie () const
Returns true if this cookie is a session cookie. A session cookie is a cookie which has no expiration date, which means it should be discarded when the application's concept of session is over (usually, when the application exits).
See also expirationDate() and setExpirationDate().
QByteArray QNetworkCookie::name () const
Returns the name of this cookie. The only mandatory field of a cookie is its name, without which it is not considered valid.
See also setName() and value().
QList<QNetworkCookie> QNetworkCookie::parseCookies ( const QByteArray & cookieString ) [static]
Parses the cookie string cookieString as received from a server response in the "Set-Cookie:" header. If there's a parsing error, this function returns an empty list.
Since the HTTP header can set more than one cookie at the same time, this function returns a QList<QNetworkCookie>, one for each cookie that is parsed.
See also toRawForm().
QString QNetworkCookie::path () const
Returns the path associated with this cookie. This corresponds to the "path" field of the cookie string.
See also setPath().
void QNetworkCookie::setDomain ( const QString & domain )
Sets the domain associated with this cookie to be domain.
See also domain().
void QNetworkCookie::setExpirationDate ( const QDateTime & date )
Sets the expiration date of this cookie to date. Setting an invalid expiration date to this cookie will mean it's a session cookie.
See also isSessionCookie() and expirationDate().
void QNetworkCookie::setHttpOnly ( bool enable )
Sets this cookie's "HttpOnly" flag to enable.
This function was introduced in Qt 4.5.
See also isHttpOnly().
void QNetworkCookie::setName ( const QByteArray & cookieName )
Sets the name of this cookie to be cookieName. Note that setting a cookie name to an empty QByteArray will make this cookie invalid.
void QNetworkCookie::setPath ( const QString & path )
Sets the path associated with this cookie to be path.
See also path().
void QNetworkCookie::setSecure ( bool enable )
Sets the secure flag of this cookie to enable.
Secure cookies may contain private information and should not be resent over unencrypted connections.
See also isSecure().
void QNetworkCookie::setValue ( const QByteArray & value )
Sets the value of this cookie to be value.
QByteArray QNetworkCookie::toRawForm ( RawForm form = Full ) const
Returns the raw form of this QNetworkCookie. The QByteArray returned by this function is suitable for an HTTP header, either in a server response (the Set-Cookie header) or the client request (the Cookie header). You can choose from one of two formats, using form.
See also parseCookies().
QByteArray QNetworkCookie::value () const
Returns this cookies value, as specified in the cookie string. Note that a cookie is still valid if its value is empty.
Cookie name-value pairs are considered opaque to the application: that is, their values don't mean anything.
See also setValue() and name().
Returns true if this cookie is not equal to other.
See also operator==().
Copies the contents of the QNetworkCookie object other to this object.
bool QNetworkCookie::operator== ( const QNetworkCookie & other ) const
Returns true if this cookie is equal to other. This function only returns true if all fields of the cookie are the same.
However, in some contexts, two cookies of the same name could be considered equal.
See also operator!=().
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 53
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Orientation de l'écran en QML, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 53
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- La rubrique Qt a besoin de vous ! 1
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Le Qt Developer Network au hasard
Livre blanc de l'outillage de Qt Quick
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com