QNetworkCookie Class Reference · PyQt4 中文文檔

# QNetworkCookie Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkCookie類包含一個網絡的cookie 。[More...](#details) ### Types * `enum RawForm { NameAndValueOnly, Full }` ### Methods * `__init__ (self, QByteArray?name?=?QByteArray(), QByteArray?value?=?QByteArray())` * `__init__ (self, QNetworkCookie?other)` * `QString domain (self)` * `QDateTime expirationDate (self)` * `bool isHttpOnly (self)` * `bool isSecure (self)` * `bool isSessionCookie (self)` * `QByteArray name (self)` * `QString path (self)` * `setDomain (self, QString?domain)` * `setExpirationDate (self, QDateTime?date)` * `setHttpOnly (self, bool?enable)` * `setName (self, QByteArray?cookieName)` * `setPath (self, QString?path)` * `setSecure (self, bool?enable)` * `setValue (self, QByteArray?value)` * `QByteArray toRawForm (self, RawForm?form?=?QNetworkCookie.Full)` * `QByteArray value (self)` ### Static Methods * `list-of-QNetworkCookie parseCookies (QByteArray?cookieString)` ### Special Methods * `bool __eq__ (self, QNetworkCookie?other)` * `bool __ne__ (self, QNetworkCookie?other)` * * * ## Detailed Description 該QNetworkCookie類包含一個網絡的cookie 。 Cookies是少量的信息，像HTTP中使用無狀態的協議，以保持在要求的一些持久信息。一個cookie是由遠程服務器設置，當它回復到一個請求，它預計在相同的cookie被發送回來的時候再發送請求。 QNetworkCookie擁有從網絡接收一個這樣的cookie。一個cookie有一個名字和一個值，但這些都是不透明的應用程序（也就是存儲在其中的信息具有應用程序沒有意義）。一個cookie都有一個關聯的路徑名和域名，這表明當餅干應重新發送到服務器。一個cookie還可以有到期日，這表明它的有效性。如果到期日不存在，cookie將被認為是一個“會話cookie ”，當應用程序退出（或會話時，它的概念是比）應該被丟棄。 QNetworkCookie提供了使用HTTP標頭的格式解析一個cookie的方式[QNetworkCookie.parseCookies](qnetworkcookie.html#parseCookies)（）函數。然而，在接收時[QNetworkReply](qnetworkreply.html)，該cookie已經被解析。所描述的這個類實現了餅干[initial cookie specification by Netscape](http://cgi.netscape.com/newsref/std/cookie_spec.html)，這有點類似于[RFC 2109](http://www.rfc-editor.org/rfc/rfc2109.txt)說明書中，加["HttpOnly" extension](http://msdn.microsoft.com/en-us/library/ms533046(VS.85).aspx)。更近的[RFC 2965](http://www.rfc-editor.org/rfc/rfc2965.txt)不支持規范（其使用Set- Cookie2頭）。 * * * ## Type Documentation ``` QNetworkCookie.RawForm ``` 該枚舉用于與[toRawForm](qnetworkcookie.html#toRawForm)（）函數來聲明哪些cookie中的表格將被退回。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkCookie.NameAndValueOnly` | `0` | 品牌[toRawForm](qnetworkcookie.html#toRawForm)（）返回的cookie ，如適用于發送回服務器在客戶端請求的只有“名稱=值”部分“的Cookie ：”頭。頭字段：多個Cookie是由一個分號中的“曲奇”隔開。 | | `QNetworkCookie.Full` | `1` | 品牌[toRawForm](qnetworkcookie.html#toRawForm)（）返回完整的cookie內容，如適用于發送到客戶端在服務器的“設置Cookie ：”頭。 | 需要注意的是該cookie的唯一的賽程表可以被解析回其原來的內容。 **See also** [toRawForm](qnetworkcookie.html#toRawForm)（）和[parseCookies](qnetworkcookie.html#parseCookies)（）。 * * * ## Method Documentation ``` QNetworkCookie.__init__ (self, QByteArray?name?=?QByteArray(), QByteArray?value?=?QByteArray()) ``` 創建一個新的[QNetworkCookie](qnetworkcookie.html)對象，初始化cookie的名稱_name_和它的價值_value_。 Cookie是唯一有效的，如果它有一個名字。但是，值是不透明的應用程序和為空可能有重要意義到遠程服務器。 ``` QNetworkCookie.__init__ (self, QNetworkCookie?other) ``` 創建一個新的[QNetworkCookie](qnetworkcookie.html)通過復制的內容對象_other_。 ``` QString QNetworkCookie.domain (self) ``` 返回這個cookie關聯的領域。這對應于該cookie字符串的“域”字段。注意，這里的域可以以點開始，這不是有效的主機名。然而，它意味著這個cookie匹配與該域名結尾的所有主機名。 **See also** [setDomain](qnetworkcookie.html#setDomain)（）。 ``` QDateTime QNetworkCookie.expirationDate (self) ``` [](qdatetime.html) [返回的截止日期為這個cookie 。如果這個cookie是一個會話cookie時，](qdatetime.html)[QDateTime](qdatetime.html)返回的將是無效的。如果日期是在過去，這個cookie已經過期，不應該再回到遠程服務器發送。保質期對應于該cookie字符串的“過期”項的參數。 **See also** [isSessionCookie](qnetworkcookie.html#isSessionCookie)（）和[setExpirationDate](qnetworkcookie.html#setExpirationDate)（）。 ``` bool QNetworkCookie.isHttpOnly (self) ``` 如果啟用了這個cookie的“ HttpOnly ”標志，則返回True 。一個cookie是“ HttpOnly ”僅設置并通過網絡請求和回復檢索，即HTTP協議。它不是從瀏覽器中運行的腳本訪問。此功能被引入Qt的4.5 。 **See also** [isSecure](qnetworkcookie.html#isSecure)（）。 ``` bool QNetworkCookie.isSecure (self) ``` 如果是在cookie字符串，否則返回False指定的“安全”選項，則返回True 。安全cookie可能包含私人信息，不應該怨恨過未加密的連接。 **See also** [setSecure](qnetworkcookie.html#setSecure)（）。 ``` bool QNetworkCookie.isSessionCookie (self) ``` 返回True如果這個cookie是一個會話cookie 。會話cookie是沒有到期日的cookie ，這意味著當會話的應用程序的概念是在（通常，應用程序退出時），它應該被丟棄。 **See also** [expirationDate](qnetworkcookie.html#expirationDate)（）和[setExpirationDate](qnetworkcookie.html#setExpirationDate)（）。 ``` QByteArray QNetworkCookie.name (self) ``` [ 返回這個cookie的名稱。一個cookie的唯一必填字段是它的名字，沒有它不被視為有效。 ](qbytearray.html) [**See also**](qbytearray.html) [setName](qnetworkcookie.html#setName)（）和[value](qnetworkcookie.html#value)（）。 ``` list-of-QNetworkCookie QNetworkCookie.parseCookies (QByteArray?cookieString) ``` 解析cookie的字符串_cookieString_標題：從在“設置Cookie ”服務器響應接收。如果有一個解析錯誤，該函數返回一個空列表。由于HTTP標頭可以同時設置多個cookie ，這個函數返回一個[QList](index.htm)\u003c[QNetworkCookie](qnetworkcookie.html)\u003e ，一個用于解析每個cookie 。 **See also** [toRawForm](qnetworkcookie.html#toRawForm)（）。 ``` QString QNetworkCookie.path (self) ``` ``` QNetworkCookie.setDomain (self, QString?domain) ``` 設置與此相關聯的cookie的域為_domain_。 **See also** [domain](qnetworkcookie.html#domain)（）。 ``` QNetworkCookie.setExpirationDate (self, QDateTime?date) ``` 設置此Cookie的過期日期_date_。設置一個無效的到期日，以該cookie將意味著它是一個會話cookie 。 **See also** [isSessionCookie](qnetworkcookie.html#isSessionCookie)（）和[expirationDate](qnetworkcookie.html#expirationDate)（）。 ``` QNetworkCookie.setHttpOnly (self, bool?enable) ``` 設置這個cookie的“ HttpOnly ”標志_enable_。此功能被引入Qt的4.5 。 **See also** [isHttpOnly](qnetworkcookie.html#isHttpOnly)（）。 ``` QNetworkCookie.setName (self, QByteArray?cookieName) ``` 設置這個cookie的是名_cookieName_。請注意，一個cookie名稱設置為空[QByteArray](qbytearray.html)將這個cookie無效。 **See also** [name](qnetworkcookie.html#name)（）和[value](qnetworkcookie.html#value)（）。 ``` QNetworkCookie.setPath (self, QString?path) ``` 設置與此相關聯的cookie的路徑是_path_。 **See also** [path](qnetworkcookie.html#pathx)（）。 ``` QNetworkCookie.setSecure (self, bool?enable) ``` 設置此Cookie的安全標志，以_enable_。安全cookie可能包含私人信息，不應該怨恨過未加密的連接。 **See also** [isSecure](qnetworkcookie.html#isSecure)（）。 ``` QNetworkCookie.setValue (self, QByteArray?value) ``` 設置此cookie的值是_value_。 **See also** [value](qnetworkcookie.html#value)（）和[name](qnetworkcookie.html#name)（）。 ``` QByteArray QNetworkCookie.toRawForm (self, RawForm?form?=?QNetworkCookie.Full) ``` [](qbytearray.html) [返回此的原始形式](qbytearray.html)[QNetworkCookie](qnetworkcookie.html)。該[QByteArray](qbytearray.html)此函數返回的是適用于HTTP頭，無論是在服務器響應（ Set-Cookie頭）或客戶端請求（ Cookie頭）。您可以從以下兩種格式之一選擇，使用_form_。 **See also** [parseCookies](qnetworkcookie.html#parseCookies)（）。 ``` QByteArray QNetworkCookie.value (self) ``` [ 返回此餅干值，如在cookie字符串中指定。請注意，一個cookie仍然是有效的，如果它的值為空。 cookie的名稱 - 值對被認為是不透明的應用：那就是，它們的值沒有任何意義。 ](qbytearray.html) [**See also**](qbytearray.html) [setValue](qnetworkcookie.html#setValue)（）和[name](qnetworkcookie.html#name)（）。 ``` bool QNetworkCookie.__eq__ (self, QNetworkCookie?other) ``` ``` bool QNetworkCookie.__ne__ (self, QNetworkCookie?other) ```