QNetworkRequest Class Reference

[QtNetwork module]

该QNetworkRequest类持有与发送请求QNetworkAccessManager。More…

Types

• enum Attribute { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, ..., UserMax }
• enum CacheLoadControl { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache }
• enum KnownHeaders { ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, ..., ContentDispositionHeader }
• enum LoadControl { Automatic, Manual }
• enum Priority { HighPriority, NormalPriority, LowPriority }

Methods

• __init__ (self, QUrl url = QUrl())
• __init__ (self, QNetworkRequest other)
• QVariant attribute (self, Attribute code, QVariant defaultValue = QVariant())
• bool hasRawHeader (self, QByteArray headerName)
• QVariant header (self, KnownHeaders header)
• QObject originatingObject (self)
• Priority priority (self)
• QByteArray rawHeader (self, QByteArray headerName)
• list-of-QByteArray rawHeaderList (self)
• setAttribute (self, Attribute code, QVariant value)
• setHeader (self, KnownHeaders header, QVariant value)
• setOriginatingObject (self, QObject object)
• setPriority (self, Priority priority)
• setRawHeader (self, QByteArray headerName, QByteArray value)
• setSslConfiguration (self, QSslConfiguration configuration)
• setUrl (self, QUrl url)
• QSslConfiguration sslConfiguration (self)
• QUrl url (self)

Special Methods

• bool __eq__ (self, QNetworkRequest other)
• bool __ne__ (self, QNetworkRequest other)

Detailed Description

该QNetworkRequest类持有与发送请求QNetworkAccessManager。

QNetworkRequest是网络访问API的一部分，是类保持必要的资料，通过网络发送一个请求。它包含一个URL和一些辅助信息可以用来修改请求。

Type Documentation

QNetworkRequest.Attribute

属性代码为QNetworkRequest和QNetworkReply。

属性是用于控制该请求的行为，并从答复通过进一步的信息返回给应用程序的额外元数据。属性也是可扩展的，允许自定义实现通过自定义值。

下表解释了默认属性代码，该QVariant相关类型，默认值，如果所说的属性是失踪，无论是在请求或回复使用。

这个枚举被引入或修改的Qt 4.7 。

QNetworkRequest.CacheLoadControl

控件的缓存机制QNetworkAccessManager。

QNetworkRequest.KnownHeaders

众所周知头类型的列表QNetworkRequest解析。每个已知的头也代表了原始形式，其完整的HTTP名字。

See also header（ ）setHeader（ ）rawHeader（）和setRawHeader（ ） 。

QNetworkRequest.LoadControl

指示如果请求的加载机制的一个方面已手动复盖，如通过QtWebKit。

这个枚举被引入或修改的Qt 4.7 。

QNetworkRequest.Priority

这个枚举列出了可能的网络请求优先级。

这个枚举被引入或修改的Qt 4.7 。

Method Documentation

QNetworkRequest.__init__ (self, QUrl url = QUrl())

构造一个QNetworkRequest与对象url以被请求的URL 。

See also url（）和setUrl（ ） 。

QNetworkRequest.__init__ (self, QNetworkRequest other)

创建副本other。

QVariant QNetworkRequest.attribute (self, Attribute code, QVariant defaultValue = QVariant())

bool QNetworkRequest.hasRawHeader (self, QByteArray headerName)

返回True如果原始标题headerName存在于这个网络请求。

See also rawHeader（）和setRawHeader（ ） 。

QVariant QNetworkRequest.header (self, KnownHeaders header)

返回已知的网络标头的值header如果它存在于这个请求。如果它不存在，则返回的QVariant （） （即，无效的变体） 。

See also KnownHeaders，rawHeader（）和setHeader（ ） 。

QObject QNetworkRequest.originatingObject (self)

[

返回一个引用到启动此网络请求的对象，则返回0 ，如果没有设置或对象已经被销毁。

此功能被引入Qt的4.6 。

](docs_qobject.html)

