Akonadi::ChangeRecorder Class Reference

#include <changerecorder.h>

Inheritance diagram for Akonadi::ChangeRecorder:

Public Slots
void	replayNext ()

Signals
void	changesAdded ()
void	nothingToReplay ()
Signals inherited from Akonadi::Monitor
void	allMonitored (bool monitored)
void	collectionAdded (const Akonadi::Collection &collection, const Akonadi::Collection &parent)
void	collectionChanged (const Akonadi::Collection &collection)
void	collectionChanged (const Akonadi::Collection &collection, const QSet< QByteArray > &attributeNames)
void	collectionMonitored (const Akonadi::Collection &collection, bool monitored)
void	collectionMoved (const Akonadi::Collection &collection, const Akonadi::Collection &source, const Akonadi::Collection &destination)
void	collectionRemoved (const Akonadi::Collection &collection)
void	collectionStatisticsChanged (Akonadi::Collection::Id id, const Akonadi::CollectionStatistics &statistics)
void	collectionSubscribed (const Akonadi::Collection &collection, const Akonadi::Collection &parent)
void	collectionUnsubscribed (const Akonadi::Collection &collection)
void	itemAdded (const Akonadi::Item &item, const Akonadi::Collection &collection)
void	itemChanged (const Akonadi::Item &item, const QSet< QByteArray > &partIdentifiers)
void	itemLinked (const Akonadi::Item &item, const Akonadi::Collection &collection)
void	itemMonitored (const Akonadi::Item &item, bool monitored)
void	itemMoved (const Akonadi::Item &item, const Akonadi::Collection &collectionSource, const Akonadi::Collection &collectionDestination)
void	itemRemoved (const Akonadi::Item &item)
void	itemsFlagsChanged (const Akonadi::Item::List &items, const QSet< QByteArray > &addedFlags, const QSet< QByteArray > &removedFlags)
void	itemsLinked (const Akonadi::Item::List &items, const Akonadi::Collection &collection)
void	itemsMoved (const Akonadi::Item::List &items, const Akonadi::Collection &collectionSource, const Akonadi::Collection &collectionDestination)
void	itemsRemoved (const Akonadi::Item::List &items)
void	itemsTagsChanged (const Akonadi::Item::List &items, const QSet< Akonadi::Tag > &addedTags, const QSet< Akonadi::Tag > &removedTags)
void	itemsUnlinked (const Akonadi::Item::List &items, const Akonadi::Collection &collection)
void	itemUnlinked (const Akonadi::Item &item, const Akonadi::Collection &collection)
void	mimeTypeMonitored (const QString &mimeType, bool monitored)
void	resourceMonitored (const QByteArray &identifier, bool monitored)
void	tagAdded (const Akonadi::Tag &tag)
void	tagChanged (const Akonadi::Tag &tag)
void	tagMonitored (const Akonadi::Tag &tag, bool monitored)
void	tagRemoved (const Akonadi::Tag &tag)
void	typeMonitored (const Akonadi::Monitor::Type type, bool monitored)

Public Member Functions
	ChangeRecorder (QObject *parent=0)
	~ChangeRecorder ()
void	changeProcessed ()
QString	dumpNotificationListToString () const
bool	isEmpty () const
void	setChangeRecordingEnabled (bool enable)
void	setConfig (QSettings *settings)
Public Member Functions inherited from Akonadi::Monitor
	Monitor (QObject *parent=0)
virtual	~Monitor ()
CollectionFetchScope &	collectionFetchScope ()
Collection::List	collectionsMonitored () const
void	fetchChangedOnly (bool enable)
void	fetchCollection (bool enable)
void	fetchCollectionStatistics (bool enable)
void	ignoreSession (Session *session)
bool	isAllMonitored () const
ItemFetchScope &	itemFetchScope ()
AKONADI_DEPRECATED QList < Item::Id >	itemsMonitored () const
QVector< Item::Id >	itemsMonitoredEx () const
QStringList	mimeTypesMonitored () const
int	numItemsMonitored () const
int	numMimeTypesMonitored () const
int	numResourcesMonitored () const
QList< QByteArray >	resourcesMonitored () const
Session *	session () const
void	setAllMonitored (bool monitored=true)
void	setCollectionFetchScope (const CollectionFetchScope &fetchScope)
void	setCollectionMonitored (const Collection &collection, bool monitored=true)
void	setCollectionMoveTranslationEnabled (bool enabled)
void	setItemFetchScope (const ItemFetchScope &fetchScope)
void	setItemMonitored (const Item &item, bool monitored=true)
void	setMimeTypeMonitored (const QString &mimetype, bool monitored=true)
void	setResourceMonitored (const QByteArray &resource, bool monitored=true)
void	setSession (Akonadi::Session *session)
void	setTagFetchScope (const TagFetchScope &fetchScope)
void	setTagMonitored (const Tag &tag, bool monitored=true)
void	setTypeMonitored (Type type, bool monitored=true)
TagFetchScope &	tagFetchScope ()
QVector< Tag::Id >	tagsMonitored () const
QVector< Type >	typesMonitored () const
Public Member Functions inherited from QObject
	QObject (QObject *parent)
	QObject (QObject *parent, const char *name)
