QNetworkCacheMetaData Class

The QNetworkCacheMetaData class provides cache information. More...

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

Public Types

Public Functions

QNetworkCacheMetaData(const QNetworkCacheMetaData &other)
QNetworkCacheMetaData()
QNetworkCacheMetaData &operator=(const QNetworkCacheMetaData &other)
~QNetworkCacheMetaData()
QNetworkCacheMetaData::AttributesMap attributes() const
QDateTime expirationDate() 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)
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
bool operator==(const QNetworkCacheMetaData &other) const
QDataStream &operator<<(QDataStream &out, const QNetworkCacheMetaData &metaData)
QDataStream &operator>>(QDataStream &in, QNetworkCacheMetaData &metaData)

Detailed Description

QNetworkCacheMetaData provides information about a cache file including the url, when it was last modified, when the cache file was created, headers for file and if the file should be saved onto a disk.

See also QAbstractNetworkCache.

Member Type Documentation

QNetworkCacheMetaData::AttributesMap

Synonym for QHash<QNetworkRequest::Attribute, QVariant>

QNetworkCacheMetaData::RawHeader

Synonym for QPair<QByteArray, QByteArray>

QNetworkCacheMetaData::RawHeaderList

Synonym for QList<RawHeader>

Member Function Documentation

QNetworkCacheMetaData::QNetworkCacheMetaData(const QNetworkCacheMetaData &other)

Constructs a copy of the other QNetworkCacheMetaData.

QNetworkCacheMetaData::QNetworkCacheMetaData()

Constructs an invalid network cache meta data.

See also isValid().

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

Makes a copy of the other QNetworkCacheMetaData and returns a reference to the copy.

QNetworkCacheMetaData::~QNetworkCacheMetaData()

Destroys the network cache meta data.

QNetworkCacheMetaData::AttributesMap QNetworkCacheMetaData::attributes() const

Returns all the attributes stored with this cache item.

See also setAttributes() and QNetworkRequest::Attribute.

QDateTime QNetworkCacheMetaData::expirationDate() const

Returns the date and time when the meta data expires.

See also setExpirationDate().

bool QNetworkCacheMetaData::isValid() const

Returns true if this network cache meta data has attributes that have been set otherwise false.

QDateTime QNetworkCacheMetaData::lastModified() const

Returns the date and time when the meta data was last modified.

See also setLastModified().

QNetworkCacheMetaData::RawHeaderList QNetworkCacheMetaData::rawHeaders() const

Returns a list of all raw headers that are set in this meta data. The list is in the same order that the headers were set.

See also setRawHeaders().

bool QNetworkCacheMetaData::saveToDisk() const

Returns is this cache should be allowed to be stored on disk.

Some cache implementations can keep these cache items in memory for performance reasons, but for security reasons they should not be written to disk.

Specifically with http, documents with Cache-control set to no-store or any https document that doesn't have "Cache-control: public" set will set the saveToDisk to false.

See also setSaveToDisk().

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

Sets all attributes of this cache item to be the map attributes.

See also attributes() and QNetworkRequest::setAttribute().

void QNetworkCacheMetaData::setExpirationDate(const QDateTime &dateTime)

Sets the date and time when the meta data expires to dateTime.

See also expirationDate().

void QNetworkCacheMetaData::setLastModified(const QDateTime &dateTime)

Sets the date and time when the meta data was last modified to dateTime.

See also lastModified().

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

Sets the raw headers to list.

See also rawHeaders().

void QNetworkCacheMetaData::setSaveToDisk(bool allow)

Sets whether this network cache meta data and associated content should be allowed to be stored on disk to allow.

See also saveToDisk().

void QNetworkCacheMetaData::setUrl(const QUrl &url)

Sets the URL this network cache meta data to be url.

The password and fragment are removed from the url.

See also url().

[since 5.0] void QNetworkCacheMetaData::swap(QNetworkCacheMetaData &other)

Swaps this metadata instance with other. This function is very fast and never fails.

This function was introduced in Qt 5.0.

QUrl QNetworkCacheMetaData::url() const

Returns the URL this network cache meta data is referring to.

See also setUrl().

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

Returns true if this meta data is not equal to the other meta data; otherwise returns false.

See also operator==().

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

Returns true if this meta data is equal to the other meta data; otherwise returns false.

See also operator!=().

Related Non-Members

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

Writes metaData to the out stream.

See also Serializing Qt Data Types.

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

Reads a QNetworkCacheMetaData from the stream in into metaData.

See also Serializing Qt Data Types.