QNetworkProxy Class

成员函数文档

QNetworkProxy::QNetworkProxy()

构造一个DefaultProxy 类型的 QNetworkProxy。

代理类型由applicationProxy() 决定，默认为NoProxy 或系统范围代理（如果已配置）。

另请参阅 setType() 和setApplicationProxy()。

QNetworkProxy::QNetworkProxy(QNetworkProxy::ProxyType type, const QString &hostName = QString(), quint16 port = 0, const QString &user = QString(), const QString &password = QString())

用type,hostName,port,user 和password 构建一个 QNetworkProxy。

代理类型type 的默认功能已自动设置。

另请参阅 capabilities().

QNetworkProxy::QNetworkProxy(const QNetworkProxy &other)

构造other 的副本。

[noexcept] QNetworkProxy::~QNetworkProxy()

销毁QNetworkProxy 对象。

[static] QNetworkProxy QNetworkProxy::applicationProxy()

返回应用级网络代理。

如果QAbstractSocket 或QTcpSocket 类型为QNetworkProxy::DefaultProxy ，则使用本函数返回的QNetworkProxy 。

另请参阅 QNetworkProxyFactory,setApplicationProxy(),QAbstractSocket::proxy() 和QTcpServer::proxy()。

QNetworkProxy::Capabilities QNetworkProxy::capabilities() const

返回代理服务器的功能。

另请参阅 setCapabilities() 和type()。

bool QNetworkProxy::hasRawHeader(const QByteArray &headerName) const

如果该代理使用原始标头headerName ，则返回true 。如果代理不是HttpProxy 或HttpCachingProxy 类型，则返回false 。

另请参阅 rawHeader() 和setRawHeader()。

QVariant QNetworkProxy::header(QNetworkRequest::KnownHeaders header) const

如果该代理使用已知网络报头header ，则返回该网络报头的值。如果不存在，则返回 QVariant()（即无效变量）。

另请参阅 QNetworkRequest::KnownHeaders 、rawHeader() 和setHeader()。

[since 6.8] QHttpHeaders QNetworkProxy::headers() const

返回在此网络请求中设置的标头。

如果代理不是HttpProxy 或HttpCachingProxy 类型，则返回默认构造的QHttpHeaders 。

此函数在 Qt 6.8 中引入。

另请参阅 setHeaders().

QString QNetworkProxy::hostName() const

返回代理主机的主机名。

另请参阅 setHostName()、setPort() 和port()。

bool QNetworkProxy::isCachingProxy() const

如果该代理支持QNetworkProxy::CachingCapability 功能，则返回true 。

在 Qt 4.4 中，该功能与代理类型绑定，但自 Qt 4.5 起，可以通过调用setCapabilities() 从代理中移除缓存功能。

另请参阅 capabilities()、type() 和isTransparentProxy()。

bool QNetworkProxy::isTransparentProxy() const

如果该代理支持 TCP 连接的透明隧道，则返回true 。这与QNetworkProxy::TunnelingCapability 功能相匹配。

在 Qt 4.4 中，该能力与代理类型绑定，但自 Qt 4.5 起，可以通过调用setCapabilities() 从代理中移除缓存能力。

另请参阅 capabilities()、type() 和isCachingProxy()。

QString QNetworkProxy::password() const

返回用于身份验证的密码。

另请参阅 user()、setPassword() 和setUser()。

quint16 QNetworkProxy::port() const

返回代理主机的端口。

另请参阅 setHostName()、setPort() 和hostName()。

QByteArray QNetworkProxy::rawHeader(const QByteArray &headerName) const

返回headerName 头信息的原始形式。如果没有此类头信息，或者代理类型不是HttpProxy 或HttpCachingProxy ，则返回空的QByteArray ，这可能与存在但没有内容的头信息没有区别（使用hasRawHeader() 查找头信息是否存在）。

原始标头可以用setRawHeader() 或setHeader() 设置。

另请参阅 header() 和setRawHeader()。

QList<QByteArray> QNetworkProxy::rawHeaderList() const

返回在此网络代理中设置的所有原始标头的列表。该列表以设置标头的顺序排列。

