The QNetworkCacheMetaData class provides cache information. More...

#include <qabstractnetworkcache.h>

Collaboration diagram for QNetworkCacheMetaData:

Public Types
typedef QPair< QByteArray, QByteArray >	RawHeader
	Synonym for QPair<QByteArray, QByteArray>

typedef QList< RawHeader >	RawHeaderList
	Synonym for QList<RawHeader>

typedef QHash< QNetworkRequest::Attribute, QVariant >	AttributesMap
	Synonym for QHash<QNetworkRequest::Attribute, QVariant>

Public Member Functions
	QNetworkCacheMetaData ()
	Constructs an invalid network cache meta data.

	QNetworkCacheMetaData (const QNetworkCacheMetaData &other)
	Constructs a copy of the other QNetworkCacheMetaData.

	~QNetworkCacheMetaData ()
	Destroys the network cache meta data.

QNetworkCacheMetaData &	operator= (QNetworkCacheMetaData &&other) noexcept

QNetworkCacheMetaData &	operator= (const QNetworkCacheMetaData &other)
	Makes a copy of the other QNetworkCacheMetaData and returns a reference to the copy.

void	swap (QNetworkCacheMetaData &other) noexcept

bool	operator== (const QNetworkCacheMetaData &other) const
	Returns `true` if this meta data is equal to the other meta data; otherwise returns `false`.

bool	operator!= (const QNetworkCacheMetaData &other) const
	Returns `true` if this meta data is not equal to the other meta data; otherwise returns `false`.

bool	isValid () const
	Returns `true` if this network cache meta data has attributes that have been set otherwise false.

QUrl	url () const
	Returns the URL this network cache meta data is referring to.

void	setUrl (const QUrl &url)
	Sets the URL this network cache meta data to be url.

RawHeaderList	rawHeaders () const
	Returns a list of all raw headers that are set in this meta data.

void	setRawHeaders (const RawHeaderList &headers)
	Sets the raw headers to list.

QDateTime	lastModified () const
	Returns the date and time when the meta data was last modified.

void	setLastModified (const QDateTime &dateTime)
	Sets the date and time when the meta data was last modified to dateTime.

QDateTime	expirationDate () const
	Returns the date and time when the meta data expires.

void	setExpirationDate (const QDateTime &dateTime)
	Sets the date and time when the meta data expires to dateTime.

bool	saveToDisk () const
	Returns is this cache should be allowed to be stored on disk.

void	setSaveToDisk (bool allow)
	Sets whether this network cache meta data and associated content should be allowed to be stored on disk to allow.

AttributesMap	attributes () const

void	setAttributes (const AttributesMap &attributes)

Friends
class	QNetworkCacheMetaDataPrivate

Related Symbols
(Note that these are not member symbols.)
QDataStream &	operator<< (QDataStream &out, const QNetworkCacheMetaData &metaData)

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

Detailed Description

The QNetworkCacheMetaData class provides cache information.

Since: 4.5

\inmodule QtNetwork

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

Definition at line 21 of file qabstractnetworkcache.h.

Member Typedef Documentation

◆ AttributesMap

QNetworkCacheMetaData::AttributesMap

Synonym for QHash<QNetworkRequest::Attribute, QVariant>

Definition at line 27 of file qabstractnetworkcache.h.

◆ RawHeader

QNetworkCacheMetaData::RawHeader

Synonym for QPair<QByteArray, QByteArray>

Definition at line 25 of file qabstractnetworkcache.h.

◆ RawHeaderList

QNetworkCacheMetaData::RawHeaderList

Synonym for QList<RawHeader>

Definition at line 26 of file qabstractnetworkcache.h.

Constructor & Destructor Documentation

◆ QNetworkCacheMetaData() [1/2]

QNetworkCacheMetaData::QNetworkCacheMetaData ( )

Constructs an invalid network cache meta data.

See also: isValid()

Definition at line 85 of file qabstractnetworkcache.cpp.

