Qt QNetworkCookie帮助翻译

The QNetworkCookie class holds one network cookie. More..

QNetworkCookie类保存一个网络cookie。

Header: #include <QNetworkCookie>
qmake: QT += network
Since: Qt 4.4

List of all members, including inherited members

所有成员的列表，包括继承的成员
Public Types

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 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
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)
void swap(QNetworkCookie & other)
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.

QNetworkCookie类保存一个网络cookie。

Cookies are small bits of information that stateless protocols like HTTP use to maintain some persistent information across requests.

cookie是无状态协议（如HTTP）用来在请求之间维护一些持久信息的小块信息。

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.

cookie由远程服务器在响应请求时设置，它希望在发送进一步的请求时返回相同的cookie。

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.

QNetworkCookie保存从网络接收的此类cookie。cookie有一个名称和一个值，但对应用程序是不透明的（也就是说，存储在其中的信息对应用程序没有意义）。cookie有一个关联的路径名和域，它们指示何时将cookie再次发送到服务器。

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).

cookie也可以有一个有效期，表示其有效性。如果过期日期不存在，则cookie将被视为“会话cookie”，并应在应用程序退出时（或其会话概念结束时）丢弃。

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.

QNetworkCookie提供了一种使用QNetworkCookie:：parseCookies（）函数从HTTP头格式解析cookie的方法。但是，当在QNetworkReply中接收到cookie时，cookie已经被解析了。

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.

这个类实现Netscape的初始cookie规范所描述的cookie，这个规范有点类似于rfc2109规范，加上“HttpOnly”扩展。不支持较新的RFC2965规范（它使用Set-Cookie2头）。

See also QNetworkCookieJar, QNetworkRequest, and QNetworkReply.

另请参见qnetworkcokiejar、QNetworkRequest和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.

此枚举与toRawForm（）函数一起使用，以声明应返回哪种形式的cookie。

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.
Note that only the Full form of the cookie can be parsed back into its original contents.

定值说明

QNetworkCookie:：NameAndValueOnly 0使toRawForm（）只返回cookie的“NAME=VALUE”部分，适合于在客户端请求的“cookie:”头中发送回服务器。多个Cookie在“Cookie:”头字段中用分号分隔。

QNetworkCookie:：Full 1使toRawForm（）返回完整的cookie内容，适合于发送到服务器的“setcookie:”头中的客户机。

请注意，只有完整形式的cookie才能解析回其原始内容。

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.

创建一个新的QNetworkCookie对象，将cookie名称初始化为name，将其值初始化为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.

cookie只有在有名称时才有效。但是，该值对应用程序是不透明的，并且为空可能对远程服务器有意义。

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.

返回与此cookie关联的域。这对应于cookie字符串的“domain”字段。

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.

请注意，这里的域可能以点开头，这不是有效的主机名。但是，这意味着这个cookie匹配所有以该域名结尾的主机名。