CachePolicy Class Reference
from PyKDE4.akonadi import *
Namespace: Akonadi
Detailed Description
Represents the caching policy for a collection.
There is one cache policy per collection, it can either define to inherit all properties of the policy of the parent collection (the default) or specify the following values:
- The item parts that should be permanently kept locally and are downloaded during a collection sync (eg. full mail vs. just the headers). - A time up to which non-permantly cached item parts have to be kept at least (0 - infinity). - Whether or not a collection sync is triggered on demand, ie. as soon as it is accessed by a client. - An optional time interval for regular collection sync (aka interval mail check).
Akonadi.CachePolicy policy; policy.setCacheTimeout( 30 ); policy.setIntervalCheckTime( 20 ); Akonadi.Collection collection = ... collection.setCachePolicy( policy );
To do: Do we also need a size limit for the cache as well? To do: on a POP3 account, is should not be possible to change locally cached parts, find a solution for that
| Methods | |
| __init__ (self) | |
| __init__ (self, Akonadi.CachePolicy other) | |
| int | cacheTimeout (self) | 
| bool | inheritFromParent (self) | 
| int | intervalCheckTime (self) | 
| QStringList | localParts (self) | 
| bool | operator == (self, Akonadi.CachePolicy other) | 
| setCacheTimeout (self, int timeout) | |
| setInheritFromParent (self, bool inherit) | |
| setIntervalCheckTime (self, int time) | |
| setLocalParts (self, QStringList parts) | |
| setSyncOnDemand (self, bool enable) | |
| bool | syncOnDemand (self) | 
Method Documentation
| __init__ | ( | self ) | 
Creates an empty cache policy.
| __init__ | ( | self, | ||
| Akonadi.CachePolicy | other | |||
| ) | 
Creates a cache policy from an other cache policy.
| int cacheTimeout | ( | self ) | 
Returns the cache timeout for non-permanently cached parts in minutes, -1 means indefinitely.
| bool inheritFromParent | ( | self ) | 
Returns whether it inherits cache policy from parent collection.
| int intervalCheckTime | ( | self ) | 
Returns the interval check time in minutes, -1 for never.
| QStringList localParts | ( | self ) | 
Returns the parts to permanently cache locally.
| bool operator == | ( | self, | ||
| Akonadi.CachePolicy | other | |||
| ) | 
- Internal:
| setCacheTimeout | ( | self, | ||
| int | timeout | |||
| ) | 
Sets cache timeout for non-permanently cached parts.
- Parameters:
- 
timeout Timeout in minutes, -1 for indefinitely. 
| setInheritFromParent | ( | self, | ||
| bool | inherit | |||
| ) | 
Sets whether the cache policy should be inherited from the parent collection.
| setIntervalCheckTime | ( | self, | ||
| int | time | |||
| ) | 
Sets interval check time.
- Parameters:
- 
time Check time interval in minutes, -1 for never. 
| setLocalParts | ( | self, | ||
| QStringList | parts | |||
| ) | 
Specifies the parts to permanently cache locally.
| setSyncOnDemand | ( | self, | ||
| bool | enable | |||
| ) | 
Sets whether the collection shall be synced automatically when necessary.
- Parameters:
- 
enable If true the collection is synced. 
| bool syncOnDemand | ( | self ) | 
Returns whether the collection shall be synced automatically when necessary.
 KDE 4.5 PyKDE API Reference
        KDE 4.5 PyKDE API Reference