akonadi
#include <monitor.h>

Signals | |
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 | itemUnlinked (const Akonadi::Item &item, const Akonadi::Collection &collection) |
void | mimeTypeMonitored (const QString &mimeType, bool monitored) |
void | resourceMonitored (const QByteArray &identifier, bool monitored) |
Public Member Functions | |
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 () |
QList< Item::Id > | itemsMonitored () const |
QVector< Item::Id > | itemsMonitoredEx () const |
QStringList | mimeTypesMonitored () 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) |
Detailed Description
Monitors an item or collection for changes.
The Monitor emits signals if some of these objects are changed or removed or new ones are added to the Akonadi storage.
There are various ways to filter these notifications. There are three types of filter evaluation:
- (-) removal-only filter, ie. if the filter matches the notification is dropped, if not filter evaluation continues with the next one
- (+) pass-exit filter, ie. if the filter matches the notification is delivered, if not evaluation is continued
- (f) final filter, ie. evaluation ends here if the corresponding filter criteria is set, the notification is delievered depending on the result, evaluation is only continued if no filter criteria is defined
The following filter are available, listed in evaluation order: (1) ignored sessions (-) (2) monitor everything (+) (3a) resource and mimetype filters (f) (items only) (3b) resource filters (f) (collections only) (4) item is monitored (+) (5) collection is monitored (+)
Optionally, the changed objects can be fetched automatically from the server. To enable this, see itemFetchScope() and collectionFetchScope().
Note that as a consequence of rule 3a, it is not possible to monitor (more than zero resources OR more than zero mimetypes) AND more than zero collections.
- Todo:
Distinguish between monitoring collection properties and collection content.
Special case for collection content counts changed
Constructor & Destructor Documentation
|
explicit |
Creates a new monitor.
- Parameters
-
parent The parent object.
Definition at line 40 of file monitor.cpp.
|
virtual |
Destroys the monitor.
Definition at line 60 of file monitor.cpp.
Member Function Documentation
|
signal |
This signal is emitted if the Monitor starts or stops monitoring everything.
- Parameters
-
monitored Whether everything is now being monitored or not.
- Since
- 4.3
|
signal |
This signal is emitted if a new collection has been added to a monitored collection in the Akonadi storage.
- Parameters
-
collection The new collection. parent The parent collection.
|
signal |
This signal is emitted if a monitored collection has been changed (properties or content).
- Parameters
-
collection The changed collection.
|
signal |
This signal is emitted if a monitored collection has been changed (properties or attributes).
- Parameters
-
collection The changed collection. attributeNames The names of the collection attributes that have been changed.
- Since
- 4.4
CollectionFetchScope & Monitor::collectionFetchScope | ( | ) |
Returns the collection fetch scope.
Since this returns a reference it can be used to conveniently modify the current scope in-place, i.e. by calling a method on the returned reference without storing it in a local variable. See the CollectionFetchScope documentation for an example.
- Returns
- a reference to the current collection fetch scope
- See Also
- setCollectionFetchScope() for replacing the current collection fetch scope
- Since
- 4.4
Definition at line 174 of file monitor.cpp.
|
signal |
This signal is emitted if the Monitor starts or stops monitoring collection
explicitly.
- Parameters
-
collection The collection monitored Whether the collection is now being monitored or not.
- Since
- 4.3
|
signal |
This signals is emitted if a monitored collection has been moved.
- Parameters
-
collection The moved collection. source The previous parent collection. destination The new parent collection.
- Since
- 4.4
|
signal |
This signal is emitted if a monitored collection has been removed from the Akonadi storage.
- Parameters
-
collection The removed collection.
Akonadi::Collection::List Monitor::collectionsMonitored | ( | ) | const |
Returns the list of collections being monitored.
- Since
- 4.3
Definition at line 180 of file monitor.cpp.
|
signal |
This signal is emitted if the statistics information of a monitored collection has changed.
- Parameters
-
id The collection identifier of the changed collection. statistics The updated collection statistics, invalid if automatic fetching of statistics changes is disabled.
|
signal |
This signal is emitted if a collection has been subscribed to by the user.
It will be emitted even for unmonitored collections as the check for whether to monitor it has not been applied yet.
- Parameters
-
collection The subscribed collection parent The parent collection of the subscribed collection.
- Since
- 4.6
|
signal |
This signal is emitted if a user unsubscribes from a collection.
- Parameters
-
collection The unsubscribed collection
- Since
- 4.6
void Monitor::fetchChangedOnly | ( | bool | enable | ) |
Instructs the monitor to fetch only those parts that were changed and were requested in the fetch scope.
This is taken in account only for item modifications. Example usage:
In the example if an item was changed, but its payload was not, the full payload will not be retrieved. If the item's payload was changed, the monitor retrieves the changed payload as well.
The default is to fetch everything requested.
- Since
- 4.8
- Parameters
-
enable true
to enable the feature,false
means everything that was requested will be fetched.
- Returns
- void
Definition at line 161 of file monitor.cpp.
void Monitor::fetchCollection | ( | bool | enable | ) |
Enables automatic fetching of changed collections from the Akonadi storage.
- Parameters
-
enable true
enables automatic fetching,false
disables automatic fetching.
Definition at line 137 of file monitor.cpp.
void Monitor::fetchCollectionStatistics | ( | bool | enable | ) |
Enables automatic fetching of changed collection statistics information from the Akonadi storage.
- Parameters
-
enable true
to enables automatic fetching,false
disables automatic fetching.
Definition at line 143 of file monitor.cpp.
void Monitor::ignoreSession | ( | Session * | session | ) |
Ignores all change notifications caused by the given session.
This overrides all other settings on this session.
- Parameters
-
session The session you want to ignore.
Definition at line 130 of file monitor.cpp.
bool Monitor::isAllMonitored | ( | ) | const |
|
signal |
This signal is emitted if an item has been added to a monitored collection in the Akonadi storage.
- Parameters
-
item The new item. collection The collection the item has been added to.
|
signal |
This signal is emitted if a monitored item has changed, e.g.
item parts have been modified.
- Parameters
-
item The changed item. partIdentifiers The identifiers of the item parts that has been changed.
ItemFetchScope & Monitor::itemFetchScope | ( | ) |
Returns the item fetch scope.
Since this returns a reference it can be used to conveniently modify the current scope in-place, i.e. by calling a method on the returned reference without storing it in a local variable. See the ItemFetchScope documentation for an example.
- Returns
- a reference to the current item fetch scope
- See Also
- setItemFetchScope() for replacing the current item fetch scope
Definition at line 155 of file monitor.cpp.
|
signal |
This signal is emitted if a reference to an item is added to a virtual collection.
- Parameters
-
item The linked item. collection The collection the item is linked to.
- Since
- 4.2
|
signal |
This signal is emitted if the Monitor starts or stops monitoring item
explicitly.
- Parameters
-
item The item monitored Whether the item is now being monitored or not.
- Since
- 4.3
|
signal |
This signal is emitted if a monitored item has been moved between two collections.
- Parameters
-
item The moved item. collectionSource The collection the item has been moved from. collectionDestination The collection the item has been moved to.
|
signal |
This signal is emitted if.
- a monitored item has been removed from the Akonadi storage or
- a item has been removed from a monitored collection.
- Parameters
-
item The removed item.
QList< Item::Id > Monitor::itemsMonitored | ( | ) | const |
Returns the set of items being monitored.
- Since
- 4.3
- Deprecated:
- Use itemsMonitoredEx() instead.
Definition at line 186 of file monitor.cpp.
QVector< Item::Id > Monitor::itemsMonitoredEx | ( | ) | const |
Returns the set of items being monitored.
Faster version (at least on 32-bit systems) of itemsMonitored().
- Since
- 4.6
Definition at line 192 of file monitor.cpp.
|
signal |
This signal is emitted if a reference to an item is removed from a virtual collection.
- Parameters
-
item The unlinked item. collection The collection the item is unlinked from.
- Since
- 4.2
|
signal |
This signal is emitted if the Monitor starts or stops monitoring mimeType
explicitly.
- Parameters
-
mimeType The mimeType. monitored Whether the mimeType is now being monitored or not.
- Since
- 4.3
QStringList Monitor::mimeTypesMonitored | ( | ) | const |
|
signal |
This signal is emitted if the Monitor starts or stops monitoring the resource with the identifier identifier
explicitly.
- Parameters
-
identifier The identifier of the resource. monitored Whether the resource is now being monitored or not.
- Since
- 4.3
QList< QByteArray > Monitor::resourcesMonitored | ( | ) | const |
Returns the set of identifiers for resources being monitored.
- Since
- 4.3
Definition at line 207 of file monitor.cpp.
Session * Monitor::session | ( | ) | const |
Returns the Session used by the monitor to communicate with Akonadi.
- Since
- 4.4
Definition at line 234 of file monitor.cpp.
void Akonadi::Monitor::setAllMonitored | ( | bool | monitored = true | ) |
Sets whether all items shall be monitored.
Note that if a session is being ignored, this takes precedence over setAllMonitored() on that session.
Definition at line 118 of file monitor.cpp.
void Monitor::setCollectionFetchScope | ( | const CollectionFetchScope & | fetchScope | ) |
Sets the collection fetch scope.
Controls which collections are monitored and how much of a collection's data is fetched from the server.
- Parameters
-
fetchScope The new scope for collection fetch operations.
- See Also
- collectionFetchScope()
- Since
- 4.4
Definition at line 168 of file monitor.cpp.
void Monitor::setCollectionMonitored | ( | const Collection & | collection, |
bool | monitored = true |
||
) |
Sets whether the specified collection shall be monitored for changes.
If monitoring is turned on for the collection, all notifications for items in that collection will be emitted, and its child collections will also be monitored. Note that move notifications will be emitted if either one of the collections involved is being monitored.
Note that if a session is being ignored, this takes precedence over setCollectionMonitored() on that session.
- Parameters
-
collection The collection to monitor. If this collection is Collection::root(), all collections in the Akonadi storage will be monitored. monitored Whether to monitor the collection.
Definition at line 69 of file monitor.cpp.
void Monitor::setCollectionMoveTranslationEnabled | ( | bool | enabled | ) |
Allows to enable/disable collection move translation.
If enabled (the default), move notifications are auotmatically translated into add/remove notifications if the source/destination is outside of the monitored collection hierarchy.
- Since
- 4.9
Definition at line 240 of file monitor.cpp.
void Monitor::setItemFetchScope | ( | const ItemFetchScope & | fetchScope | ) |
Sets the item fetch scope.
Controls how much of an item's data is fetched from the server, e.g. whether to fetch the full item payload or only meta data.
- Parameters
-
fetchScope The new scope for item fetch operations.
- See Also
- itemFetchScope()
Definition at line 149 of file monitor.cpp.
void Monitor::setItemMonitored | ( | const Item & | item, |
bool | monitored = true |
||
) |
Sets whether the specified item shall be monitored for changes.
Note that if a session is being ignored, this takes precedence over setItemMonitored() on that session.
- Parameters
-
item The item to monitor. monitored Whether to monitor the item.
Definition at line 81 of file monitor.cpp.
void Monitor::setMimeTypeMonitored | ( | const QString & | mimetype, |
bool | monitored = true |
||
) |
Sets whether items of the specified mime type shall be monitored for changes.
If monitoring is turned on for the mime type, all notifications for items matching that mime type will be emitted, but notifications for collections matching that mime type will only be emitted if this is otherwise specified, for example by setCollectionMonitored().
Note that if a session is being ignored, this takes precedence over setMimeTypeMonitored() on that session.
- Parameters
-
mimetype The mime type to monitor. monitored Whether to monitor the mime type.
Definition at line 105 of file monitor.cpp.
void Monitor::setResourceMonitored | ( | const QByteArray & | resource, |
bool | monitored = true |
||
) |
Sets whether the specified resource shall be monitored for changes.
If monitoring is turned on for the resource, all notifications for collections and items in that resource will be emitted.
Note that if a session is being ignored, this takes precedence over setResourceMonitored() on that session.
- Parameters
-
resource The resource identifier. monitored Whether to monitor the resource.
Definition at line 93 of file monitor.cpp.
void Monitor::setSession | ( | Akonadi::Session * | session | ) |
Sets the session used by the Monitor to communicate with the Akonadi server.
If not set, the Akonadi::Session::defaultSession is used.
- Since
- 4.4
Definition at line 219 of file monitor.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2013 The KDE developers.
Generated on Sat Jul 13 2013 01:27:51 by doxygen 1.8.3.1 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.