Roson的Qt之旅 #120 QNetworkCacheMetaData详细介绍

CSDN话题挑战赛第2期
参赛话题：Qt应用程序开发

1.概述

QNetworkCacheMetaData类提供缓存信息。
QNetworkCacheMetaData提供了关于缓存文件的信息，包括网址，最后一次修改的时间，缓存文件的创建时间，文件的标题，以及文件是否应该被保存在磁盘上。
参见QAbstractNetworkCache。

2.成员类型说明

typedef QNetworkCacheMetaData::AttributesMap
QHash的同义词。

typedef QNetworkCacheMetaData::RawHeader
QPair的同义词。

typedef QNetworkCacheMetaData::RawHeaderList
QList的同义词

3.成员函数文档

QNetworkCacheMetaData::QNetworkCacheMetaData()
构建一个无效的网络缓存元数据。
参见isValid()。

QNetworkCacheMetaData::QNetworkCacheMetaData(const QNetworkCacheMetaData &other)
构建一个其他QNetworkCacheMetaData的副本。

QNetworkCacheMetaData::~QNetworkCacheMetaData()
销毁网络缓存的元数据。

AttributesMap QNetworkCacheMetaData::attributes() const
返回所有存储在这个缓存项的属性。
这个函数在Qt 4.6中引入。
参见setAttributes()和QNetworkRequest::Attribute。

QDateTime QNetworkCacheMetaData::expirationDate() const
返回元数据过期的日期和时间。
参见setExpirationDate()。

bool QNetworkCacheMetaData::isValid() const
如果这个网络缓存元数据的属性已经被设置，则返回true，否则返回false。

QDateTime QNetworkCacheMetaData::lastModified() const
返回元数据最后被修改的日期和时间。
参见setLastModified()。

RawHeaderList QNetworkCacheMetaData::rawHeaders() const
返回在此元数据中设置的所有原始头文件的列表。该列表的顺序与头文件的设置顺序相同。
参见setRawHeaders()。

bool QNetworkCacheMetaData::saveToDisk() const
返回这个缓存是否应该被允许存储在磁盘上。
一些缓存实现可以将这些缓存项目保留在内存中，以保证性能，但出于安全考虑，它们不应该被写到磁盘上。
具体到http，标有Pragma: no-cache的文档，或者有Cache-control设置为no-store或no-cache的文档，或者任何没有设置 "Cache-control: public "的https文档都会把saveToDisk设置为false。
参见setSaveToDisk()。

void QNetworkCacheMetaData::setAttributes(const AttributesMap &attributes)
将此缓存项的所有属性设置为地图属性。
这个函数在Qt 4.6中引入。
参见attributes()和QNetworkRequest::setAttribute()。

void QNetworkCacheMetaData::setExpirationDate(const QDateTime &dateTime)
设置元数据过期的日期和时间为dateTime。
参见expirationDate()。

void QNetworkCacheMetaData::setLastModified(const QDateTime &dateTime)
设置元数据最后被修改的日期和时间为dateTime。
参见lastModified()。

void QNetworkCacheMetaData::setRawHeaders(const RawHeaderList &list)
设置原始头文件到列表中。
参见rawHeaders()。

void QNetworkCacheMetaData::setSaveToDisk(bool allow)
设置该网络缓存元数据和相关内容是否允许存储在磁盘上为允许。
也请看saveToDisk()。

void QNetworkCacheMetaData::setUrl(const QUrl &url)
设置该网络缓存元数据的URL为url。
密码和片段会从url中移除。
也请看url()。

void QNetworkCacheMetaData::swap(QNetworkCacheMetaData &other)
将这个元数据实例与另一个元数据交换。这个函数非常快，而且不会失败。
这个函数在Qt 5.0中被引入。

QUrl QNetworkCacheMetaData::url() const
返回这个网络缓存元数据所指的URL。
参见setUrl()。

bool QNetworkCacheMetaData::operator!=(const QNetworkCacheMetaData &other) const
如果这个元数据不等于另一个元数据，返回true；否则返回false。
参见operator==()。

QNetworkCacheMetaData &QNetworkCacheMetaData::operator=(QNetworkCacheMetaData &&other)
移动赋值运算符。

QNetworkCacheMetaData &QNetworkCacheMetaData::operator=( const QNetworkCacheMetaData &other)
制作另一个QNetworkCacheMetaData的副本，并返回该副本的引用。

bool QNetworkCacheMetaData::operator==(Const QNetworkCacheMetaData &other) const
如果这个元数据与另一个元数据相等，则返回真，否则返回假。
参见operator!=()。
相关的非成员

QDataStream &operator<<(QDataStream &out, const QNetworkCacheMetaData &metaData)
将metaData写到out流中。
这个函数在Qt 4.5中引入。
请参见序列化Qt数据类型。

QDataStream &operator>>(QDataStream &in, QNetworkCacheMetaData &metaData)
将一个QNetworkCacheMetaData从流中读入metaData。
这个函数在Qt 4.5中引入。
请参见序列化Qt数据类型。