QNetworkProxyQuery Class

成员函数文档

QNetworkProxyQuery::QNetworkProxyQuery()

创建一个默认的 QNetworkProxyQuery 对象。默认情况下，查询类型为QNetworkProxyQuery::TcpSocket 。

[explicit] QNetworkProxyQuery::QNetworkProxyQuery(const QUrl &requestUrl, QNetworkProxyQuery::QueryType queryType = UrlRequest)

使用 URLrequestUrl 构建一个 QNetworkProxyQuery，并将查询类型设置为queryType 。

另请参阅 protocolTag()、peerHostName() 以及peerPort()。

[explicit] QNetworkProxyQuery::QNetworkProxyQuery(quint16 bindPort, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpServer)

构建一个类型为queryType 的QNetworkProxyQuery，并将协议标签设置为protocolTag 。该构造函数适用于QNetworkProxyQuery::TcpSocket 查询，因为它将本地端口号设置为bindPort 。

请注意，bindPort 的类型为 quint16，用于指示所请求的确切端口号。在此上下文中不允许使用 -1（未知）作为值。

另请参阅 localPort()。

QNetworkProxyQuery::QNetworkProxyQuery(const QString &hostname, int port, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpSocket)

创建一个类型为queryType 的QNetworkProxyQuery对象，并将协议标签设置为protocolTag 。该构造函数适用于QNetworkProxyQuery::TcpSocket 查询，因为它将对等方的主机名设置为hostname ，并将对等方的端口号设置为port 。

QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkProxyQuery &other)

构建一个 QNetworkProxyQuery 对象，该对象是other 的副本。

[noexcept] QNetworkProxyQuery::~QNetworkProxyQuery()

销毁此QNetworkProxyQuery 对象。

int QNetworkProxyQuery::localPort() const

返回将接受来自远程服务器传入数据包的套接字端口号；如果端口未知，则返回 -1。

另请参阅 peerPort()、peerHostName() 和setLocalPort()。

QString QNetworkProxyQuery::peerHostName() const

返回所请求出站连接的主机名或 IP 地址；如果未知远程主机名，则返回空字符串。

如果查询类型为QNetworkProxyQuery::UrlRequest ，则该函数返回所请求 URL 中的主机部分。

另请参阅 peerPort()、localPort() 和setPeerHostName()。

int QNetworkProxyQuery::peerPort() const

返回出站请求的端口号；如果端口号未知，则返回 -1。

如果查询类型为QNetworkProxyQuery::UrlRequest ，则该函数返回所请求 URL 的端口号。通常，框架会根据其默认值自动填充端口号。

另请参阅 peerHostName()、localPort() 和setPeerPort()。

QString QNetworkProxyQuery::protocolTag() const

返回此QNetworkProxyQuery 对象的协议标签；如果协议标签未知，则返回一个空的QString 。

对于类型为 `QNetworkProxyQuery::UrlRequest` 的查询，此函数返回 URL 中方案组件的值。

另请参阅 setProtocolTag() 和url()。

QNetworkProxyQuery::QueryType QNetworkProxyQuery::queryType() const

返回查询类型。

另请参阅 setQueryType()。

void QNetworkProxyQuery::setLocalPort(int port)

设置套接字在本地用于从远程服务器接收发往port 的传入数据包的端口号。本地端口通常与QNetworkProxyQuery::TcpServer 和QNetworkProxyQuery::UdpSocket 这两种查询类型配合使用。

有效值为 0 到 65535（其中 0 表示接受任何端口号）或 -1，这意味着本地端口号未知或不适用。

在某些情况下，对于特殊协议，本地端口号也可与类型为QNetworkProxyQuery::TcpSocket 的查询一起使用。此时，套接字表示希望在连接到远程主机时使用端口号port 。

另请参阅 localPort()、setPeerPort() 和setPeerHostName()。

void QNetworkProxyQuery::setPeerHostName(const QString &hostname)

将请求的出站连接的主机名设置为hostname 。若主机名为空，则表示远程主机未知。

在QNetworkProxyQuery::UdpSocket 或QNetworkProxyQuery::TcpServer 查询类型中，对等主机名也可用于指示预期传入连接的源地址。

另请参阅 peerHostName()、setPeerPort() 和setLocalPort()。

void QNetworkProxyQuery::setPeerPort(int port)

将出站连接的请求端口号设置为port 。有效值为 1 到 65535，或 -1（表示远程端口号未知）。

在QNetworkProxyQuery::UdpSocket 或QNetworkProxyQuery::TcpServer 查询类型中，对端端口号也可用于指示预期传入连接的端口号。

另请参阅 peerPort()、setPeerHostName() 和setLocalPort()。

void QNetworkProxyQuery::setProtocolTag(const QString &protocolTag)

将此QNetworkProxyQuery 对象的协议标签设置为protocolTag 。

协议标签是一个任意字符串，用于指示套接字上正在使用的协议，例如“http”、“xmpp”、“telnet”等。 后端会利用协议标签返回更符合该协议特性的请求：例如，HTTP 连接可以使用缓存型 HTTP 代理服务器，而所有其他连接则使用功能更强大的 SOCKSv5 代理服务器。

另请参阅 protocolTag()。

void QNetworkProxyQuery::setQueryType(QNetworkProxyQuery::QueryType type)

将此对象的查询类型设置为type 。

另请参阅 queryType()。

void QNetworkProxyQuery::setUrl(const QUrl &url)

将此QNetworkProxyQuery 对象的 URL 组件设置为url 。设置 URL 时，协议标签、远程主机名和端口号也会随之设置。这样做是为了便于实现用于确定应使用哪个代理服务器的代码。

另请参阅 url()、peerHostName() 和peerPort()。

[noexcept] void QNetworkProxyQuery::swap(QNetworkProxyQuery &other)

将此网络代理查询实例替换为other 。此操作速度极快，且绝不会失败。

QUrl QNetworkProxyQuery::url() const

当查询类型为QNetworkProxyQuery::UrlRequest 时，返回此QNetworkProxyQuery 对象的 URL 组件。

另请参阅 setUrl()。

bool QNetworkProxyQuery::operator!=(const QNetworkProxyQuery &other) const

如果该QNetworkProxyQuery 对象所包含的数据与other 中的数据不一致，则返回true 。

QNetworkProxyQuery &QNetworkProxyQuery::operator=(const QNetworkProxyQuery &other)

复制other 中的内容。

bool QNetworkProxyQuery::operator==(const QNetworkProxyQuery &other) const

如果该QNetworkProxyQuery 对象包含与other 相同的数据，则返回true 。