The QNetworkCookie class holds one network cookie. 更多...
头: | #include <QNetworkCookie> |
CMake: |
find_package(Qt6 COMPONENTS Network REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Network) |
qmake: | QT += network |
enum | RawForm { NameAndValueOnly, Full } |
enum class | SameSite { Default, None, Lax, Strict } |
QNetworkCookie (const QNetworkCookie & other ) | |
QNetworkCookie (const QByteArray & name = QByteArray(), const QByteArray & value = QByteArray()) | |
QNetworkCookie & | operator= (const QNetworkCookie & other ) |
~QNetworkCookie () | |
QString | domain () const |
QDateTime | expirationDate () const |
bool | hasSameIdentifier (const QNetworkCookie & other ) const |
bool | isHttpOnly () const |
bool | isSecure () const |
bool | isSessionCookie () const |
QByteArray | name () const |
void | normalize (const QUrl & url ) |
QString | path () const |
QNetworkCookie::SameSite | sameSitePolicy () 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 | setSameSitePolicy (QNetworkCookie::SameSite sameSite ) |
void | setSecure (bool enable ) |
void | setValue (const QByteArray & value ) |
void | swap (QNetworkCookie & other ) |
QByteArray | toRawForm (QNetworkCookie::RawForm form = Full) const |
QByteArray | value () const |
bool | operator!= (const QNetworkCookie & other ) const |
bool | operator== (const QNetworkCookie & other ) const |
QList<QNetworkCookie> | parseCookies (const QByteArray & cookieString ) |
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.
另请参阅 QNetworkCookieJar , QNetworkRequest ,和 QNetworkReply .
This enum is used with the toRawForm () function to declare which form of a cookie shall be returned.
常量 | 值 | 描述 |
---|---|---|
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. |
Note that only the Full form of the cookie can be parsed back into its original contents.
另请参阅 toRawForm () 和 parseCookies ().
[since 6.1]
enum class QNetworkCookie::
SameSite
常量 | 值 | 描述 |
---|---|---|
QNetworkCookie::SameSite::Default
|
0
|
SameSite is not set. Can be interpreted as None or Lax by the browser. |
QNetworkCookie::SameSite::None
|
1
|
Cookies can be sent in all contexts. This used to be default, but recent browsers made Lax default, and will now require the cookie to be both secure and to set SameSite=None. |
QNetworkCookie::SameSite::Lax
|
2
|
Cookies are sent on first party requests and GET requests initiated by third party website. This is the default in modern browsers (since mid 2020). |
QNetworkCookie::SameSite::Strict
|
3
|
Cookies will only be sent in a first-party context. |
This enum was introduced or modified in Qt 6.1.
另请参阅 setSameSitePolicy () 和 sameSitePolicy ().
Creates a new QNetworkCookie object by copying the contents of other .
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 object other 到此对象。
销毁此 QNetworkCookie 对象。
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.
另请参阅 setDomain ().
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.
另请参阅 isSessionCookie () 和 setExpirationDate ().
返回
true
if this cookie has the same identifier tuple as
other
. The identifier tuple is composed of the name, domain and path.
另请参阅 operator== ().
返回
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.
另请参阅 isSecure ().
返回
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.
另请参阅 setSecure ().
返回
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).
另请参阅 expirationDate () 和 setExpirationDate ().
Returns the name of this cookie. The only mandatory field of a cookie is its name, without which it is not considered valid.
[since 5.0]
void
QNetworkCookie::
normalize
(const
QUrl
&
url
)
This functions normalizes the path and domain of the cookie if they were previously empty. The url parameter is used to determine the correct domain and path.
该函数在 Qt 5.0 引入。
[static]
QList
<
QNetworkCookie
> QNetworkCookie::
parseCookies
(const
QByteArray
&
cookieString
)
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.
另请参阅 toRawForm ().
Returns the path associated with this cookie. This corresponds to the "path" field of the cookie string.
另请参阅 setPath ().
[since 6.1]
QNetworkCookie::SameSite
QNetworkCookie::
sameSitePolicy
() const
Returns the "
SameSite
" option if specified in the cookie string,
SameSite::Default
if not present.
该函数在 Qt 6.1 引入。
另请参阅 setSameSitePolicy ().
Sets the domain associated with this cookie to be domain .
另请参阅 domain ().
Sets the expiration date of this cookie to date . Setting an invalid expiration date to this cookie will mean it's a session cookie.
另请参阅 isSessionCookie () 和 expirationDate ().
Sets this cookie's "HttpOnly" flag to enable .
另请参阅 isHttpOnly ().
Sets the name of this cookie to be cookieName . Note that setting a cookie name to an empty QByteArray will make this cookie invalid.
Sets the path associated with this cookie to be path .
另请参阅 path ().
[since 6.1]
void
QNetworkCookie::
setSameSitePolicy
(
QNetworkCookie::SameSite
sameSite
)
Sets the " SameSite " option of this cookie to sameSite .
该函数在 Qt 6.1 引入。
另请参阅 sameSitePolicy ().
Sets the secure flag of this cookie to enable .
Secure cookies may contain private information and should not be resent over unencrypted connections.
另请参阅 isSecure ().
Sets the value of this cookie to be value .
[since 5.0]
void
QNetworkCookie::
swap
(
QNetworkCookie
&
other
)
Swaps this cookie with other 。此函数非常快且从不失败。
该函数在 Qt 5.0 引入。
Returns the raw form of this QNetworkCookie 。 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 .
另请参阅 parseCookies ().
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.
返回
true
if this cookie is not equal to
other
.
另请参阅 operator== ().
[since 5.0]
bool
QNetworkCookie::
operator==
(const
QNetworkCookie
&
other
) const
返回
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.
该函数在 Qt 5.0 引入。
另请参阅 operator!= () 和 hasSameIdentifier ().