QNetworkProxy Class Reference · PyQt4 中文文檔

# QNetworkProxy Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkProxy類提供了網絡層的代理。[More...](#details) ### Types * `class **[Capabilities](index.htm)**` * `enum Capability { TunnelingCapability, ListeningCapability, UdpTunnelingCapability, CachingCapability, HostNameLookupCapability }` * `enum ProxyType { DefaultProxy, Socks5Proxy, NoProxy, HttpProxy, HttpCachingProxy, FtpCachingProxy }` ### Methods * `__init__ (self)` * `__init__ (self, ProxyType?type, QString?hostName?=?QString(), int?port?=?0, QString?user?=?QString(), QString?password?=?QString())` * `__init__ (self, QNetworkProxy?other)` * `Capabilities capabilities (self)` * `QString hostName (self)` * `bool isCachingProxy (self)` * `bool isTransparentProxy (self)` * `QString password (self)` * `int port (self)` * `setCapabilities (self, Capabilities?capab)` * `setHostName (self, QString?hostName)` * `setPassword (self, QString?password)` * `setPort (self, int?port)` * `setType (self, ProxyType?type)` * `setUser (self, QString?userName)` * `ProxyType type (self)` * `QString user (self)` ### Static Methods * `QNetworkProxy applicationProxy ()` * `setApplicationProxy (QNetworkProxy?proxy)` ### Special Methods * `bool __eq__ (self, QNetworkProxy?other)` * `bool __ne__ (self, QNetworkProxy?other)` * * * ## Detailed Description 該QNetworkProxy類提供了網絡層的代理。 QNetworkProxy提供了方法來配置網絡層代理支持Qt的網絡類。目前支持的類[QAbstractSocket](qabstractsocket.html)，[QTcpSocket](qtcpsocket.html)，[QUdpSocket](qudpsocket.html)，[QTcpServer](qtcpserver.html)，[QNetworkAccessManager](qnetworkaccessmanager.html)和[QFtp](qftp.html)。該代理支持被設計成盡可能透明。這意味著，您已經編寫現有的網絡應用程序應該使用下面的代碼支持自動網絡代理。 ``` QNetworkProxy proxy; proxy.setType(QNetworkProxy.Socks5Proxy); proxy.setHostName("proxy.example.com"); proxy.setPort(1080); proxy.setUser("username"); proxy.setPassword("password"); QNetworkProxy.setApplicationProxy(proxy); ``` 另一種方法來設置應用程序范圍的代理是用來指定單個插座代理[QAbstractSocket.setProxy](qabstractsocket.html#setProxy)（）和[QTcpServer.setProxy](qtcpserver.html#setProxy)（）。以這種方式，有可能禁止使用使用以下代碼具體套接字的代理： ``` serverSocket->setProxy(QNetworkProxy.NoProxy); ``` 網絡代理不使用，如果所使用的地址[connectToHost()](qabstractsocket.html#connectToHost)，[bind()](qudpsocket.html#bind) or [listen()](qtcpserver.html#listen)相當于[QHostAddress.LocalHost](qhostaddress.html#SpecialAddress-enum) or [QHostAddress.LocalHostIPv6](qhostaddress.html#SpecialAddress-enum)。每種類型的代理支持具有與之相關的某些限制。你應該閱讀[ProxyType](qnetworkproxy.html#ProxyType-enum)文檔謹慎選擇代理類型使用之前。 **Note:**向當前連接的套接字更改不會生效。如果您需要更改連接的套接字，你應該重新連接。 ### SOCKS5 socks5的支持Qt的4是基于[RFC 1928](http://www.rfc-editor.org/rfc/rfc1928.txt)和[RFC 1929](http://www.rfc-editor.org/rfc/rfc1929.txt)。支持的身份驗證方法是沒有身份驗證和用戶名/密碼認證。 IPv4和IPv6的支持。域名是通過SOCKS5服務器解析，如果[QNetworkProxy.HostNameLookupCapability](qnetworkproxy.html#Capability-enum)被激活，否則它們是本地解析和IP地址被發送到服務器。有幾件事情使用SOCKS5用時要記住[QUdpSocket](qudpsocket.html)和[QTcpServer](qtcpserver.html)： With [QUdpSocket](qudpsocket.html)，調用[bind()](qudpsocket.html#bind)超時錯誤可能會失敗。如果不是0的端口號傳遞給[bind()](qudpsocket.html#bind)，它不能保證它是指定的端口將被使用。使用[localPort()](qabstractsocket.html#localPort)和[localAddress()](qabstractsocket.html#localAddress)得到實際使用中的地址和端口號。因為代理的UDP經過兩個UDP連接，它更可能是數據包將被丟棄。 With [QTcpServer](qtcpserver.html)調用[listen()](qtcpserver.html#listen)超時錯誤可能會失敗。如果不是0的端口號傳遞給[listen()](qtcpserver.html#listen)的話，就不能保證它是指定的端口將被使用。使用[serverPort()](qtcpserver.html#serverPort)和[serverAddress()](qtcpserver.html#serverAddress)得到的實際地址和端口用于偵聽連接。 SOCKS5只支持一個接受每個呼叫連接到[listen()](qtcpserver.html#listen)，并且每個呼叫很可能會導致不同的[serverPort()](qtcpserver.html#serverPort)被使用。 * * * ## Type Documentation ``` QNetworkProxy.Capability ``` 這些標志指示一個給定的代理服務器支持的功能。 [QNetworkProxy](qnetworkproxy.html)默認情況下，設置不同的功能在創建對象時（見[QNetworkProxy.ProxyType](qnetworkproxy.html#ProxyType-enum)為默認值的列表）。然而，這是可以改變capabitilies后的對象已經創建與[setCapabilities](qnetworkproxy.html#setCapabilities)（）。的功能，[QNetworkProxy](qnetworkproxy.html)支持有： | Constant | Value | Description | | --- | --- | --- | | `QNetworkProxy.TunnelingCapability` | `0x0001` | 能夠打開到遠程主機透明，隧道TCP連接。代理服務器中繼傳輸逐字從一個側面向其他并不做任何緩存。 | | `QNetworkProxy.ListeningCapability` | `0x0002` | 能夠創建一個監聽套接字，并等待來自遠程主機傳入的TCP連接。 | | `QNetworkProxy.UdpTunnelingCapability` | `0x0004` | 能夠通過代理服務器，并從遠程主機中繼的UDP數據報。 | | `QNetworkProxy.CachingCapability` | `0x0008` | 能力來緩存傳遞的內容。這種能力是具體到每個協議和代理類型。例如， HTTP代理緩存可以用“GET”命令傳送網絡數據的內容。 | | `QNetworkProxy.HostNameLookupCapability` | `0x0010` | 能夠連接到執行查找上一個遠程主機名，并連接到它，而不是要求應用程序執行名稱查找，并要求連接到的IP地址只。 | 這個枚舉被引入或修改的Qt 4.5 。功能類型是一個typedef為[QFlags](index.htm)\u003cCapability\u003e 。它存儲能力值的一個或組合。 ``` QNetworkProxy.ProxyType ``` 這個枚舉變量描述的Qt提供的網絡代理的類型。有兩種類型的代理Qt的理解：透明代理和緩存代理。第一組由代理服務器可以處理任意的數據傳輸，而第二個只能處理特定的請求。該緩存代理服務器才有意義的特定類，他們都可以使用。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkProxy.NoProxy` | `2` | 無代理使用 | | `QNetworkProxy.DefaultProxy` | `0` | 代理服務器是基于使用應用程序代理組確定[setApplicationProxy](qnetworkproxy.html#setApplicationProxy)（） | | `QNetworkProxy.Socks5Proxy` | `1` | [Socks5](qnetworkproxy.html#socks5)代理使用 | | `QNetworkProxy.HttpProxy` | `3` | HTTP透明代理時（此值是在4.3推出。） | | `QNetworkProxy.HttpCachingProxy` | `4` | 代理HTTP請求只（這個值被引入4.4 。） | | `QNetworkProxy.FtpCachingProxy` | `5` | 代理FTP請求只（這個值被引入4.4 。） | 下表列出了不同的代理類型和它們的功能。由于每個代理類型具有不同的功能，了解他們選擇代理類型之前，是很重要的。 | Proxy type | Description | Default capabilities | | --- | --- | --- | | SOCKS 5 | Generic proxy for any kind of connection. Supports TCP, UDP, binding to a port (incoming connections) and authentication. | [TunnelingCapability](qnetworkproxy.html#Capability-enum), [ListeningCapability](qnetworkproxy.html#Capability-enum), [UdpTunnelingCapability](qnetworkproxy.html#Capability-enum), [HostNameLookupCapability](qnetworkproxy.html#Capability-enum) | | HTTP | Implemented using the "CONNECT" command, supports only outgoing TCP connections; supports authentication. | [TunnelingCapability](qnetworkproxy.html#Capability-enum), [CachingCapability](qnetworkproxy.html#Capability-enum), [HostNameLookupCapability](qnetworkproxy.html#Capability-enum) | | Caching-only HTTP | Implemented using normal HTTP commands, it is useful only in the context of HTTP requests (see [QNetworkAccessManager](qnetworkaccessmanager.html)) | [CachingCapability](qnetworkproxy.html#Capability-enum), [HostNameLookupCapability](qnetworkproxy.html#Capability-enum) | | Caching FTP | Implemented using an FTP proxy, it is useful only in the context of FTP requests (see [QFtp](qftp.html), [QNetworkAccessManager](qnetworkaccessmanager.html)) | [CachingCapability](qnetworkproxy.html#Capability-enum), [HostNameLookupCapability](qnetworkproxy.html#Capability-enum) | 另外請注意，你不應該設置應用程序默認的代理（[setApplicationProxy](qnetworkproxy.html#setApplicationProxy)（））以不具有的代理[TunnelingCapability](qnetworkproxy.html#Capability-enum)能力。如果你這樣做，[QTcpSocket](qtcpsocket.html)將不知道如何打開連接。 **See also** [setType](qnetworkproxy.html#setType)（）[type](qnetworkproxy.html#type)（）[capabilities](qnetworkproxy.html#capabilities)（）和[setCapabilities](qnetworkproxy.html#setCapabilities)（）。 * * * ## Method Documentation ``` QNetworkProxy.__init__ (self) ``` 構造一個[QNetworkProxy](qnetworkproxy.html)同[DefaultProxy](qnetworkproxy.html#ProxyType-enum)輸入;代理類型是由確定[applicationProxy](qnetworkproxy.html#applicationProxy)（），默認為[NoProxy](qnetworkproxy.html#ProxyType-enum)。 **See also** [setType](qnetworkproxy.html#setType)（）和[setApplicationProxy](qnetworkproxy.html#setApplicationProxy)（）。 ``` QNetworkProxy.__init__ (self, ProxyType?type, QString?hostName?=?QString(), int?port?=?0, QString?user?=?QString(), QString?password?=?QString()) ``` 構造一個[QNetworkProxy](qnetworkproxy.html)同_type_，_hostName_，_port_，_user_和_password_。對代理類型的默認功能_type_會自動設定。 **See also** [capabilities](qnetworkproxy.html#capabilities)（）。 ``` QNetworkProxy.__init__ (self, QNetworkProxy?other) ``` 構造的副本_other_。 ``` QNetworkProxy QNetworkProxy.applicationProxy () ``` [ 返回應用程序級的網絡代理。 ](qnetworkproxy.html) [如果](qnetworkproxy.html)[QAbstractSocket](qabstractsocket.html) or [QTcpSocket](qtcpsocket.html)有[QNetworkProxy.DefaultProxy](qnetworkproxy.html#ProxyType-enum)輸入時，則[QNetworkProxy](qnetworkproxy.html)用于返回由該函數。 **See also** [QNetworkProxyFactory](qnetworkproxyfactory.html)，[setApplicationProxy](qnetworkproxy.html#setApplicationProxy)（）[QAbstractSocket.proxy](qabstractsocket.html#proxy)（）和[QTcpServer.proxy](qtcpserver.html#proxy)（）。 ``` Capabilities QNetworkProxy.capabilities (self) ``` [ 返回此代理服務器的功能。此功能被引入Qt的4.5 。 ](index.htm) [**See also**](index.htm) [setCapabilities](qnetworkproxy.html#setCapabilities)（）和[type](qnetworkproxy.html#type)（）。 ``` QString QNetworkProxy.hostName (self) ``` 返回代理主機的主機名。 **See also** [setHostName](qnetworkproxy.html#setHostName)（）[setPort](qnetworkproxy.html#setPort)（）和[port](qnetworkproxy.html#port)（）。 ``` bool QNetworkProxy.isCachingProxy (self) ``` 如果該代理支持，則返回True的[QNetworkProxy.CachingCapability](qnetworkproxy.html#Capability-enum)能力。在Qt 4.4的能力被捆綁到代理類型，但由于Qt的4.5就可以通過調用從代理中刪除高速緩存的能力[setCapabilities](qnetworkproxy.html#setCapabilities)（）。此功能被引入Qt的4.4 。 **See also** [capabilities](qnetworkproxy.html#capabilities)（）[type](qnetworkproxy.html#type)（）和[isTransparentProxy](qnetworkproxy.html#isTransparentProxy)（）。 ``` bool QNetworkProxy.isTransparentProxy (self) ``` 如果該代理支持TCP連接的透明隧道，則返回True 。這符合[QNetworkProxy.TunnelingCapability](qnetworkproxy.html#Capability-enum)能力。在Qt 4.4的能力被捆綁到代理類型，但由于Qt的4.5就可以通過調用從代理中刪除高速緩存的能力[setCapabilities](qnetworkproxy.html#setCapabilities)（）。此功能被引入Qt的4.4 。 **See also** [capabilities](qnetworkproxy.html#capabilities)（）[type](qnetworkproxy.html#type)（）和[isCachingProxy](qnetworkproxy.html#isCachingProxy)（）。 ``` QString QNetworkProxy.password (self) ``` 返回用于驗證的密碼。 **See also** [user](qnetworkproxy.html#user)（）[setPassword](qnetworkproxy.html#setPassword)（）和[setUser](qnetworkproxy.html#setUser)（）。 ``` int QNetworkProxy.port (self) ``` 返回代理主機的端口。 **See also** [setHostName](qnetworkproxy.html#setHostName)（）[setPort](qnetworkproxy.html#setPort)（）和[hostName](qnetworkproxy.html#hostName)（）。 ``` QNetworkProxy.setApplicationProxy (QNetworkProxy?proxy) ``` 設置應用程序級的網絡代理是_networkProxy_。如果[QAbstractSocket](qabstractsocket.html) or [QTcpSocket](qtcpsocket.html)有[QNetworkProxy.DefaultProxy](qnetworkproxy.html#ProxyType-enum)輸入時，則[QNetworkProxy](qnetworkproxy.html)設置使用此功能。如果你想確定哪個代理更多的靈活性，可以使用[QNetworkProxyFactory](qnetworkproxyfactory.html)類。設置默認值的代理使用此功能將復蓋應用程序代理工廠集與QNetworkProxyFactory.setApplicationProxyFactory 。 **See also** [QNetworkProxyFactory](qnetworkproxyfactory.html)，[applicationProxy](qnetworkproxy.html#applicationProxy)（）[QAbstractSocket.setProxy](qabstractsocket.html#setProxy)（）和[QTcpServer.setProxy](qtcpserver.html#setProxy)（）。 ``` QNetworkProxy.setCapabilities (self, Capabilities?capab) ``` 設置這個代理的功能，_capabilities_。此功能被引入Qt的4.5 。 **See also** [setType](qnetworkproxy.html#setType)（）和[capabilities](qnetworkproxy.html#capabilities)（）。 ``` QNetworkProxy.setHostName (self, QString?hostName) ``` 設置代理主機是主機名_hostName_。 **See also** [hostName](qnetworkproxy.html#hostName)（）[setPort](qnetworkproxy.html#setPort)（）和[port](qnetworkproxy.html#port)（）。 ``` QNetworkProxy.setPassword (self, QString?password) ``` 設置密碼代理身份驗證是_password_。 **See also** [user](qnetworkproxy.html#user)（）[setUser](qnetworkproxy.html#setUser)（）和[password](qnetworkproxy.html#password)（）。 ``` QNetworkProxy.setPort (self, int?port) ``` 設置代理主機的端口為_port_。 **See also** [hostName](qnetworkproxy.html#hostName)（）[setHostName](qnetworkproxy.html#setHostName)（）和[port](qnetworkproxy.html#port)（）。 ``` QNetworkProxy.setType (self, ProxyType?type) ``` 設置為代理類型此實例_type_。請注意，更改代理服務器的類型不改變設置的這個功能[QNetworkProxy](qnetworkproxy.html)如有能力已經設置對象持有[setCapabilities](qnetworkproxy.html#setCapabilities)（）。 **See also** [type](qnetworkproxy.html#type)（）和[setCapabilities](qnetworkproxy.html#setCapabilities)（）。 ``` QNetworkProxy.setUser (self, QString?userName) ``` 設置代理身份驗證是用戶名_user_。 **See also** [user](qnetworkproxy.html#user)（）[setPassword](qnetworkproxy.html#setPassword)（）和[password](qnetworkproxy.html#password)（）。 ``` ProxyType QNetworkProxy.type (self) ``` [ 返回代理類此實例。 ](qnetworkproxy.html#ProxyType-enum) [**See also**](qnetworkproxy.html#ProxyType-enum) [setType](qnetworkproxy.html#setType)（）。 ``` QString QNetworkProxy.user (self) ``` 返回用于認證的用戶名。 **See also** [setUser](qnetworkproxy.html#setUser)（）[setPassword](qnetworkproxy.html#setPassword)（）和[password](qnetworkproxy.html#password)（）。 ``` bool QNetworkProxy.__eq__ (self, QNetworkProxy?other) ``` ``` bool QNetworkProxy.__ne__ (self, QNetworkProxy?other) ```