如果代理类型不是HttpProxy 或HttpCachingProxy ，则会返回空的QList 。

另请参阅 hasRawHeader() 和rawHeader()。

[static] void QNetworkProxy::setApplicationProxy(const QNetworkProxy &networkProxy)

将应用级网络代理设置为networkProxy 。

如果QAbstractSocket 或QTcpSocket 具有QNetworkProxy::DefaultProxy 类型，则使用此函数设置的QNetworkProxy 。如果想更灵活地确定使用哪个代理，请使用QNetworkProxyFactory 类。

使用此函数设置默认代理值将覆盖使用QNetworkProxyFactory::setApplicationProxyFactory 设置的应用程序代理工厂，并禁止使用系统代理。

另请参阅 QNetworkProxyFactory 、applicationProxy()、QAbstractSocket::setProxy() 和QTcpServer::setProxy()。

void QNetworkProxy::setCapabilities(QNetworkProxy::Capabilities capabilities)

将此代理的功能设置为capabilities 。

另请参阅 setType() 和capabilities()。

void QNetworkProxy::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)

将已知头header 的值设置为value ，覆盖之前设置的任何头。此操作也会设置相应的原始 HTTP 头信息。

如果代理不是HttpProxy 或HttpCachingProxy 类型，则此操作无效。

另请参阅 QNetworkRequest::KnownHeaders 、setRawHeader() 和header()。

[since 6.8] void QNetworkProxy::setHeaders(QHttpHeaders &&newHeaders)

在此网络请求中设置newHeaders 作为标头，覆盖之前设置的任何标头。

如果某些标头与已知标头相对应，则将对其值进行解析，并设置相应的解析形式。

如果代理类型不是HttpProxy 或HttpCachingProxy ，则不会产生任何影响。

此函数在 Qt 6.8 中引入。

另请参阅 headers() 和QNetworkRequest::KnownHeaders 。

[since 6.8] void QNetworkProxy::setHeaders(const QHttpHeaders &newHeaders)

这是一个重载函数。

该函数在 Qt 6.8 中引入。

void QNetworkProxy::setHostName(const QString &hostName)

将代理主机的主机名设置为hostName 。

另请参阅 hostName()、setPort() 和port()。

void QNetworkProxy::setPassword(const QString &password)

将代理身份验证的密码设置为password 。

另请参阅 user()、setUser() 和password()。

void QNetworkProxy::setPort(quint16 port)

设置代理主机的端口为port 。

另请参阅 hostName()、setHostName() 和port()。

void QNetworkProxy::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

将headerName 的标头设置为headerValue 的值。如果headerName 与已知标头对应（见QNetworkRequest::KnownHeaders ），则将解析原始格式并设置相应的 "熟 "标头。

例如

request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));

也会将已知标头 LastModifiedHeader 设置为解析日期的QDateTime 对象。

如果代理不是HttpProxy 或HttpCachingProxy 类型，则没有任何作用。

另请参阅 QNetworkRequest::KnownHeaders,setHeader(),hasRawHeader() 和rawHeader()。

void QNetworkProxy::setType(QNetworkProxy::ProxyType type)

将此实例的代理类型设为type 。

请注意，如果使用setCapabilities() 设置了任何功能，则更改代理类型不会改变QNetworkProxy 对象所持有的功能集。

另请参阅 type() 和setCapabilities()。

void QNetworkProxy::setUser(const QString &user)

将代理身份验证的用户名设置为user 。

另请参阅 user()、setPassword() 和password()。

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

将此网络代理实例与other 互换。该操作速度非常快，从未出现过故障。

QNetworkProxy::ProxyType QNetworkProxy::type() const

返回此实例的代理类型。

另请参阅 setType()。

QString QNetworkProxy::user() const

返回用于身份验证的用户名。

另请参阅 setUser()、setPassword() 和password()。

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

将此网络代理的值与other 进行比较，如果两者不同，则返回true 。

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

将网络代理other 的值指定给该网络代理。

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

将此网络代理的值与other 进行比较，如果两者相等（代理类型、服务器以及用户名和密码相同），则返回true 。