See also setOriginatingObject（ ） 。

Priority QNetworkRequest.priority (self)

[

返回此请求的优先级。

此功能被引入Qt的4.7 。

](docs_qnetworkrequest.html#Priority-enum)

See also setPriority（ ） 。

QByteArray QNetworkRequest.rawHeader (self, QByteArray headerName)

返回头的原始形式headerName。如果没有这样的标头，空QByteArray被返回，这可能是由一个标题，是目前无法区分，但没有任何内容（用hasRawHeader（ ）来找出如果头存在与否） 。

原标题可以被设置setRawHeader（）或与setHeader（ ） 。

See also header（）和setRawHeader（ ） 。

list-of-QByteArray QNetworkRequest.rawHeaderList (self)

返回在这个网络要求设置的所有原始标题的列表。这份名单是在头被设定的顺序。

See also hasRawHeader（）和rawHeader（ ） 。

QNetworkRequest.setAttribute (self, Attribute code, QVariant value)

设置与代码相关的属性code是值value。如果属性已经设置，以前的值将被丢弃。在特殊的，如果value是无效的QVariant，属性未设置。

See also attribute（）和QNetworkRequest.Attribute。

QNetworkRequest.setHeader (self, KnownHeaders header, QVariant value)

设置了已知头的值header要value，复盖任何先前设置的标头。此操作还设置了相当于原始HTTP标头。

See also KnownHeaders，setRawHeader（）和header（ ） 。

QNetworkRequest.setOriginatingObject (self, QObject object)

允许设置的参考object发起请求。

例如QtWebKit设置原始对象的QWebFrame发起请求。

此功能被引入Qt的4.6 。

See also originatingObject（ ） 。

QNetworkRequest.setPriority (self, Priority priority)

设置此请求的优先级，以priority。

Note:该priority只是一个暗示，网络访问管理器。它可以使用或不使用。目前它被用于HTTP来决定哪个请求应该被首先发送到服务器。

此功能被引入Qt的4.7 。

See also priority（ ） 。

QNetworkRequest.setRawHeader (self, QByteArray headerName, QByteArray value)

设置页眉headerName有利用价值headerValue。如果headerName对应于一个已知的报头（参见QNetworkRequest.KnownHeaders） ， raw格式将被解析和相应的“熟”头将被设置为好。

例如：

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

还将设置称为标头LastModifiedHeader是QDateTime解析日期的对象。

注意：在设置相同的头两次将复盖以前的设置。为了实现多个同名的HTTP头的行为，你应该将两者连接起来的值，用逗号将它们隔开（ “，” ），并设置一个单一的原始标题。

See also KnownHeaders，setHeader（ ）hasRawHeader（）和rawHeader（ ） 。

QNetworkRequest.setSslConfiguration (self, QSslConfiguration configuration)

设置此网络请求的SSL配置是config。该应用设置为私有密钥，本地证书， SSL协议（的SSLv2 ， SSLv3的，使用TLSv1如适用） ，即在SSL后端被允许使用的CA证书和密码。

缺省情况下， SSL配置设置，这使得后端可以自由选择什么样的配置是最适合他们。

See also sslConfiguration（）和QSslConfiguration.defaultConfiguration（ ） 。

QNetworkRequest.setUrl (self, QUrl url)

设置此网络请求所指的是网址url。

See also url（ ） 。

QSslConfiguration QNetworkRequest.sslConfiguration (self)

[

返回此网络请求的SSL配置。缺省情况下， SSL设置中指定。

](docs_qsslconfiguration.html)

See also setSslConfiguration（ ） 。

QUrl QNetworkRequest.url (self)

[

返回此网络请求是指URL中。

](docs_qurl.html)

See also setUrl（ ） 。

bool QNetworkRequest.__eq__ (self, QNetworkRequest other)

bool QNetworkRequest.__ne__ (self, QNetworkRequest other)