KDirListerCache Class Reference

#include <kdirlister_p.h>

Inheritance diagram for KDirListerCache:

List of all members.

Public Slots
void	slotFileRenamed (const QString &srcUrl, const QString &dstUrl)
void	slotFilesAdded (const QString &urlDirectory)
void	slotFilesChanged (const QStringList &fileList)
void	slotFilesRemoved (const QStringList &fileList)

Public Member Functions
	KDirListerCache ()
	~KDirListerCache ()
void	emitItemsFromCache (KDirLister::Private::CachedItemsJob *job, KDirLister *lister, const KUrl &_url, bool _reload, bool _emitCompleted)
KFileItem	findByName (const KDirLister *lister, const QString &_name) const
KFileItem *	findByUrl (const KDirLister *lister, const KUrl &url) const
void	forgetCachedItemsJob (KDirLister::Private::CachedItemsJob *job, KDirLister *lister, const KUrl &url)
void	forgetDirs (KDirLister *lister)
void	forgetDirs (KDirLister *lister, const KUrl &_url, bool notify)
KFileItem	itemForUrl (const KUrl &url) const
KFileItemList *	itemsForDir (const KUrl &dir) const
bool	listDir (KDirLister *lister, const KUrl &_url, bool _keep, bool _reload)
void	setAutoUpdate (KDirLister *lister, bool enable)
void	stop (KDirLister *lister, bool silent=false)
void	stopListingUrl (KDirLister *lister, const KUrl &_url, bool silent=false)
void	updateDirectory (const KUrl &dir)

---

Detailed Description

Design of the cache: There is a single KDirListerCache for the whole process.

It holds all the items used by the dir listers (itemsInUse) as well as a cache of the recently used items (itemsCached). Those items are grouped by directory (a DirItem represents a whole directory).

KDirListerCache also runs all the jobs for listing directories, whether they are for normal listing or for updates. For faster lookups, it also stores a hash table, which gives for a directory URL:

• the dirlisters holding that URL (listersCurrentlyHolding)
• the dirlisters currently listing that URL (listersCurrentlyListing)

Definition at line 181 of file kdirlister_p.h.

---

Constructor & Destructor Documentation

KDirListerCache::KDirListerCache

(

)

Definition at line 49 of file kdirlister.cpp.

KDirListerCache::~KDirListerCache

(

)

Definition at line 75 of file kdirlister.cpp.

---

Member Function Documentation

void KDirListerCache::emitItemsFromCache	(	KDirLister::Private::CachedItemsJob *	job,
		KDirLister *	lister,
		const KUrl &	_url,
		bool	_reload,
		bool	_emitCompleted
	)

Definition at line 319 of file kdirlister.cpp.

KFileItem KDirListerCache::findByName	(	const KDirLister *	lister,
		const QString &	_name
	)		const

Definition at line 788 of file kdirlister.cpp.

KFileItem * KDirListerCache::findByUrl	(	const KDirLister *	lister,
		const KUrl &	url
	)		const

Definition at line 804 of file kdirlister.cpp.

void KDirListerCache::forgetCachedItemsJob	(	KDirLister::Private::CachedItemsJob *	job,
		KDirLister *	lister,
		const KUrl &	url
	)

Definition at line 361 of file kdirlister.cpp.

void KDirListerCache::forgetDirs

(

KDirLister *

lister

)

Definition at line 507 of file kdirlister.cpp.

void KDirListerCache::forgetDirs	(	KDirLister *	lister,
		const KUrl &	_url,
		bool	notify
	)

Definition at line 540 of file kdirlister.cpp.

KFileItem KDirListerCache::itemForUrl

(

const KUrl &

url

)

const

Definition at line 763 of file kdirlister.cpp.

KFileItemList * KDirListerCache::itemsForDir

(

const KUrl &

dir

)

const

Definition at line 782 of file kdirlister.cpp.

bool KDirListerCache::listDir	(	KDirLister *	lister,
		const KUrl &	_url,
		bool	_keep,
		bool	_reload
	)

Definition at line 91 of file kdirlister.cpp.

void KDirListerCache::setAutoUpdate	(	KDirLister *	lister,
		bool	enable
	)

Definition at line 492 of file kdirlister.cpp.

void KDirListerCache::slotFileRenamed ( const QString &  srcUrl, const QString &  dstUrl  )

slot

Definition at line 947 of file kdirlister.cpp.

void KDirListerCache::slotFilesAdded ( const QString &  urlDirectory )

slot

Notify that files have been added in directory The receiver will list that directory again to find the new items (since it needs more than just the names anyway).

Connected to the DBus signal from the KDirNotify interface.

Definition at line 840 of file kdirlister.cpp.

void KDirListerCache::slotFilesChanged ( const QStringList &  fileList )

slot

Notify that files have been changed.

At the moment, this is only used for new icon, but it could be used for size etc. as well. Connected to the DBus signal from the KDirNotify interface.

Definition at line 913 of file kdirlister.cpp.

void KDirListerCache::slotFilesRemoved ( const QStringList &  fileList )

slot

Notify that files have been deleted.

This call passes the exact urls of the deleted files so that any view showing them can simply remove them or be closed (if its current dir was deleted) Connected to the DBus signal from the KDirNotify interface.

Definition at line 853 of file kdirlister.cpp.

void KDirListerCache::stop	(	KDirLister *	lister,
		bool	silent = false
	)

Definition at line 408 of file kdirlister.cpp.

void KDirListerCache::stopListingUrl	(	KDirLister *	lister,
		const KUrl &	_url,
		bool	silent = false
	)

Definition at line 433 of file kdirlister.cpp.

void KDirListerCache::updateDirectory

(

const KUrl &

dir

)

Definition at line 642 of file kdirlister.cpp.

---

The documentation for this class was generated from the following files:

• kdirlister_p.h
• kdirlister.cpp