本页内容

QNetworkCacheMetaData Class

QNetworkCacheMetaData 类提供缓存信息。更多内容...

头文件: #include <QNetworkCacheMetaData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network

公共类型

公共函数

QNetworkCacheMetaData()
QNetworkCacheMetaData(const QNetworkCacheMetaData &other)
~QNetworkCacheMetaData()
QNetworkCacheMetaData::AttributesMap attributes() const
QDateTime expirationDate() const
(since 6.8) QHttpHeaders headers() const
bool isValid() const
QDateTime lastModified() const
QNetworkCacheMetaData::RawHeaderList rawHeaders() const
bool saveToDisk() const
void setAttributes(const QNetworkCacheMetaData::AttributesMap &attributes)
void setExpirationDate(const QDateTime &dateTime)
(since 6.8) void setHeaders(const QHttpHeaders &headers)
void setLastModified(const QDateTime &dateTime)
void setRawHeaders(const QNetworkCacheMetaData::RawHeaderList &list)
void setSaveToDisk(bool allow)
void setUrl(const QUrl &url)
void swap(QNetworkCacheMetaData &other)
QUrl url() const
bool operator!=(const QNetworkCacheMetaData &other) const
QNetworkCacheMetaData &operator=(const QNetworkCacheMetaData &other)
bool operator==(const QNetworkCacheMetaData &other) const
QDataStream &operator<<(QDataStream &out, const QNetworkCacheMetaData &metaData)
QDataStream &operator>>(QDataStream &in, QNetworkCacheMetaData &metaData)

详细说明

QNetworkCacheMetaData 提供有关缓存文件的信息,包括 URL、最后修改时间、缓存文件的创建时间、文件头以及该文件是否应保存到磁盘上。

另请参阅 QAbstractNetworkCache 。

成员类型文档

QNetworkCacheMetaData::AttributesMap

QHash 的同义词 <QNetworkRequest::Attribute,QVariant>

QNetworkCacheMetaData::RawHeader

std::pair<QByteArray,QByteArray> 的同义词

QNetworkCacheMetaData::RawHeaderList

QList 的同义词 <RawHeader>

成员函数文档

QNetworkCacheMetaData::QNetworkCacheMetaData()

构建了无效的网络缓存元数据。

另请参阅 isValid()。

QNetworkCacheMetaData::QNetworkCacheMetaData(const QNetworkCacheMetaData &other)

创建other QNetworkCacheMetaData的副本。

[noexcept] QNetworkCacheMetaData::~QNetworkCacheMetaData()

清除网络缓存元数据。

QNetworkCacheMetaData::AttributesMap QNetworkCacheMetaData::attributes() const

返回与该缓存项关联的所有属性。

另请参阅 setAttributes() 和QNetworkRequest::Attribute 。

QDateTime QNetworkCacheMetaData::expirationDate() const

返回元数据过期的日期和时间。

另请参阅 setExpirationDate()。

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

返回以QHttpHeaders 格式表示的、在此元数据中设置的请求头。

该函数在 Qt 6.8 中引入。

另请参阅 setHeaders()。

bool QNetworkCacheMetaData::isValid() const

如果该网络缓存元数据中包含已设置的属性,则返回true ;否则返回false。

QDateTime QNetworkCacheMetaData::lastModified() const

返回元数据最后一次修改的日期和时间。

另请参阅 ` setLastModified()`。

QNetworkCacheMetaData::RawHeaderList QNetworkCacheMetaData::rawHeaders() const

返回一个列表,其中包含在此元数据中设置的所有原始标头。该列表的顺序与标头设置时的顺序一致。

另请参阅 setRawHeaders() 和headers()。

bool QNetworkCacheMetaData::saveToDisk() const

返回该缓存是否应允许存储在磁盘上。

出于性能考虑,某些缓存实现可能会将这些缓存项保存在内存中,但出于安全考虑,不应将其写入磁盘。

特别是对于 http,如果文档的 Cache-control 设置为 no-store,或者任何未设置“Cache-control: public”的 https 文档,都会将 saveToDisk 设置为 false。

另请参阅 setSaveToDisk()。

void QNetworkCacheMetaData::setAttributes(const QNetworkCacheMetaData::AttributesMap &attributes)

将该缓存项的所有属性均设置为映射attributes 。

另请参阅 attributes() 和QNetworkRequest::setAttribute()。

void QNetworkCacheMetaData::setExpirationDate(const QDateTime &dateTime)

将元数据过期日期和时间设置为dateTime 。

另请参阅 expirationDate()。

[since 6.8] void QNetworkCacheMetaData::setHeaders(const QHttpHeaders &headers)

将此网络缓存元数据的标头设置为headers 。

该函数在 Qt 6.8 中引入。

另请参阅 headers()。

void QNetworkCacheMetaData::setLastModified(const QDateTime &dateTime)

将元数据的最后修改日期和时间设置为dateTime 。

另请参阅 lastModified()。

void QNetworkCacheMetaData::setRawHeaders(const QNetworkCacheMetaData::RawHeaderList &list)

将原始标头设置为list 。

另请参阅 rawHeaders() 和setHeaders()。

void QNetworkCacheMetaData::setSaveToDisk(bool allow)

设置是否允许将此网络缓存元数据及相关内容存储在磁盘上,路径为allow 。

另请参阅 saveToDisk()。

void QNetworkCacheMetaData::setUrl(const QUrl &url)

将此网络缓存元数据的 URL 设置为url 。

URL 中的密码和片段将被移除。

另请参阅 url()。

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

将该元数据实例与other 互换。此操作速度极快,且绝不会失败。

QUrl QNetworkCacheMetaData::url() const

返回该网络缓存元数据所引用的 URL。

另请参阅 setUrl()。

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

如果该元数据与other 中的元数据不一致,则返回true ;否则返回false 。

另请参阅 operator==()。

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

创建other QNetworkCacheMetaData 的副本,并返回该副本的引用。

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

如果该元数据与other 中的元数据相等,则返回true ;否则返回false 。

另请参阅 operator!=()。

相关非成员

QDataStream &operator<<(QDataStream &out, const QNetworkCacheMetaData &metaData)

将metaData 写入out 流。

另请参阅 《Qt 数据类型的序列化》。

QDataStream &operator>>(QDataStream &in, QNetworkCacheMetaData &metaData)

从流in 中读取一个 `QNetworkCacheMetaData `,并将其写入 `metaData`。

另请参阅 《Qt 数据类型的序列化》。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.