0、说明
QNetworkRequest类代表被QNetworkAccessManager发送的请求。
QNetworkReuqest是网络访问API的一部分，在其内部保留了在网络上发送一个request的必要信息。它包含了一个URL和一些辅助信息，这些信息可以用于确定和修改一个request。
1、模块和加载项
| Header: | #include <QNetworkRequest> |
| qmake: | QT += network |
| Since: | Qt 4.4 |
2、构造
| QNetworkRequest(QNetworkRequest other) | 得到另一个Request的副本。 |
| QNetworkRequest(QUrl url) | 用要请求的URL构造一个Request。 |
| QNetworkRequest() | 构造一个空URL，其内容用各种setxxx()方法设置。 |
经过测试，QNetworkRequest(QUrl url)容易出现异常，还是先构造一个空的Request，再用setUrl()设置URL为好。
3、静态字段
类型 |
字段 |
说明 |
| enum | Attribute | QNetworkRequest与QNetworkReply的属性码。 用于控制request的行为，从reply中传送更多发往应用的信息。 |
| CacheLoadControl | Cache载入控制 | |
| KnownHeaders | Header | |
| LoadControl | 载入控制 | |
| Priority | 优先级 | |
| RedirectPolicy | 重定向策略 | |
| TransferTimeoutConstant | 传输超时时间 |
4、实例方法
返回值类型 |
方法 |
说明 |
| QNetworkRequest & bool bool |
operator=(QNetworkRequest other) operator!=(QNetworkRequest other) operator==(QNetworkRequest other) |
赋值 判断是否相等
|
| QVariant | attribute(QNetworkRequest::Attribute code, QVariant defaultValue = QVariant()) | 返回与code关联的attribute，如果该attribute未设置，则返回默认attribute。 |
| bool | hasRawHeader(QByteArray headerName) | 如果原始首部headerName在Request中存在，则返回true |
| QVariant | header(QNetworkRequest::KnownHeaders header) | 返回首部对应的QVariant，如果不存在则返回QVariant() |
| QHttp2Configuration | http2Configuration() | 返回当前QNetworkAccessManger用于该Request和HTTP/2连接的参数。 |
| int | maximumRedirectsAllowed() | 最大重定向次数 |
| QObject * | originatingObject() | 返回启动了该Request的对象，不存在时返回nullptr |
| QString | peerVerifyName() | 返回证书验证的host name |
| QNetworkRequest::Priority | priority() | 返回请求优先级 |
| QByteArray | rawHeader(QByteArray headerName) | 返回该Request的原始首部对应的QByteArray。不存在时，hasRowHeader()返回false，并且该函数返回空QByteArray |
| QList<QByteArray> | rawHeaderList() | 返回该Request的所有原始首部的List。 |
| void | setAttribute(QNetworkRequest::Attribute code, QVariant value) | 设置参数 |
| setHeader(QNetworkRequest::KnownHeaders header, QVariant value) | 设置Header | |
| setHttp2Configuration(QHttp2Configuration configuration) | 设置HTTP/2参数 | |
| setMaximumRedirectsAllowed(int maxRedirectsAllowed) | 设置最大重定向次数 | |
| setOriginatingObject(QObject *object) | 设置启动该Request的对象 | |
| setPeerVerifyName(QString peerName) | 设置证书验证的host name | |
| setPriority(QNetworkRequest::Priority priority) | 设置请求优先级 | |
| setRawHeader(QByteArray headerName, QByteArray headerValue) | 设置header及其对应的value，例子 request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT")); |
|
| setSslConfiguration(QSslConfiguration config) | 设置SSL配置 | |
| setTransferTimeout(int timeout = DefaultTransferTimeoutConstant) | 设置传输超时时间 | |
| setUrl(QUrl url) | 设置该Reuqest的URL | |
| QSslConfiguration | sslConfiguration() | 获取该Request的SSL配置 |
| void | swap(QNetworkRequest &other) | 交换两个Request的值 |
| int | transferTimeout() | 获取传输超时时间 |
| QUrl | url() | 获取Request的URL |
5、常用
1）构造一个空Request，为它指定URL：
QNetworkRequest request; request.setUrl(QUrl("Url_String"));