Qt：QNetworkRequest

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"));

巴特西