bool	blockSignals (bool block)
QObject *	child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
const QObjectList &	children () const
const char *	className () const
bool	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const QObject *receiver, const char *method)
bool	disconnect (const char *signal, const QObject *receiver, const char *method)
void	dumpObjectInfo ()
void	dumpObjectTree ()
QList< QByteArray >	dynamicPropertyNames () const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name) const
QList< T >	findChildren (const QRegExp &regExp) const
QList< T >	findChildren (const QString &name) const
bool	inherits (const char *className) const
void	insertChild (QObject *object)
void	installEventFilter (QObject *filterObj)
bool	isA (const char *className) const
bool	isWidgetType () const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const
void	moveToThread (QThread *targetThread)
const char *	name () const
const char *	name (const char *defaultName) const
QString	objectName () const
QObject *	parent () const
QVariant	property (const char *name) const
void	removeChild (QObject *object)
void	removeEventFilter (QObject *obj)
void	setName (const char *name)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const
int	startTimer (int interval)
QThread *	thread () const

Additional Inherited Members
Public Types inherited from Akonadi::Monitor
enum	Type { Collections = 1, Items, Tags }
Static Public Member Functions inherited from QObject
bool	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
bool	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char *signal, const QObject *object, const char *method)
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const char *signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const char *signal)
int	receivers (const char *signal) const
QObject *	sender () const
int	senderSignalIndex () const
virtual void	timerEvent (QTimerEvent *event)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Properties inherited from QObject
	objectName

Detailed Description

Records and replays change notification.

This class is responsible for recording change notifications while an agent is not online and replaying the notifications when the agent is online again. Therefore the agent doesn't have to care about online/offline mode in its synchronization algorithm.

Unlike Akonadi::Monitor this class only emits one change signal at a time. To receive the next one you need to explicitly call replayNext(). If a signal is emitted that has no receivers, it's automatically skipped, which means you only need to connect to signals you are actually interested in.

Author

Volker Krause vkrau.nosp@m.se@k.nosp@m.de.or.nosp@m.g

Definition at line 47 of file changerecorder.h.

Constructor & Destructor Documentation

ChangeRecorder::ChangeRecorder ( QObject *  parent = 0 )

explicit

Creates a new change recorder.

Definition at line 28 of file changerecorder.cpp.

ChangeRecorder::~ChangeRecorder

(

)

Destroys the change recorder.

All not yet processed changes are written back to the config file.

Definition at line 38 of file changerecorder.cpp.

Member Function Documentation

void ChangeRecorder::changeProcessed

(

)

Removes the previously emitted change from the records.

Definition at line 97 of file changerecorder.cpp.

void Akonadi::ChangeRecorder::changesAdded ( )

signal

Emitted when new changes are recorded.

QString Akonadi::ChangeRecorder::dumpNotificationListToString

(

)

const

Debugging: dump current list of notifications, as saved on disk.

Definition at line 128 of file changerecorder.cpp.

bool ChangeRecorder::isEmpty

(

)

const

Returns whether there are recorded changes.

Definition at line 91 of file changerecorder.cpp.

void Akonadi::ChangeRecorder::nothingToReplay ( )

signal

Emitted when replayNext() was called, but there was no valid change to replay.

This can happen when all pending changes have been filtered out, for example. You only need to connect to this signal if you rely on one signal being emitted as a result of calling replayNext().

void ChangeRecorder::replayNext ( )

slot

Replay the next change notification and erase the previous one from the record.

Definition at line 57 of file changerecorder.cpp.

void ChangeRecorder::setChangeRecordingEnabled

(

bool

enable

)

Enables change recording.

If change recording is disabled, this class behaves exactly like Akonadi::Monitor. Change recording is enabled by default.

Parameters

enable

false to disable change recording. true by default

Definition at line 113 of file changerecorder.cpp.

void ChangeRecorder::setConfig

(

QSettings *

settings

)

Sets the QSettings object used for persistent recorded changes.

Definition at line 42 of file changerecorder.cpp.

---

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

• changerecorder.h
• changerecorder.cpp