KDirListerCache Class Reference

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

#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 *lister, const KFileItemList &lst, const KFileItem &rootItem, 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	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	stop (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 180 of file kdirlister_p.h.

---

Constructor & Destructor Documentation

KDirListerCache::KDirListerCache

(

)

Definition at line 53 of file kdirlister.cpp.

KDirListerCache::~KDirListerCache

(

)

Definition at line 79 of file kdirlister.cpp.

---

Member Function Documentation

void KDirListerCache::emitItemsFromCache	(	KDirLister *	lister,
		const KFileItemList &	lst,
		const KFileItem &	rootItem,
		const KUrl &	_url,
		bool	_reload,
		bool	_emitCompleted
	)

Definition at line 282 of file kdirlister.cpp.

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

Definition at line 723 of file kdirlister.cpp.

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

Definition at line 739 of file kdirlister.cpp.

void KDirListerCache::forgetDirs

(

KDirLister *

lister

)

Definition at line 452 of file kdirlister.cpp.

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

Definition at line 484 of file kdirlister.cpp.

KFileItem KDirListerCache::itemForUrl

(

const KUrl &

url

)

const

Definition at line 698 of file kdirlister.cpp.

KFileItemList * KDirListerCache::itemsForDir

(

const KUrl &

dir

)

const

Definition at line 717 of file kdirlister.cpp.

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

Definition at line 95 of file kdirlister.cpp.

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

Definition at line 437 of file kdirlister.cpp.

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

Definition at line 882 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 775 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 848 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 788 of file kdirlister.cpp.

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

Definition at line 350 of file kdirlister.cpp.

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

Definition at line 389 of file kdirlister.cpp.

void KDirListerCache::updateDirectory

(

const KUrl &

dir

)

Definition at line 577 of file kdirlister.cpp.

---

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

• kdirlister_p.h
• kdirlister.cpp