QNetworkProxyQuery Class Reference · PyQt4 中文文檔

# QNetworkProxyQuery Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkProxyQuery類用于查詢套接字的代理服務器設置[More...](#details) ### Types * `enum QueryType { TcpSocket, UdpSocket, TcpServer, UrlRequest }` ### Methods * `__init__ (self)` * `__init__ (self, QUrl?requestUrl, QueryType?type?=?QNetworkProxyQuery.UrlRequest)` * `__init__ (self, QString?hostname, int?port, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpSocket)` * `__init__ (self, int?bindPort, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpServer)` * `__init__ (self, QNetworkConfiguration?networkConfiguration, QUrl?requestUrl, QueryType?queryType?=?QNetworkProxyQuery.UrlRequest)` * `__init__ (self, QNetworkConfiguration?networkConfiguration, QString?hostname, int?port, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpSocket)` * `__init__ (self, QNetworkConfiguration?networkConfiguration, int?bindPort, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpServer)` * `__init__ (self, QNetworkProxyQuery?other)` * `int localPort (self)` * `QNetworkConfiguration networkConfiguration (self)` * `QString peerHostName (self)` * `int peerPort (self)` * `QString protocolTag (self)` * `QueryType queryType (self)` * `setLocalPort (self, int?port)` * `setNetworkConfiguration (self, QNetworkConfiguration?networkConfiguration)` * `setPeerHostName (self, QString?hostname)` * `setPeerPort (self, int?port)` * `setProtocolTag (self, QString?protocolTag)` * `setQueryType (self, QueryType?type)` * `setUrl (self, QUrl?url)` * `QUrl url (self)` ### Special Methods * `bool __eq__ (self, QNetworkProxyQuery?other)` * `bool __ne__ (self, QNetworkProxyQuery?other)` * * * ## Detailed Description 該QNetworkProxyQuery類用于查詢套接字的代理服務器設置 QNetworkProxyQuery持有被創建一個套接字，或正在取得請求的詳細信息。它是利用[QNetworkProxy](qnetworkproxy.html)和[QNetworkProxyFactory](qnetworkproxyfactory.html)允許應用程序有一個更細粒度控制哪些代理服務器的使用，根據查詢的詳細信息。這使得應用程序可以應用不同的設置，根據該協議或目的地的主機名，例如。 QNetworkProxyQuery支持用于選擇代理以下條件： * the type of query * the local port number to use * the destination host name * the destination port number * the protocol name, such as "http" or "ftp" * the URL being requested 目標主機名稱是在即將離任的連接插座的情況下，連接的主機。它是`hostName`傳遞給參數[QTcpSocket.connectToHost](qabstractsocket.html#connectToHost)（）或要求與URL的主機組件[QNetworkRequest](qnetworkrequest.html)。目的端口號是請求的端口連接到在傳出插座的情況下，而本地端口號是socket希望嘗試進行外部連接之前在本地使用的端口。在大多數情況下，本地端口號用于監聽套接字只（[QTcpSocket](qtcpsocket.html)）或數據報套接字（[QUdpSocket](qudpsocket.html)）。協議名稱是一個任意的字符串，它表示連接正在嘗試的類型。例如，它可以匹配URL的模式，就是“http ” ， “ https”開頭和“ FTP ” 。在大多數情況下，該代理選擇不會取決于協議改變，但是這個信息被提供的情況下更好的選擇可以由，例如用于基于HTTP的連接選擇一個高速緩存的HTTP代理服務器，但對于所有其他功能更強大的SOCKSv5代理。網絡配置指定要使用的配置，當承載管理使用。例如在手機中的代理設置可能是不同的蜂窩網絡與WLAN 。有些標準可能是沒有意義的所有的查詢類型。下面的表列出了最常用的標準，根據查詢的類型。 | Query type | Description | | --- | --- | | [TcpSocket](qnetworkproxyquery.html#QueryType-enum) | Normal sockets requesting a connection to a remote server, like [QTcpSocket](qtcpsocket.html). The peer hostname and peer port match the values passed to [QTcpSocket.connectToHost](qabstractsocket.html#connectToHost)(). The local port is usually -1, indicating the socket has no preference in which port should be used. The URL component is not used. | | [UdpSocket](qnetworkproxyquery.html#QueryType-enum) | Datagram-based sockets, which can both send and receive. The local port, remote host or remote port fields can all be used or be left unused, depending on the characteristics of the socket. The URL component is not used. | | [TcpServer](qnetworkproxyquery.html#QueryType-enum) | Passive server sockets that listen on a port and await incoming connections from the network. Normally, only the local port is used, but the remote address could be used in specific circumstances, for example to indicate which remote host a connection is expected from. The URL component is not used. | | [UrlRequest](qnetworkproxyquery.html#QueryType-enum) | A more high-level request, such as those coming from [QNetworkAccessManager](qnetworkaccessmanager.html). These requests will inevitably use an outgoing TCP socket, but the this query type is provided to indicate that more detailed information is present in the URL component. For ease of implementation, the URL's host and port are set as the destination address. | 但應注意的是，任何一個規則可能會丟失或未知（空[QString](qstring.html)對于主機名或協議名稱， -1為端口號）。如果出現這種情況，執行查詢的功能應該讓他們的最好的猜測或應用某些實現定義的默認值。 * * * ## Type Documentation ``` QNetworkProxyQuery.QueryType ``` 描述1的類型[QNetworkProxyQuery](qnetworkproxyquery.html)查詢。 | Constant | Value | Description | | --- | --- | --- | | `QNetworkProxyQuery.TcpSocket` | `0` | 一個正常的，傳出TCP套接字 | | `QNetworkProxyQuery.UdpSocket` | `1` | 一個基于數據報的UDP套接字，它可以發送到多個目的地 | | `QNetworkProxyQuery.TcpServer` | `100` | 用于偵聽來自網絡的傳入連接TCP服務器 | | `QNetworkProxyQuery.UrlRequest` | `101` | 一個更復雜的要求，涉及裝載的URL | **See also** [queryType](qnetworkproxyquery.html#queryType)（）和[setQueryType](qnetworkproxyquery.html#setQueryType)（）。 * * * ## Method Documentation ``` QNetworkProxyQuery.__init__ (self) ``` 構造一個默認的[QNetworkProxyQuery](qnetworkproxyquery.html)對象。默認情況下，查詢類型將是[QNetworkProxyQuery.TcpSocket](qnetworkproxyquery.html#QueryType-enum)。 ``` QNetworkProxyQuery.__init__ (self, QUrl?requestUrl, QueryType?type?=?QNetworkProxyQuery.UrlRequest) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)與URL_requestUrl_并設置查詢類型_queryType_。 **See also** [protocolTag](qnetworkproxyquery.html#protocolTag)（）[peerHostName](qnetworkproxyquery.html#peerHostName)（）和[peerPort](qnetworkproxyquery.html#peerPort)（）。 ``` QNetworkProxyQuery.__init__ (self, QString?hostname, int?port, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpSocket) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)類型_queryType_并將協議標籤是_protocolTag_。此構造適合[QNetworkProxyQuery.TcpSocket](qnetworkproxyquery.html#QueryType-enum)查詢，因為它設置了對主機名_hostname_而到同行的端口號_port_。 ``` QNetworkProxyQuery.__init__ (self, int?bindPort, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpServer) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)類型_queryType_并將協議標籤是_protocolTag_。此構造適合[QNetworkProxyQuery.TcpSocket](qnetworkproxyquery.html#QueryType-enum)查詢，因為它設置的本地端口號_bindPort_。需要注意的是_bindPort_是類型quint16的指示所請求的具體的端口號。在此上下文中是不允許的-1 （未知）的值。 **See also** [localPort](qnetworkproxyquery.html#localPort)（）。 ``` QNetworkProxyQuery.__init__ (self, QNetworkConfiguration?networkConfiguration, QUrl?requestUrl, QueryType?queryType?=?QNetworkProxyQuery.UrlRequest) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)對象，它是一個拷貝_other_。 ``` QNetworkProxyQuery.__init__ (self, QNetworkConfiguration?networkConfiguration, QString?hostname, int?port, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpSocket) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)與URL_requestUrl_并設置查詢類型_queryType_。指定_networkConfiguration_用于解析代理服務器設置。此功能被引入Qt的4.8 。 **See also** [protocolTag](qnetworkproxyquery.html#protocolTag)（）[peerHostName](qnetworkproxyquery.html#peerHostName)（）[peerPort](qnetworkproxyquery.html#peerPort)（）和[networkConfiguration](qnetworkproxyquery.html#networkConfiguration)（）。 ``` QNetworkProxyQuery.__init__ (self, QNetworkConfiguration?networkConfiguration, int?bindPort, QString?protocolTag?=?QString(), QueryType?type?=?QNetworkProxyQuery.TcpServer) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)類型_queryType_并將協議標籤是_protocolTag_。此構造適合[QNetworkProxyQuery.TcpSocket](qnetworkproxyquery.html#QueryType-enum)查詢，因為它設置了對主機名_hostname_而到同行的端口號_port_。指定_networkConfiguration_用于解析代理服務器設置。此功能被引入Qt的4.8 。 **See also** [networkConfiguration](qnetworkproxyquery.html#networkConfiguration)（）。 ``` QNetworkProxyQuery.__init__ (self, QNetworkProxyQuery?other) ``` 構造一個[QNetworkProxyQuery](qnetworkproxyquery.html)類型_queryType_并將協議標籤是_protocolTag_。此構造適合[QNetworkProxyQuery.TcpSocket](qnetworkproxyquery.html#QueryType-enum)查詢，因為它設置的本地端口號_bindPort_。指定_networkConfiguration_用于解析代理服務器設置。需要注意的是_bindPort_是類型quint16的指示所請求的具體的端口號。在此上下文中是不允許的-1 （未知）的值。此功能被引入Qt的4.8 。 **See also** [localPort](qnetworkproxyquery.html#localPort)（）和[networkConfiguration](qnetworkproxyquery.html#networkConfiguration)（）。 ``` int QNetworkProxyQuery.localPort (self) ``` 返回套接字將接受來自遠程服務器的入站數據包或-1，如果該端口是不知道的端口號。 **See also** [peerPort](qnetworkproxyquery.html#peerPort)（）[peerHostName](qnetworkproxyquery.html#peerHostName)（）和[setLocalPort](qnetworkproxyquery.html#setLocalPort)（）。 ``` QNetworkConfiguration QNetworkProxyQuery.networkConfiguration (self) ``` [ 返回代理查詢的網絡配置。 ](qnetworkconfiguration.html) [**See also**](qnetworkconfiguration.html) [setNetworkConfiguration](qnetworkproxyquery.html#setNetworkConfiguration)（）。 ``` QString QNetworkProxyQuery.peerHostName (self) ``` 返回的主機名或所要求的出站連接的IP地址為，或如果遠程主機名不知道一個空字符串。如果查詢的類型是[QNetworkProxyQuery.UrlRequest](qnetworkproxyquery.html#QueryType-enum)，這個函數返回所請求的URL的主機組件。 **See also** [peerPort](qnetworkproxyquery.html#peerPort)（）[localPort](qnetworkproxyquery.html#localPort)（）和[setPeerHostName](qnetworkproxyquery.html#setPeerHostName)（）。 ``` int QNetworkProxyQuery.peerPort (self) ``` 返回傳出請求或端口號-1，如果端口號是不知道。如果查詢的類型是[QNetworkProxyQuery.UrlRequest](qnetworkproxyquery.html#QueryType-enum)，這個函數返回所請求的URL的端口號。一般情況下，框架將在端口號填入的默認值。 **See also** [peerHostName](qnetworkproxyquery.html#peerHostName)（）[localPort](qnetworkproxyquery.html#localPort)（）和[setPeerPort](qnetworkproxyquery.html#setPeerPort)（）。 ``` QString QNetworkProxyQuery.protocolTag (self) ``` 返回此協議標籤[QNetworkProxyQuery](qnetworkproxyquery.html)對象，或空[QString](qstring.html)的情況下的協議標籤是未知的。在類型的查詢的情況下，[QNetworkProxyQuery.UrlRequest](qnetworkproxyquery.html#QueryType-enum)，這個函數返回的URL的模式組件的值。 **See also** [setProtocolTag](qnetworkproxyquery.html#setProtocolTag)（）和[url](qnetworkproxyquery.html#url)（）。 ``` QueryType QNetworkProxyQuery.queryType (self) ``` [ 返回的查詢類型。 ](qnetworkproxyquery.html#QueryType-enum) [**See also**](qnetworkproxyquery.html#QueryType-enum) [setQueryType](qnetworkproxyquery.html#setQueryType)（）。 ``` QNetworkProxyQuery.setLocalPort (self, int?port) ``` 設置套接字希望使用本地接受來自遠程服務器的入站數據包的端口號_port_。本地端口是最經常與使用[QNetworkProxyQuery.TcpServer](qnetworkproxyquery.html#QueryType-enum)和[QNetworkProxyQuery.UdpSocket](qnetworkproxyquery.html#QueryType-enum)查詢類型。有效值為0到65535 （ 0表示任意端口號是可以接受的）或-1 ，這意味著本地端口號是未知或不適用的。在某些情況下，對于特殊協議，它的本地端口號也可以用類型的查詢中使用[QNetworkProxyQuery.TcpSocket](qnetworkproxyquery.html#QueryType-enum)。當發生這種情況時，插座表明它希望使用的端口號_port_連接到遠程主機時。 **See also** [localPort](qnetworkproxyquery.html#localPort)（）[setPeerPort](qnetworkproxyquery.html#setPeerPort)（）和[setPeerHostName](qnetworkproxyquery.html#setPeerHostName)（）。 ``` QNetworkProxyQuery.setNetworkConfiguration (self, QNetworkConfiguration?networkConfiguration) ``` 設置這個網絡配置組件[QNetworkProxyQuery](qnetworkproxyquery.html)反對是_networkConfiguration_。網絡配置可以被用來返回基于在網絡中使用不同的代理設置，例如WLAN與手機的蜂窩網絡。在“選擇用戶”或“服務網絡”配置的情況下，你應該先啟動[QNetworkSession](qnetworksession.html)從它的屬性得到有效配置。此功能被引入Qt的4.8 。 **See also** [networkConfiguration](qnetworkproxyquery.html#networkConfiguration)（）。 ``` QNetworkProxyQuery.setPeerHostName (self, QString?hostname) ``` 設置的出站連接被請求的主機名_hostname_。一個空的主機名可以被用來指示該遠程主機是未知的。對端的主機名，也可以用于指示在的情況下的輸入連接的預期源地址[QNetworkProxyQuery.UdpSocket](qnetworkproxyquery.html#QueryType-enum) or [QNetworkProxyQuery.TcpServer](qnetworkproxyquery.html#QueryType-enum)查詢類型。 **See also** [peerHostName](qnetworkproxyquery.html#peerHostName)（）[setPeerPort](qnetworkproxyquery.html#setPeerPort)（）和[setLocalPort](qnetworkproxyquery.html#setLocalPort)（）。 ``` QNetworkProxyQuery.setPeerPort (self, int?port) ``` 設置用于傳出連接是請求的端口號_port_。有效值為1到65535 ，或-1 ，表明遠程端口號是未知的。對端的端口號也可以用來指示在的情況下的輸入連接的預期端口號[QNetworkProxyQuery.UdpSocket](qnetworkproxyquery.html#QueryType-enum) or [QNetworkProxyQuery.TcpServer](qnetworkproxyquery.html#QueryType-enum)查詢類型。 **See also** [peerPort](qnetworkproxyquery.html#peerPort)（）[setPeerHostName](qnetworkproxyquery.html#setPeerHostName)（）和[setLocalPort](qnetworkproxyquery.html#setLocalPort)（）。 ``` QNetworkProxyQuery.setProtocolTag (self, QString?protocolTag) ``` 設置此協議標籤[QNetworkProxyQuery](qnetworkproxyquery.html)反對是_protocolTag_。該協議的電子標籤是一個任意的字符串，指示該協議正在談論過插座，如“ HTTP ” ， “ XMPP ” ， “遠程登錄” ，等等。協議標記是用于后端返回的要求是比較具體的有問題的協議：例如，一個HTTP連接可以使用緩存的HTTP代理服務器，而其他所有連接都使用一個更強大的SOCKSv5代理服務器。 **See also** [protocolTag](qnetworkproxyquery.html#protocolTag)（）。 ``` QNetworkProxyQuery.setQueryType (self, QueryType?type) ``` 設置為這個對象的查詢類型_type_。 **See also** [queryType](qnetworkproxyquery.html#queryType)（）。 ``` QNetworkProxyQuery.setUrl (self, QUrl?url) ``` 設置這個網址組件[QNetworkProxyQuery](qnetworkproxyquery.html)反對是_url_。設置URL也將設置協議標籤，遠程主機名和端口號。這樣做是為了以方便的代碼，用于確定要使用的代理服務器的執行。 **See also** [url](qnetworkproxyquery.html#url)（）[peerHostName](qnetworkproxyquery.html#peerHostName)（）和[peerPort](qnetworkproxyquery.html#peerPort)（）。 ``` QUrl QNetworkProxyQuery.url (self) ``` [](qurl.html) [返回此網址組件](qurl.html)[QNetworkProxyQuery](qnetworkproxyquery.html)在案件類型的查詢對象[QNetworkProxyQuery.UrlRequest](qnetworkproxyquery.html#QueryType-enum)。 **See also** [setUrl](qnetworkproxyquery.html#setUrl)（）。 ``` bool QNetworkProxyQuery.__eq__ (self, QNetworkProxyQuery?other) ``` ``` bool QNetworkProxyQuery.__ne__ (self, QNetworkProxyQuery?other) ```