QNetworkRequest Class Reference · PyQt4 中文文檔

# QNetworkRequest Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkRequest類持有與發送請求[QNetworkAccessManager](qnetworkaccessmanager.html)。[More...](#details) ### Types * `enum Attribute { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, ..., UserMax }` * `enum CacheLoadControl { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache }` * `enum KnownHeaders { ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, ..., ContentDispositionHeader }` * `enum LoadControl { Automatic, Manual }` * `enum Priority { HighPriority, NormalPriority, LowPriority }` ### Methods * `__init__ (self, QUrl?url?=?QUrl())` * `__init__ (self, QNetworkRequest?other)` * `QVariant attribute (self, Attribute?code, QVariant?defaultValue?=?QVariant())` * `bool hasRawHeader (self, QByteArray?headerName)` * `QVariant header (self, KnownHeaders?header)` * `QObject originatingObject (self)` * `Priority priority (self)` * `QByteArray rawHeader (self, QByteArray?headerName)` * `list-of-QByteArray rawHeaderList (self)` * `setAttribute (self, Attribute?code, QVariant?value)` * `setHeader (self, KnownHeaders?header, QVariant?value)` * `setOriginatingObject (self, QObject?object)` * `setPriority (self, Priority?priority)` * `setRawHeader (self, QByteArray?headerName, QByteArray?value)` * `setSslConfiguration (self, QSslConfiguration?configuration)` * `setUrl (self, QUrl?url)` * `QSslConfiguration sslConfiguration (self)` * `QUrl url (self)` ### Special Methods * `bool __eq__ (self, QNetworkRequest?other)` * `bool __ne__ (self, QNetworkRequest?other)` * * * ## Detailed Description 該QNetworkRequest類持有與發送請求[QNetworkAccessManager](qnetworkaccessmanager.html)。 QNetworkRequest是網絡訪問API的一部分，是類保持必要的資料，通過網絡發送一個請求。它包含一個URL和一些輔助信息可以用來修改請求。 * * * ## Type Documentation ``` QNetworkRequest.Attribute ``` 屬性代碼為[QNetworkRequest](qnetworkrequest.html)和[QNetworkReply](qnetworkreply.html)。屬性是用于控制該請求的行為，并從答復通過進一步的信息返回給應用程序的額外元數據。屬性也是可擴展的，允許自定義實現通過自定義值。下表解釋了默認屬性代碼，該[QVariant](qvariant.html)相關類型，默認值，如果所說的屬性是失蹤，無論是在請求或回復使用。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkRequest.HttpStatusCodeAttribute` | `0` | 回復只，類型：[QVariant.Int](qvariant.html#Type-enum)（沒有默認值）指示從HTTP服務器接收（如200 ， 304 ， 404 ， 401等）的HTTP狀態代碼。如果連接不是基于HTTP的，此屬性將不會出現。 | | `QNetworkRequest.HttpReasonPhraseAttribute` | `1` | 回復只，類型：[QVariant.ByteArray](qvariant.html#Type-enum)（無默認值）表示HTTP原因短語作為從HTTP服務器接收（如“ OK”，“發現” ， “未找到” ， “拒絕訪問” ，等等）這是狀態碼的人類可讀的表示（見上文）。如果連接不是基于HTTP的，此屬性將不會出現。 | | `QNetworkRequest.RedirectionTargetAttribute` | `2` | 回復只，類型：[QVariant.Url](qvariant.html#Type-enum)（無默認值）如果存在，則表明服務器將請求重定向到不同的URL。網絡訪問API，默認情況下不遵循重定向：它是由應用程序決定是否請求重定向應該被允許的，根據其安全策略。返回的URL可能是相對的。使用[QUrl.resolved](qurl.html#resolved)（）來創建一個絕對URL出來。 | | `QNetworkRequest.ConnectionEncryptedAttribute` | `3` | 回復只，類型：[QVariant.Bool](qvariant.html#Type-enum)（默認：False ）表示通過加密（安全）連接的數據是否獲得。 | | `QNetworkRequest.CacheLoadControlAttribute` | `4` | 唯一的要求，請鍵入：[QVariant.Int](qvariant.html#Type-enum)（默認值：[QNetworkRequest.PreferNetwork](qnetworkrequest.html#CacheLoadControl-enum)）控制如何緩存應該被訪問。可能的值有那些[QNetworkRequest.CacheLoadControl](qnetworkrequest.html#CacheLoadControl-enum)。注意，默認[QNetworkAccessManager](qnetworkaccessmanager.html)實現不支持緩存。然而，這個屬性可以用于某些后端來修改他們的要求（例如，用于緩存代理服務器）。 | | `QNetworkRequest.CacheSaveControlAttribute` | `5` | 唯一的要求，請鍵入：[QVariant.Bool](qvariant.html#Type-enum)（默認：True）控制，如果得到的數據應該被保存到緩存以備日后使用。如果該值為False ，獲得的數據將不被自動緩存。如果為True ，數據可以被緩存，只要它是可緩存的（什么是緩存依賴于所使用的協議）。 | | `QNetworkRequest.SourceIsFromCacheAttribute` | `6` | 回復只，類型：[QVariant.Bool](qvariant.html#Type-enum)（默認：False ）表示從高速緩存或沒有數據是否獲得。 | | `QNetworkRequest.DoNotBufferUploadDataAttribute` | `7` | 唯一的要求，請鍵入：[QVariant.Bool](qvariant.html#Type-enum)（默認：False ）指示是否[QNetworkAccessManager](qnetworkaccessmanager.html)代碼被允許緩沖上傳數據，例如做一個HTTP POST時。當使用此標志與連續上傳數據時，[ContentLengthHeader](qnetworkrequest.html#KnownHeaders-enum)報頭必須被設置。 | | `QNetworkRequest.HttpPipeliningAllowedAttribute` | `8` | 唯一的要求，請鍵入：[QVariant.Bool](qvariant.html#Type-enum)（默認：False ）指示是否[QNetworkAccessManager](qnetworkaccessmanager.html)代碼被允許使用HTTP流水線這一請求。 | | `QNetworkRequest.HttpPipeliningWasUsedAttribute` | `9` | 回復只，類型：[QVariant.Bool](qvariant.html#Type-enum)指示HTTP管線是否被用于接收此回復。 | | `QNetworkRequest.CustomVerbAttribute` | `10` | 唯一的要求，請鍵入：[QVariant.ByteArray](qvariant.html#Type-enum)保存了自定義HTTP動詞送價值（往其他動詞的用法，而不是GET ， POST，PUT和DELETE ）。這個動詞是調用時設置[QNetworkAccessManager.sendCustomRequest](qnetworkaccessmanager.html#sendCustomRequest)（）。 | | `QNetworkRequest.CookieLoadControlAttribute` | `11` | 唯一的要求，請鍵入：[QVariant.Int](qvariant.html#Type-enum)（默認值：[QNetworkRequest.Automatic](qnetworkrequest.html#LoadControl-enum)）指示是否在請求中發送'曲奇'標頭。此屬性設置為False[QtWebKit](index.htm)創建一個跨源時[XMLHttpRequest](index.htm#xmlhttprequest)其中withCredentials尚未明確設置為True由創建該請求的Javascript 。看[here](http://www.w3.org/TR/XMLHttpRequest2/#credentials-flag)了解更多信息。（這個值被引入4.7 。） | | `QNetworkRequest.CookieSaveControlAttribute` | `13` | 唯一的要求，請鍵入：[QVariant.Int](qvariant.html#Type-enum)（默認值：[QNetworkRequest.Automatic](qnetworkrequest.html#LoadControl-enum)）指示是否保存就回答服務器接收到請求'曲奇'標頭。此屬性設置為False[QtWebKit](index.htm)創建一個跨源時[XMLHttpRequest](index.htm#xmlhttprequest)其中withCredentials尚未明確設置為True由創建該請求的Javascript 。看[here](http://www.w3.org/TR/XMLHttpRequest2/#credentials-flag)了解更多信息。（這個值被引入4.7 。） | | `QNetworkRequest.AuthenticationReuseAttribute` | `12` | 唯一的要求，請鍵入：[QVariant.Int](qvariant.html#Type-enum)（默認值：[QNetworkRequest.Automatic](qnetworkrequest.html#LoadControl-enum)）指示是否使用緩存的授權憑證的要求，如果有的話。如果設置為[QNetworkRequest.Manual](qnetworkrequest.html#LoadControl-enum)和身份驗證機制是“基本”或“摘要”下，Qt將不會發送任何緩存憑據它可能對請求的URL的一個“授權” HTTP標頭。該屬性被設置為[QNetworkRequest.Manual](qnetworkrequest.html#LoadControl-enum)通過[QtWebKit](index.htm)創建一個跨源時[XMLHttpRequest](index.htm#xmlhttprequest)其中withCredentials尚未明確設置為True由創建該請求的Javascript 。看[here](http://www.w3.org/TR/XMLHttpRequest2/#credentials-flag)了解更多信息。（這個值被引入4.7 。） | | `QNetworkRequest.User` | `1000` | 特殊類型。其他信息可以在傳遞[QVariants](index.htm#qvariants)同類型從用戶到UserMax 。網絡訪問的默認實現將忽略在這個范圍內的任何請求的屬性，它不會產生任何屬性在此范圍內的答復。的范圍被保留用于擴展[QNetworkAccessManager](qnetworkaccessmanager.html)。 | | `QNetworkRequest.UserMax` | `32767` | 特殊類型。請參閱用戶。 | 這個枚舉被引入或修改的Qt 4.7 。 ``` QNetworkRequest.CacheLoadControl ``` 控件的緩存機制[QNetworkAccessManager](qnetworkaccessmanager.html)。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkRequest.AlwaysNetwork` | `0` | 總是從網絡加載和不檢查緩存有一個有效的條目（類似于瀏覽器的“刷新”功能） | | `QNetworkRequest.PreferNetwork` | `1` | 默認值;從網絡加載，如果緩存條目是早于網絡入口 | | `QNetworkRequest.PreferCache` | `2` | 從緩存中加載如果可用，否則從網絡加載。請注意，這可以從緩存中返回可能是陳舊的（但沒有過期）項目。 | | `QNetworkRequest.AlwaysCache` | `3` | 從緩存中只加載，顯示錯誤，如果該項目沒有緩存（即離線模式） | ``` QNetworkRequest.KnownHeaders ``` 眾所周知頭類型的列表[QNetworkRequest](qnetworkrequest.html)解析。每個已知的頭也代表了原始形式，其完整的HTTP名字。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkRequest.ContentTypeHeader` | `0` | 對應到HTTP Content-Type頭，并包含包含媒體的字符串（ MIME）類型和任何輔助數據（例如，字符集） | | `QNetworkRequest.ContentLengthHeader` | `1` | 對應于HTTP的Content-Length頭，并包含長度在所發送的數據的字節數。 | | `QNetworkRequest.LocationHeader` | `2` | 對應于HTTP位置報頭和包含表示該數據的實際位置，包括在殼體的重定向的目標URL的URL。 | | `QNetworkRequest.LastModifiedHeader` | `3` | 對應到HTTP Last-Modified頭，并包含一個[QDateTime](qdatetime.html)代表內容的最后修改日期 | | `QNetworkRequest.CookieHeader` | `4` | 對應于HTTP Cookie頭部，并包含一個[QList](index.htm)\u003c[QNetworkCookie](qnetworkcookie.html)\u003e表示要發送回服務器的餅干 | | `QNetworkRequest.SetCookieHeader` | `5` | 對應于HTTP的Set-Cookie報頭，并包含一個[QList](index.htm)\u003c[QNetworkCookie](qnetworkcookie.html)\u003e表示由服務器發送到存儲在本地的餅干 | **See also** [header](qnetworkrequest.html#header)（）[setHeader](qnetworkrequest.html#setHeader)（）[rawHeader](qnetworkrequest.html#rawHeader)（）和[setRawHeader](qnetworkrequest.html#setRawHeader)（）。 ``` QNetworkRequest.LoadControl ``` 指示如果請求的加載機制的一個方面已手動復蓋，如通過[QtWebKit](index.htm)。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkRequest.Automatic` | `0` | 默認值：表示默認行為。 | | `QNetworkRequest.Manual` | `1` | 表示行為已手動復蓋。 | 這個枚舉被引入或修改的Qt 4.7 。 ``` QNetworkRequest.Priority ``` 這個枚舉列出了可能的網絡請求優先級。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkRequest.HighPriority` | `1` | 高優先級 | | `QNetworkRequest.NormalPriority` | `3` | 普通優先級 | | `QNetworkRequest.LowPriority` | `5` | 低優先級 | 這個枚舉被引入或修改的Qt 4.7 。 * * * ## Method Documentation ``` QNetworkRequest.__init__ (self, QUrl?url?=?QUrl()) ``` 構造一個[QNetworkRequest](qnetworkrequest.html)與對象_url_以被請求的URL 。 **See also** [url](qnetworkrequest.html#url)（）和[setUrl](qnetworkrequest.html#setUrl)（）。 ``` QNetworkRequest.__init__ (self, QNetworkRequest?other) ``` 創建副本_other_。 ``` QVariant QNetworkRequest.attribute (self, Attribute?code, QVariant?defaultValue?=?QVariant()) ``` ``` bool QNetworkRequest.hasRawHeader (self, QByteArray?headerName) ``` 返回True如果原始標題_headerName_存在于這個網絡請求。 **See also** [rawHeader](qnetworkrequest.html#rawHeader)（）和[setRawHeader](qnetworkrequest.html#setRawHeader)（）。 ``` QVariant QNetworkRequest.header (self, KnownHeaders?header) ``` 返回已知的網絡標頭的值_header_如果它存在于這個請求。如果它不存在，則返回的QVariant （）（即，無效的變體）。 **See also** [KnownHeaders](qnetworkrequest.html#KnownHeaders-enum)，[rawHeader](qnetworkrequest.html#rawHeader)（）和[setHeader](qnetworkrequest.html#setHeader)（）。 ``` QObject QNetworkRequest.originatingObject (self) ``` [ 返回一個引用到啟動此網絡請求的對象，則返回0 ，如果沒有設置或對象已經被銷毀。此功能被引入Qt的4.6 。 ](qobject.html) [**See also**](qobject.html) [setOriginatingObject](qnetworkrequest.html#setOriginatingObject)（）。 ``` Priority QNetworkRequest.priority (self) ``` [ 返回此請求的優先級。此功能被引入Qt的4.7 。 ](qnetworkrequest.html#Priority-enum) [**See also**](qnetworkrequest.html#Priority-enum) [setPriority](qnetworkrequest.html#setPriority)（）。 ``` QByteArray QNetworkRequest.rawHeader (self, QByteArray?headerName) ``` [](qbytearray.html) [返回頭的原始形式_headerName_。如果沒有這樣的標頭，空](qbytearray.html)[QByteArray](qbytearray.html)被返回，這可能是由一個標題，是目前無法區分，但沒有任何內容（用[hasRawHeader](qnetworkrequest.html#hasRawHeader)（）來找出如果頭存在與否）。原標題可以被設置[setRawHeader](qnetworkrequest.html#setRawHeader)（）或與[setHeader](qnetworkrequest.html#setHeader)（）。 **See also** [header](qnetworkrequest.html#header)（）和[setRawHeader](qnetworkrequest.html#setRawHeader)（）。 ``` list-of-QByteArray QNetworkRequest.rawHeaderList (self) ``` 返回在這個網絡要求設置的所有原始標題的列表。這份名單是在頭被設定的順序。 **See also** [hasRawHeader](qnetworkrequest.html#hasRawHeader)（）和[rawHeader](qnetworkrequest.html#rawHeader)（）。 ``` QNetworkRequest.setAttribute (self, Attribute?code, QVariant?value) ``` 設置與代碼相關的屬性_code_是值_value_。如果屬性已經設置，以前的值將被丟棄。在特殊的，如果_value_是無效的[QVariant](qvariant.html)，屬性未設置。 **See also** [attribute](qnetworkrequest.html#attributex)（）和[QNetworkRequest.Attribute](qnetworkrequest.html#Attribute-enum)。 ``` QNetworkRequest.setHeader (self, KnownHeaders?header, QVariant?value) ``` 設置了已知頭的值_header_要_value_，復蓋任何先前設置的標頭。此操作還設置了相當于原始HTTP標頭。 **See also** [KnownHeaders](qnetworkrequest.html#KnownHeaders-enum)，[setRawHeader](qnetworkrequest.html#setRawHeader)（）和[header](qnetworkrequest.html#header)（）。 ``` QNetworkRequest.setOriginatingObject (self, QObject?object) ``` 允許設置的參考_object_發起請求。例如[QtWebKit](index.htm)設置原始對象的[QWebFrame](qwebframe.html)發起請求。此功能被引入Qt的4.6 。 **See also** [originatingObject](qnetworkrequest.html#originatingObject)（）。 ``` QNetworkRequest.setPriority (self, Priority?priority) ``` 設置此請求的優先級，以_priority_。 **Note:**該_priority_只是一個暗示，網絡訪問管理器。它可以使用或不使用。目前它被用于HTTP來決定哪個請求應該被首先發送到服務器。此功能被引入Qt的4.7 。 **See also** [priority](qnetworkrequest.html#priority)（）。 ``` QNetworkRequest.setRawHeader (self, QByteArray?headerName, QByteArray?value) ``` 設置頁眉_headerName_有利用價值_headerValue_。如果_headerName_對應于一個已知的報頭（參見[QNetworkRequest.KnownHeaders](qnetworkrequest.html#KnownHeaders-enum)）， raw格式將被解析和相應的“熟”頭將被設置為好。例如： ``` request.setRawHeader("Last-Modified", "Sun, 06 Nov 1994 08:49:37 GMT"); ``` 還將設置稱為標頭[LastModifiedHeader](qnetworkrequest.html#KnownHeaders-enum)是[QDateTime](qdatetime.html)解析日期的對象。注意：在設置相同的頭兩次將復蓋以前的設置。為了實現多個同名的HTTP頭的行為，你應該將兩者連接起來的值，用逗號將它們隔開（ “，” ），并設置一個單一的原始標題。 **See also** [KnownHeaders](qnetworkrequest.html#KnownHeaders-enum)，[setHeader](qnetworkrequest.html#setHeader)（）[hasRawHeader](qnetworkrequest.html#hasRawHeader)（）和[rawHeader](qnetworkrequest.html#rawHeader)（）。 ``` QNetworkRequest.setSslConfiguration (self, QSslConfiguration?configuration) ``` 設置此網絡請求的SSL配置是_config_。該應用設置為私有密鑰，本地證書， SSL協議（的SSLv2 ， SSLv3的，使用TLSv1如適用），即在SSL后端被允許使用的CA證書和密碼。缺省情況下， SSL配置設置，這使得后端可以自由選擇什么樣的配置是最適合他們。 **See also** [sslConfiguration](qnetworkrequest.html#sslConfiguration)（）和[QSslConfiguration.defaultConfiguration](qsslconfiguration.html#defaultConfiguration)（）。 ``` QNetworkRequest.setUrl (self, QUrl?url) ``` 設置此網絡請求所指的是網址_url_。 **See also** [url](qnetworkrequest.html#url)（）。 ``` QSslConfiguration QNetworkRequest.sslConfiguration (self) ``` [ 返回此網絡請求的SSL配置。缺省情況下， SSL設置中指定。 ](qsslconfiguration.html) [**See also**](qsslconfiguration.html) [setSslConfiguration](qnetworkrequest.html#setSslConfiguration)（）。 ``` QUrl QNetworkRequest.url (self) ``` [ 返回此網絡請求是指URL中。 ](qurl.html) [**See also**](qurl.html) [setUrl](qnetworkrequest.html#setUrl)（）。 ``` bool QNetworkRequest.__eq__ (self, QNetworkRequest?other) ``` ``` bool QNetworkRequest.__ne__ (self, QNetworkRequest?other) ```