Класс QNetworkDiskCache

Класс QNetworkDiskCache предоставляет очень базовый кэш на диске. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Переопределенные открытые функции

• 7 открытых функций унаследовано от QAbstractNetworkCache
• 31 открытых функций унаследовано от QObject

Открытые слоты

• 1 открытый слот унаследован от QAbstractNetworkCache
• 1 открытый слот унаследован от QObject

Защищенные функции

• 9 защищенных функций унаследовано от QObject

Дополнительные унаследованные члены

• 1 свойство унаследовано от QObject
• 2 сигнала унаследовано от QObject
• 11 статических открытых членов унаследовано от QObject

Подробное описание

Класс QNetworkDiskCache предоставляет очень базовый кэш на диске.

QNetworkDiskCache сохраняет каждый URL в отдельном файле внутри cacheDirectory с помощью QDataStream. Файлы с текстовым MIME-типом сжимаются с помощью qCompress. Данные записываются на диск только в insert() и updateMetaData().

В настоящее время вы не можете совместно использовать одни и те же файлы кэша с более чем одним кэшем на диске.

QNetworkDiskCache по умолчанию ограничивает объем места, используемого кэшем в системе, до 50 МБ.

Обратите внимание, что вам необходимо установить каталог кэша, прежде чем он будет работать.

Кэш на диске можно включить следующим образом:

QNetworkAccessManager *manager = new QNetworkAccessManager(this);
QNetworkDiskCache *diskCache = new QNetworkDiskCache(this);
diskCache->setCacheDirectory("cacheDir");
manager->setCache(diskCache);

При отправке запросов, чтобы контролировать предпочтение, когда использовать кэш, а когда сеть, следует учитывать следующее:

// do a normal request (preferred from network, as this is the default)
QNetworkRequest request(QUrl(QString("http://qt-project.org")));
manager->get(request);

// do a request preferred from cache
QNetworkRequest request2(QUrl(QString("http://qt-project.org")));
request2.setAttribute(QNetworkRequest::CacheLoadControlAttribute, QNetworkRequest::PreferCache);
manager->get(request2);

Чтобы проверить, пришел ли ответ из кэша или из сети, можно применить следующее:

void replyFinished(QNetworkReply *reply) {
    QVariant fromCache = reply->attribute(QNetworkRequest::SourceIsFromCacheAttribute);
    qDebug() << "page from cache?" << fromCache.toBool();
}

Документация по функциям-членам

QNetworkDiskCache::QNetworkDiskCache(QObject *parent = Q_NULLPTR)

Создаёт новый кэш на диске. Аргумент parent передаётся конструктору QAbstractNetworkCache.

QNetworkDiskCache::~QNetworkDiskCache()

Уничтожает объект кэша. Это не очищает кэш на диске.

QString QNetworkDiskCache::cacheDirectory() const

Возвращает расположение, где будут храниться файлы кэша.

См. также setCacheDirectory().

[virtual] qint64 QNetworkDiskCache::cacheSize() const

Переопределено из QAbstractNetworkCache::cacheSize().

[virtual slot] void QNetworkDiskCache::clear()

Переопределено из QAbstractNetworkCache::clear().

[virtual] QIODevice *QNetworkDiskCache::data(const QUrl &url)

Переопределено из QAbstractNetworkCache::data().

[virtual protected] qint64 QNetworkDiskCache::expire()

Очищает кэш, чтобы его размер был меньше максимального размера кэша. Возвращает текущий размер кэша.

Когда текущий размер кэша больше, чем maximumCacheSize(), удаляются более старые файлы кэша, пока общий размер не станет меньше 90% от maximumCacheSize(), начиная со старейших файлов в первую очередь, используя дату создания файла, чтобы определить, насколько стар файл кэша.

Подклассы могут переопределить эту функцию, чтобы изменить порядок удаления файлов кэша, учитывая информацию, о которой QNetworkDiskCache не знает, например, количество обращений к кэшу.

Примечание: cacheSize() вызывает expire, если текущий размер кэша неизвестен.

См. также maximumCacheSize() и fileMetaData().

QNetworkCacheMetaData QNetworkDiskCache::fileMetaData(const QString &fileName) const

Возвращает QNetworkCacheMetaData для файла кэша fileName.

Если fileName не является файлом кэша, QNetworkCacheMetaData будет недопустима.

[virtual] void QNetworkDiskCache::insert(QIODevice *device)

Переопределено из QAbstractNetworkCache::insert().

qint64 QNetworkDiskCache::maximumCacheSize() const

Возвращает текущий максимальный размер кэша на диске.

См. также setMaximumCacheSize().

[virtual] QNetworkCacheMetaData QNetworkDiskCache::metaData(const QUrl &url)

Переопределено из QAbstractNetworkCache::metaData().

[virtual] QIODevice *QNetworkDiskCache::prepare(const QNetworkCacheMetaData &metaData)

Переопределено из QAbstractNetworkCache::prepare().

[virtual] bool QNetworkDiskCache::remove(const QUrl &url)

Переопределено из QAbstractNetworkCache::remove().

void QNetworkDiskCache::setCacheDirectory(const QString &cacheDir)

Устанавливает директорию для хранения кэшированных файлов в cacheDir

QNetworkDiskCache создаст эту директорию, если она не существует.

Подготовленные элементы кэша будут храниться в новой директории кэша при их вставке.

См. также cacheDirectory() и QDesktopServices::CacheLocation.

void QNetworkDiskCache::setMaximumCacheSize(qint64 size)

Устанавливает максимальный размер диска кэша в size.

Если новый размер меньше текущего размера кэша, то кэш вызовет expire().

См. также maximumCacheSize().

[virtual] void QNetworkDiskCache::updateMetaData(const QNetworkCacheMetaData &metaData)

Переопределено из QAbstractNetworkCache::updateMetaData().