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 。