QNetworkAccessManager Class Reference · PyQt4 中文文檔

# QNetworkAccessManager Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkAccessManager類允許應用程序發送網絡請求和接收回復[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum NetworkAccessibility { UnknownAccessibility, NotAccessible, Accessible }` * `enum Operation { HeadOperation, GetOperation, PutOperation, PostOperation, DeleteOperation, CustomOperation }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `QNetworkConfiguration activeConfiguration (self)` * `QAbstractNetworkCache cache (self)` * `QNetworkConfiguration configuration (self)` * `QNetworkCookieJar cookieJar (self)` * `QNetworkReply createRequest (self, Operation?op, QNetworkRequest?request, QIODevice?device?=?None)` * `QNetworkReply deleteResource (self, QNetworkRequest?request)` * `QNetworkReply get (self, QNetworkRequest?request)` * `QNetworkReply head (self, QNetworkRequest?request)` * `NetworkAccessibility networkAccessible (self)` * `QNetworkReply post (self, QNetworkRequest?request, QIODevice?data)` * `QNetworkReply post (self, QNetworkRequest?request, QByteArray?data)` * `QNetworkReply post (self, QNetworkRequest?request, QHttpMultiPart?multiPart)` * `QNetworkProxy proxy (self)` * `QNetworkProxyFactory proxyFactory (self)` * `QNetworkReply put (self, QNetworkRequest?request, QIODevice?data)` * `QNetworkReply put (self, QNetworkRequest?request, QByteArray?data)` * `QNetworkReply put (self, QNetworkRequest?request, QHttpMultiPart?multiPart)` * `QNetworkReply sendCustomRequest (self, QNetworkRequest?request, QByteArray?verb, QIODevice?data?=?None)` * `setCache (self, QAbstractNetworkCache?cache)` * `setConfiguration (self, QNetworkConfiguration?config)` * `setCookieJar (self, QNetworkCookieJar?cookieJar)` * `setNetworkAccessible (self, NetworkAccessibility?accessible)` * `setProxy (self, QNetworkProxy?proxy)` * `setProxyFactory (self, QNetworkProxyFactory?factory)` ### Qt Signals * `void authenticationRequired (QNetworkReply *,QAuthenticator *)` * `void finished (QNetworkReply *)` * `void networkAccessibleChanged (QNetworkAccessManager::NetworkAccessibility)` * `void proxyAuthenticationRequired (const QNetworkProxy&,QAuthenticator *)` * `void sslErrors (QNetworkReply *,const QList<QSslError>&)` * * * ## Detailed Description 該QNetworkAccessManager類允許應用程序發送網絡請求和接收回復網絡訪問API是??圍繞一個QNetworkAccessManager對象，它保存了常見的配置和設置它發出的請求構造。它包含的代理和高速緩存配置，以及有關這些問題的信號，并且可以被用于監控網絡操作的進度的答復信號。一個QNetworkAccessManager應該夠整個Qt應用程序。一旦QNetworkAccessManager對象已經創建，應用程序可以用它來通過網絡發送請求。 A組的標準功能提供，它接受一個請求和可選的數據，并且每個回報[QNetworkReply](qnetworkreply.html)對象。返回的對象，用于獲取響應于對應的請求返回的任何數據。一個簡單的下載斷網可以完成與： ``` QNetworkAccessManager *manager = new QNetworkAccessManager(this); connect(manager, SIGNAL(finished([QNetworkReply](qnetworkreply.html)*)), this, SLOT(replyFinished([QNetworkReply](qnetworkreply.html)*))); manager->get([QNetworkRequest](qnetworkrequest.html)([QUrl](qurl.html)("http://qt.nokia.com"))); ``` QNetworkAccessManager有一個異步的API。當`replyFinished`槽上面被調用時，它需要的參數是[QNetworkReply](qnetworkreply.html)包含下載數據以及元數據（標題等）的對象。 **Note:**后的請求已經完成，它是用戶的責任，以刪除該[QNetworkReply](qnetworkreply.html)對象在適當的時間。不直接連接到插槽內刪除[finished](qnetworkaccessmanager.html#finished)（）。您可以使用[deleteLater](qobject.html#deleteLater)（）函數。 **Note:**QNetworkAccessManager隊列接收到的請求。并行執行的請求的數目是依賴于該協議。目前，在桌面平臺上的HTTP協議， 6請求是并行的一個主機/端口組合執行。一個更復雜的例子，假設經理已經存在，可以是： ``` [QNetworkRequest](qnetworkrequest.html) request; request.setUrl([QUrl](qurl.html)("http://qt.nokia.com")); request.setRawHeader("User-Agent", "MyOwnBrowser 1.0"); [QNetworkReply](qnetworkreply.html) *reply = manager->get(request); connect(reply, SIGNAL(readyRead()), this, SLOT(slotReadyRead())); connect(reply, SIGNAL(error([QNetworkReply](qnetworkreply.html).NetworkError)), this, SLOT(slotError([QNetworkReply](qnetworkreply.html).NetworkError))); connect(reply, SIGNAL(sslErrors([QList](index.htm)<[QSslError](qsslerror.html)>)), this, SLOT(slotSslErrors([QList](index.htm)<[QSslError](qsslerror.html)>))); ``` ### Network and Roaming support 與另外的[Bearer Management](index.htm)API來的Qt 4.7 QNetworkAccessManager獲得了管理網絡連接的能力。 QNetworkAccessManager可以從網絡接口，如果該設備處于脫機狀態，并終止該接口，如果當前過程是最后一個要使用的上行鏈路。請注意，某些平臺利用從上次停止的應用程序使用一個上行，直到系統實際終止的連接鏈路的寬限期。漫游同樣透明。任何排隊/掛起的網絡請求都自動轉移到新的接入點。客戶想利用此功能不應該進行任何更改。事實上，它很可能是現有的特定于平臺的連接代碼可以簡單地從應用程序中刪除。 **Note:**在QNetworkAccessManager網絡和漫游支持須待該平臺支持連接管理。該[QNetworkConfigurationManager.NetworkSessionRequired](qnetworkconfigurationmanager.html#Capability-enum)可用于檢測QNetworkAccessManager是否利用該功能。目前僅的Meego /哈麥丹和Symbian平臺提供了連接管理支持。 **Note:**這個功能可以不與承載管理API結合使用以將QtMobility提供。應用程序必須遷移到Qt的版本承載管理。 ### Symbian Platform Security Requirements 在Symbian ，它使用這個類的進程必須有`NetworkServices`平臺的安全能力。如果客戶端程序缺乏這種能力，操作將導致恐慌。平臺的安全功能是通過添加[TARGET.CAPABILITY](index.htm#target-capability)qmake的變量。 * * * ## Type Documentation ``` QNetworkAccessManager.NetworkAccessibility ``` 指示網絡是否是通過這個網絡訪問管理器訪問。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkAccessManager.UnknownAccessibility` | `-1` | 該網絡可訪問性不能確定。 | | `QNetworkAccessManager.NotAccessible` | `0` | 該網絡目前無法使用，要么是因為沒有網絡復蓋或網絡訪問已通過調用明確禁用目前還[setNetworkAccessible](qnetworkaccessmanager.html#networkAccessible-prop)（）。 | | `QNetworkAccessManager.Accessible` | `1` | 該網絡可訪問。 | **See also** [networkAccessible](qnetworkaccessmanager.html#networkAccessible-prop)。 ``` QNetworkAccessManager.Operation ``` 指示操作此回復正在處理。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkAccessManager.HeadOperation` | `1` | 檢索標題操作（創建[head](qnetworkaccessmanager.html#head)（）） | | `QNetworkAccessManager.GetOperation` | `2` | 檢索標題和??下載內容（與創建[get](qnetworkaccessmanager.html#get)（）） | | `QNetworkAccessManager.PutOperation` | `3` | 上傳內容操作（創建[put](qnetworkaccessmanager.html#put)（）） | | `QNetworkAccessManager.PostOperation` | `4` | 通過HTTP POST發送處理HTML表單的內容（與創建[post](qnetworkaccessmanager.html#post)（）） | | `QNetworkAccessManager.DeleteOperation` | `5` | 刪除的內容操作（創建[deleteResource](qnetworkaccessmanager.html#deleteResource)（）） | | `QNetworkAccessManager.CustomOperation` | `6` | 自定義操作（創建[sendCustomRequest](qnetworkaccessmanager.html#sendCustomRequest)（）） | 這個枚舉被引入或修改的Qt 4.7 。 **See also** [QNetworkReply.operation](qnetworkreply.html#operation)（）。 * * * ## Method Documentation ``` QNetworkAccessManager.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QNetworkAccessManager](qnetworkaccessmanager.html)對象，它是網絡訪問的API ，并設置中心_parent_作為父對象。 ``` QNetworkConfiguration QNetworkAccessManager.activeConfiguration (self) ``` [ 返回當前活動的網絡配置。 ](qnetworkconfiguration.html) [如果網絡配置通過返回](qnetworkconfiguration.html)[configuration](qnetworkaccessmanager.html#configuration)（）的類型為[QNetworkConfiguration.ServiceNetwork](qnetworkconfiguration.html#Type-enum)這個函數將返回配置的當前活動的子網絡配置。否則返回相同的網絡配置，[configuration](qnetworkaccessmanager.html#configuration)（）。使用此功能可返回當前的實際網絡配置中的網絡會話使用。此功能被引入Qt的4.7 。 **See also** [configuration](qnetworkaccessmanager.html#configuration)（）。 ``` QAbstractNetworkCache QNetworkAccessManager.cache (self) ``` [ 返回用于存儲從網絡獲得的數據的高速緩存。此功能被引入Qt的4.5 。 ](qabstractnetworkcache.html) [**See also**](qabstractnetworkcache.html) [setCache](qnetworkaccessmanager.html#setCache)（）。 ``` QNetworkConfiguration QNetworkAccessManager.configuration (self) ``` [](qnetworkconfiguration.html) [返回將被用來創建網絡配置中的](qnetworkconfiguration.html)[network session](qnetworksession.html)處理網絡請求時，將被使用。此功能被引入Qt的4.7 。 **See also** [setConfiguration](qnetworkaccessmanager.html#setConfiguration)（）和[activeConfiguration](qnetworkaccessmanager.html#activeConfiguration)（）。 ``` QNetworkCookieJar QNetworkAccessManager.cookieJar (self) ``` [](qnetworkcookiejar.html) [返回](qnetworkcookiejar.html)[QNetworkCookieJar](qnetworkcookiejar.html)用來存儲從所述網絡以及餅干是將要被發送得到的cookie。 **See also** [setCookieJar](qnetworkaccessmanager.html#setCookieJar)（）。 ``` QNetworkReply QNetworkAccessManager.createRequest (self, Operation?op, QNetworkRequest?request, QIODevice?device?=?None) ``` [](qnetworkreply.html) [返回一個新的](qnetworkreply.html)[QNetworkReply](qnetworkreply.html)反對處理操作_op_并要求_req_。該裝置_outgoingData_始終為0 GET和HEAD請求，但該值傳遞給[post](qnetworkaccessmanager.html#post)（）和[put](qnetworkaccessmanager.html#put)（）這些操作（[QByteArray](qbytearray.html)變種會通過一個[QBuffer](qbuffer.html)對象）。默認實現調用[QNetworkCookieJar.cookiesForUrl](qnetworkcookiejar.html#cookiesForUrl)（）上的餅干罐設置[setCookieJar](qnetworkaccessmanager.html#setCookieJar)（）來獲得將要發送到遠程服務器的餅干。返回的對象必須處于打開狀態。 ``` QNetworkReply QNetworkAccessManager.deleteResource (self, QNetworkRequest?request) ``` [ 發送刪除確定的URL的資源的請求_request_。 **Note:**此功能目前僅適用于HTTP ，執行一個HTTP DELETE請求。此功能被引入Qt的4.6 。 ](qnetworkreply.html) [**See also**](qnetworkreply.html) [get](qnetworkaccessmanager.html#get)（）[post](qnetworkaccessmanager.html#post)（）[put](qnetworkaccessmanager.html#put)（）和[sendCustomRequest](qnetworkaccessmanager.html#sendCustomRequest)（）。 ``` QNetworkReply QNetworkAccessManager.get (self, QNetworkRequest?request) ``` [](qnetworkreply.html) [投遞一個請求，以獲得目標的內容_request_并返回一個新的](qnetworkreply.html)[QNetworkReply](qnetworkreply.html)對象打開閱讀，發射的[readyRead()](qiodevice.html#readyRead)每當新的數據到達信號。的內容以及相關的頭文件會被下載。 **See also** [post](qnetworkaccessmanager.html#post)（）[put](qnetworkaccessmanager.html#put)（）[deleteResource](qnetworkaccessmanager.html#deleteResource)（）和[sendCustomRequest](qnetworkaccessmanager.html#sendCustomRequest)（）。 ``` QNetworkReply QNetworkAccessManager.head (self, QNetworkRequest?request) ``` [](qnetworkreply.html) [投遞一個請求以獲得對網絡的標頭_request_并返回一個新的](qnetworkreply.html)[QNetworkReply](qnetworkreply.html)對象將包含這個頭。相關（ HEAD ）的HTTP請求后，該函數命名。 ``` NetworkAccessibility QNetworkAccessManager.networkAccessible (self) ``` [](qnetworkaccessmanager.html#NetworkAccessibility-enum) ``` QNetworkReply QNetworkAccessManager.post (self, QNetworkRequest?request, QIODevice?data) ``` [](qnetworkreply.html) [發送一個HTTP POST請求向指定的目的地_request_并返回一個新的](qnetworkreply.html)[QNetworkReply](qnetworkreply.html)對象為讀而打開將包含由服務器發送回復。的內容_data_設備將被上傳到服務器。 _data_必須是開放的閱讀和必須保持有效，直到[finished](qnetworkaccessmanager.html#finished)（）信號被發射這個答復。 **Note:**在協議比HTTP和HTTPS等發送POST請求是不確定的，可能會失敗。 **See also** [get](qnetworkaccessmanager.html#get)（）[put](qnetworkaccessmanager.html#put)（）[deleteResource](qnetworkaccessmanager.html#deleteResource)（）和[sendCustomRequest](qnetworkaccessmanager.html#sendCustomRequest)（）。 ``` QNetworkReply QNetworkAccessManager.post (self, QNetworkRequest?request, QByteArray?data) ``` [ 這是一個重載函數。發送的內容_data_字節數組通過指定的目標_request_。 ](qnetworkreply.html) ``` QNetworkReply QNetworkAccessManager.post (self, QNetworkRequest?request, QHttpMultiPart?multiPart) ``` [ 這是一個重載函數。發送的內容_multiPart_消息由指定的目標_request_。這可以用于通過HTTP發送的MIME多部分消息。此功能被引入Qt的4.8 。 ](qnetworkreply.html) [**See also**](qnetworkreply.html) [QHttpMultiPart](qhttpmultipart.html)，[QHttpPart](qhttppart.html)和[put](qnetworkaccessmanager.html#put)（）。 ``` QNetworkProxy QNetworkAccessManager.proxy (self) ``` [](qnetworkproxy.html) [返回](qnetworkproxy.html)[QNetworkProxy](qnetworkproxy.html)使用這個發送的請求[QNetworkAccessManager](qnetworkaccessmanager.html)對象將使用。對于代理的默認值是[QNetworkProxy.DefaultProxy](qnetworkproxy.html#ProxyType-enum)。 **See also** [setProxy](qnetworkaccessmanager.html#setProxy)（）[setProxyFactory](qnetworkaccessmanager.html#setProxyFactory)（）和[proxyAuthenticationRequired](qnetworkaccessmanager.html#proxyAuthenticationRequired)（）。 ``` QNetworkProxyFactory QNetworkAccessManager.proxyFactory (self) ``` [](qnetworkproxyfactory.html) [返回的代理工廠，這](qnetworkproxyfactory.html)[QNetworkAccessManager](qnetworkaccessmanager.html)對象正在使用，以確定要用于請求的代理。請注意，這個函數返回的指針是由管理[QNetworkAccessManager](qnetworkaccessmanager.html)并且可以在任何時候被刪除。此功能被引入Qt的4.5 。 **See also** [setProxyFactory](qnetworkaccessmanager.html#setProxyFactory)（）和[proxy](qnetworkaccessmanager.html#proxy)（）。 ``` QNetworkReply QNetworkAccessManager.put (self, QNetworkRequest?request, QIODevice?data) ``` [](qnetworkreply.html) [上傳的內容_data_到目的地_request_和returnes新](qnetworkreply.html)[QNetworkReply](qnetworkreply.html)對象將公開答復。 _data_必須打開進行讀取時，這個函數被調用，并且必須保持有效，直到[finished](qnetworkaccessmanager.html#finished)（）信號被發射這個答復。無論是什么將可從返回的對象中讀取取決于協議。對于HTTP ，服務器可能會發送一個小的HTML頁面顯示上傳成功（或不）。其他協議可能會在他們的答復內容。 **Note:**對于HTTP ，申請將發送一個PUT請求，其中大部分服務器不允許。表單上傳機制，包括通過HTML表單上傳文件，使用POST機制。 **See also** [get](qnetworkaccessmanager.html#get)（）[post](qnetworkaccessmanager.html#post)（）[deleteResource](qnetworkaccessmanager.html#deleteResource)（）和[sendCustomRequest](qnetworkaccessmanager.html#sendCustomRequest)（）。 ``` QNetworkReply QNetworkAccessManager.put (self, QNetworkRequest?request, QByteArray?data) ``` [ 這是一個重載函數。發送的內容_multiPart_消息由指定的目標_request_。這可以用于通過HTTP發送的MIME多部分消息。此功能被引入Qt的4.8 。 ](qnetworkreply.html) [**See also**](qnetworkreply.html) [QHttpMultiPart](qhttpmultipart.html)，[QHttpPart](qhttppart.html)和[post](qnetworkaccessmanager.html#post)（）。 ``` QNetworkReply QNetworkAccessManager.put (self, QNetworkRequest?request, QHttpMultiPart?multiPart) ``` [ 這是一個重載函數。發送的內容_data_字節數組通過指定的目標_request_。 ](qnetworkreply.html) ``` QNetworkReply QNetworkAccessManager.sendCustomRequest (self, QNetworkRequest?request, QByteArray?verb, QIODevice?data?=?None) ``` [ 發送一個自定義的要求確定的URL的服務器_request_。它是用戶的責任來發送_verb_到，根據HTTP規范是有效的服務器。 ](qnetworkreply.html) [這種方法提供了手段來發送動詞比普通的人通過其他提供](qnetworkreply.html)[get](qnetworkaccessmanager.html#get)（）或[post](qnetworkaccessmanager.html#post)（）等，例如發送一個HTTP OPTIONS命令。 If _data_不為空，的內容_data_設備將被上傳到服務器，在這種情況下，數據必須是開放的閱讀和必須保持有效，直到[finished](qnetworkaccessmanager.html#finished)（）信號被發射這個答復。 **Note:**此功能目前僅適用于HTTP（S ）只。此功能被引入Qt的4.7 。 **See also** [get](qnetworkaccessmanager.html#get)（）[post](qnetworkaccessmanager.html#post)（）[put](qnetworkaccessmanager.html#put)（）和[deleteResource](qnetworkaccessmanager.html#deleteResource)（）。 ``` QNetworkAccessManager.setCache (self, QAbstractNetworkCache?cache) ``` 該_cache_說法有它的所有權轉移給Qt的。設置管理器的網絡緩存是_cache_規定。緩存用于由經理分派的所有請求。使用此功能可在網絡緩存對象設置為實現附加功能的類，比如保存cookie來永久存儲。 **Note:** [QNetworkAccessManager](qnetworkaccessmanager.html)采取所有權_cache_對象。 [QNetworkAccessManager](qnetworkaccessmanager.html)默認情況下，沒有一個集緩存。 Qt提供了一個簡單的磁盤緩存，[QNetworkDiskCache](qnetworkdiskcache.html)，它可以被使用。此功能被引入Qt的4.5 。 **See also** [cache](qnetworkaccessmanager.html#cache)（）和[QNetworkRequest.CacheLoadControl](qnetworkrequest.html#CacheLoadControl-enum)。 ``` QNetworkAccessManager.setConfiguration (self, QNetworkConfiguration?config) ``` 設置創建時將要使用的網絡配置中的[network session](qnetworksession.html)至_config_。網絡配置使用了需要網絡接入過程中的任何請求之前創建并打開一個網絡會話。如果沒有網絡配置通過此功能的網絡配置返回的明確設置[QNetworkConfigurationManager.defaultConfiguration](qnetworkconfigurationmanager.html#defaultConfiguration)（）將被使用。要恢復設置網絡配置值的默認網絡配置從返回[QNetworkConfigurationManager.defaultConfiguration](qnetworkconfigurationmanager.html#defaultConfiguration)（）。 ``` [QNetworkConfigurationManager](qnetworkconfigurationmanager.html) manager; networkAccessManager->setConfiguration(manager.defaultConfiguration()); ``` 如果一個無效的網絡配置設置，一個網絡會話將無法建立。在這種情況下，網絡請求將照常進行處理，但可能會失敗。例如： ``` networkAccessManager->setConfiguration([QNetworkConfiguration](qnetworkconfiguration.html)()); ``` 此功能被引入Qt的4.7 。 **See also** [configuration](qnetworkaccessmanager.html#configuration)（）和[QNetworkSession](qnetworksession.html)。 ``` QNetworkAccessManager.setCookieJar (self, QNetworkCookieJar?cookieJar) ``` 該_cookieJar_說法有它的所有權轉移給Qt的。設置管理員的餅干罐是_cookieJar_規定。餅干罐是用來由經理分派的所有請求。使用此功能可將餅干罐對象設置為實現附加功能的類，比如保存cookie來永久存儲。 **Note:** [QNetworkAccessManager](qnetworkaccessmanager.html)采取所有權_cookieJar_對象。 If _cookieJar_是在同一個線程，因為這[QNetworkAccessManager](qnetworkaccessmanager.html)，它將設置的父_cookieJar_所以，當這個對象被刪除，以及餅干罐被刪除。如果你想與不同的共享餅干罐[QNetworkAccessManager](qnetworkaccessmanager.html)對象，你可能要調用此函數后的餅干罐的父設置為0 。 [QNetworkAccessManager](qnetworkaccessmanager.html)默認情況下，不執行任何自己的cookie策略：它接受由服務器發送的所有cookie ，只要他們形成良好并符合最低安全要求（ cookie的域相匹配的要求及cookie路徑相匹配的要求的）。為了實現自己的安全策略，復蓋[QNetworkCookieJar.cookiesForUrl](qnetworkcookiejar.html#cookiesForUrl)（）和[QNetworkCookieJar.setCookiesFromUrl](qnetworkcookiejar.html#setCookiesFromUrl)（）虛函數。這些功能是通過所謂的[QNetworkAccessManager](qnetworkaccessmanager.html)它檢測到一個新的cookie時。 **See also** [cookieJar](qnetworkaccessmanager.html#cookieJar)（）[QNetworkCookieJar.cookiesForUrl](qnetworkcookiejar.html#cookiesForUrl)（）和[QNetworkCookieJar.setCookiesFromUrl](qnetworkcookiejar.html#setCookiesFromUrl)（）。 ``` QNetworkAccessManager.setNetworkAccessible (self, NetworkAccessibility?accessible) ``` ``` QNetworkAccessManager.setProxy (self, QNetworkProxy?proxy) ``` 設置要用于以后的請求被代理_proxy_。這不會影響已發送的請求。該[proxyAuthenticationRequired](qnetworkaccessmanager.html#proxyAuthenticationRequired)（）信號，如果代理要求驗證發射。代理設置此功能將被用于發出的所有請求[QNetworkAccessManager](qnetworkaccessmanager.html)。在某些情況下，可能需要選擇不同的代理取決于被發送的請求的類型或目的主機。如果是那樣的話，你應該考慮使用[setProxyFactory](qnetworkaccessmanager.html#setProxyFactory)（）。 **See also** [proxy](qnetworkaccessmanager.html#proxy)（）和[proxyAuthenticationRequired](qnetworkaccessmanager.html#proxyAuthenticationRequired)（）。 ``` QNetworkAccessManager.setProxyFactory (self, QNetworkProxyFactory?factory) ``` 該_factory_說法有它的所有權轉移給Qt的。設置代理工廠這個類是_factory_。代理工廠被用來確定代理要用于給定要求的更具體的列表，而不是試圖用所有請求相同的代理值。通過發送所有查詢[QNetworkAccessManager](qnetworkaccessmanager.html)將有型[QNetworkProxyQuery.UrlRequest](qnetworkproxyquery.html#QueryType-enum)。例如，一個代理工廠可以應用下面的規則： * if the target address is in the local network (for example, if the hostname contains no dots or if it's an IP address in the organization's range), return [QNetworkProxy.NoProxy](qnetworkproxy.html#ProxyType-enum) * if the request is FTP, return an FTP proxy * if the request is HTTP or HTTPS, then return an HTTP proxy * otherwise, return a SOCKSv5 proxy server 的對象的生存期_factory_將由管理[QNetworkAccessManager](qnetworkaccessmanager.html)。它會刪除該對象時必要的。 **Note:**如果一個特定的代理設置與[setProxy](qnetworkaccessmanager.html#setProxy)（），工廠將不會被使用。此功能被引入Qt的4.5 。 **See also** [proxyFactory](qnetworkaccessmanager.html#proxyFactory)（）[setProxy](qnetworkaccessmanager.html#setProxy)（）和[QNetworkProxyQuery](qnetworkproxyquery.html)。 * * * ## Qt Signal Documentation ``` void authenticationRequired (QNetworkReply *,QAuthenticator *) ``` 這是該信號的默認超載。每當最后服務器請求驗證之前它提供所請求的內容這個信號被發射。連接到這個信號槽應填寫憑證的內容（這可以通過檢查來確定_reply_對象）的_authenticator_對象。 [QNetworkAccessManager](qnetworkaccessmanager.html)將在內部緩存的憑據，將發送相同的值，如果服務器再次需要認證，不發光的authenticationRequired （）信號。如果它拒絕的憑據，該信號將被再次發射。 **Note:**這是不可能使用QueuedConnection連接到該信號，就好像所述認證沒有被填充了新的信息時，該信號返回的連接失敗。 **See also** [proxyAuthenticationRequired](qnetworkaccessmanager.html#proxyAuthenticationRequired)（）。 ``` void finished (QNetworkReply *) ``` 這是該信號的默認超載。每當一個懸而未決的網絡應答結束這個信號被發射。該_reply_參數將包含一個指針，它指向剛剛結束的答復。這個信號在串聯與發射[QNetworkReply.finished](qnetworkreply.html#finished)（）信號。 See [QNetworkReply.finished](qnetworkreply.html#finished)（）以了解關于狀態的對象將是英寸信息 **Note:**不要刪除_reply_對象在連接到該信號的時隙。使用[deleteLater](qobject.html#deleteLater)（）。 **See also** [QNetworkReply.finished](qnetworkreply.html#finished)（）和[QNetworkReply.error](qnetworkreply.html#error)（）。 ``` void networkAccessibleChanged (QNetworkAccessManager::NetworkAccessibility) ``` 這是該信號的默認超載。這個信號被發射時的值[networkAccessible](qnetworkaccessmanager.html#networkAccessible-prop)屬性更改。_accessible_是新的網絡接入。 ``` void proxyAuthenticationRequired (const QNetworkProxy&,QAuthenticator *) ``` 這是該信號的默認超載。這個信號被發射時的代理請求驗證和[QNetworkAccessManager](qnetworkaccessmanager.html)無法找到一個有效的，緩存的憑據。連接到這個信號的時隙應填寫為代理的憑據_proxy_在_authenticator_對象。 [QNetworkAccessManager](qnetworkaccessmanager.html)將在內部緩存的憑據。在下一次代理請求驗證，[QNetworkAccessManager](qnetworkaccessmanager.html)會自動發送相同的認證，而無需再次發射proxyAuthenticationRequired信號。如果代理服務器拒絕的憑據，[QNetworkAccessManager](qnetworkaccessmanager.html)將再次發射該信號。 **See also** [proxy](qnetworkaccessmanager.html#proxy)（）[setProxy](qnetworkaccessmanager.html#setProxy)（）和[authenticationRequired](qnetworkaccessmanager.html#authenticationRequired)（）。 ``` void sslErrors (QNetworkReply *,const QList<QSslError>&) ``` 這是該信號的默認超載。這個信號被發射，如果SSL / TLS會話期間，成立了包括證書驗證錯誤，遇到錯誤。該_errors_參數包含錯誤的列表，_reply_是[QNetworkReply](qnetworkreply.html)所遇到的這些錯誤。為了表明這些錯誤不是致命的，而連接應進行，[QNetworkReply.ignoreSslErrors](qnetworkreply.html#ignoreSslErrors)（）函數應該被稱為從連接到該信號的時隙。如果它不叫， SSL會話將被推倒的任何數據交換（包括URL）之前。這個信號可以被用來顯示一個錯誤消息，指示安全性可能會受到影響的用戶，并顯示在SSL設置（參見sslConfiguration （）來獲得的話）。如果用戶決定繼續進行遠程證明分析后，槽應調用ignoreSslErrors （）。 **See also** [QSslSocket.sslErrors](qsslsocket.html#sslErrors)（）[QNetworkReply.sslErrors](qnetworkreply.html#sslErrors)（）[QNetworkReply.sslConfiguration](qnetworkreply.html#sslConfiguration)（）和[QNetworkReply.ignoreSslErrors](qnetworkreply.html#ignoreSslErrors)（）。