QAbstractNetworkCache

La classe QAbstractNetworkCache fournit une interface pour les implémentations de caches. Plus d'informations...

 #include <QAbstractNetworkCache>

Héritage

Hérite de QObject.

Héritage

Hérité par QNetworkDiskCache.

Cette classe a été introduite dans Qt 4.5.

Description détaillée

La classe QAbstractNetworkCache fournit une interface pour les implémentations de caches.

QAbstractNetworkCache est la classe de base pour tous les caches standard utilisés par QNetworkAccessManager. QAbstractNetworkCache est une classe abstraite et ne peut pas être instanciée.

Voir aussi QNetworkDiskCache.

Fonctions membres

QAbstractNetworkCache::QAbstractNetworkCache ( QObject * parent = 0 ) [protected]

Construit un cache réseau abstrait avec le parent donné.

QAbstractNetworkCache::~QAbstractNetworkCache () [virtual]

Détruit le cache.

Toutes opérations qui n'ont pas été insérées sont perdues.

Voir aussi insert().

qint64 QAbstractNetworkCache::cacheSize () const [pure virtual]

Retourne la taille actuelle occupée par le cache. Selon l'implémentation du cache, cela peut être de l'espace disque ou mémoire.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi clear().

void QAbstractNetworkCache::clear () [pure virtual slot]

Retire tous les éléments du cache. Sauf si le nettoyage du cache échoue la fonction cacheSize() doit retourner 0 après un appel à la fonction clear().

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi cacheSize() et remove().

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

Retourne les données associées à url.

C'est à l'application demandant les données de supprimer le QIODevice une fois qu'elle a fini de l'utiliser.

S'il n'y a aucun cache pour url, que l'URL est invalide ou en cas d'erreur de cache, la fonction renvoie 0.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi metaData() et prepare().

void QAbstractNetworkCache::insert ( QIODevice * device ) [pure virtual]

Insère les données venant de device et les métadonnées préparées dans le cache. Après l'appel de cette fonction, les données et les métadonnées peuvent être récupérées avec les fonctions data() et metaData().

Pour annuler une insertion préparée appelez remove() sur l'URL des métadonnées.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi prepare() et remove().

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

Retourne les métadonnées pour l'URL url.

Si l'URL est valide et que le cache contient des données pour celle-ci, un QNetworkCacheMetaData valide est retourné.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi updateMetaData() et data().

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

Retourne le QIODevice qui devra contenir les données de l'élément de cache metaData. Lorsque toutes les données ont été écrites, insert() devra être appelée. Si metaData est invalide ou que l'URL dans metaData est invalide, la fonction retourne 0.

Le cache possède le QIODevice et s'occupe de le supprimer lorsqu'il est inséré ou supprimé.

Pour annuler une insertion préparée appelez la fonction remove() sur l'URL de la métadonnée.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi remove(), updateMetaData() et insert().

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

Retire l'entrée du cache pour url, retournant true en cas de réussite, sinon false.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi clear() et prepare().

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

Met à jour le cache des métadonnées pour l'URL de la métadonnée avec metaData

Si le cache ne contient pas d'élément pour cette URL la fonction ne fait rien.

Dans la classe de base cette fonction est virtuelle pure.

Voir aussi metaData() et prepare().

Remerciements

Merci à Alexandre Laurent pour la traduction, ainsi qu'à Ilya Diallo, Ali-K?mal Aydin et Claude Leloup pour la relecture !