◆ QNetworkCacheMetaData() [2/2]

QNetworkCacheMetaData::QNetworkCacheMetaData ( const QNetworkCacheMetaData & other )

Constructs a copy of the other QNetworkCacheMetaData.

Definition at line 101 of file qabstractnetworkcache.cpp.

◆ ~QNetworkCacheMetaData()

QNetworkCacheMetaData::~QNetworkCacheMetaData ( )

Destroys the network cache meta data.

Definition at line 93 of file qabstractnetworkcache.cpp.

Member Function Documentation

◆ attributes()

QNetworkCacheMetaData::AttributesMap QNetworkCacheMetaData::attributes ( ) const

Since: 4.6

Returns all the attributes stored with this cache item.

See also: setAttributes(), QNetworkRequest::Attribute

Definition at line 266 of file qabstractnetworkcache.cpp.

References QNetworkCacheMetaDataPrivate::attributes.

Referenced by QNetworkReplyHttpImplPrivate::fetchCacheMetaData(), QNetworkReplyHttpImplPrivate::initCacheSaveDevice(), QNetworkReplyImplPrivate::initCacheSaveDevice(), QNetworkCacheMetaDataPrivate::save(), QNetworkReplyHttpImplPrivate::sendCacheContents(), and setAttributes().

Here is the caller graph for this function:

◆ expirationDate()

QDateTime QNetworkCacheMetaData::expirationDate ( ) const

Returns the date and time when the meta data expires.

Definition at line 246 of file qabstractnetworkcache.cpp.

References QNetworkCacheMetaDataPrivate::expirationDate.

Referenced by QNetworkReplyHttpImplPrivate::loadFromCacheIfAllowed(), and QNetworkCacheMetaDataPrivate::save().

Here is the caller graph for this function:

◆ isValid()

bool QNetworkCacheMetaData::isValid ( ) const

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

Definition at line 148 of file qabstractnetworkcache.cpp.

Referenced by QNetworkReplyHttpImplPrivate::loadFromCacheIfAllowed(), QNetworkDiskCache::prepare(), QCacheItem::read(), and QNetworkReplyHttpImplPrivate::sendCacheContents().

Here is the caller graph for this function:

◆ lastModified()

QDateTime QNetworkCacheMetaData::lastModified ( ) const

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

Definition at line 230 of file qabstractnetworkcache.cpp.

References QNetworkCacheMetaDataPrivate::lastModified.

Referenced by QNetworkReplyHttpImplPrivate::loadFromCacheIfAllowed(), and QNetworkCacheMetaDataPrivate::save().

Here is the caller graph for this function:

◆ operator!=()

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

inline

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

See also: operator==()

Definition at line 40 of file qabstractnetworkcache.h.

References other().

Here is the call graph for this function:

◆ operator=() [1/2]

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

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

Definition at line 109 of file qabstractnetworkcache.cpp.

References other().

Here is the call graph for this function:

◆ operator=() [2/2]

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

inlinenoexcept

Definition at line 33 of file qabstractnetworkcache.h.

References other(), and swap().

Here is the call graph for this function:

◆ 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!=()

Definition at line 128 of file qabstractnetworkcache.cpp.

References other().

Here is the call graph for this function:

◆ rawHeaders()

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()

Definition at line 212 of file qabstractnetworkcache.cpp.

References QNetworkCacheMetaDataPrivate::headers.

Referenced by QCacheItem::canCompress(), QNetworkReplyHttpImplPrivate::fetchCacheMetaData(), QNetworkReplyHttpImplPrivate::loadFromCacheIfAllowed(), QNetworkDiskCache::prepare(), QCacheItem::read(), QNetworkReplyHttpImplPrivate::replyDownloadMetaData(), QNetworkCacheMetaDataPrivate::save(), and QNetworkReplyHttpImplPrivate::sendCacheContents().

Here is the caller graph for this function:

◆ saveToDisk()

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.