Difference between revisions of "Projects/PIM/Development/SingleFileResourceRefactoring"

< Projects‎ | PIM
Jump to: navigation, search
(On item retrieval)
(Rationals, additional option)
Line 33: Line 33:
 
* read both copies, compare item by item, using any dirty item in favor of the respective one from copy 1.
 
* read both copies, compare item by item, using any dirty item in favor of the respective one from copy 1.
 
* do not call synchronize, modify Akonadi like any resource with item level change notification.
 
* do not call synchronize, modify Akonadi like any resource with item level change notification.
 +
 +
Rational: does not require ItemSync, usually only very few changes, e.g. non-Akonadi application modifying it.
 +
 
* finally remove copy 1 and make copy 2 the new copy 1
 
* finally remove copy 1 and make copy 2 the new copy 1
 +
 +
Or
 +
 +
* Call clearCache()
 +
 +
Rational: if no load has happend yet, we don't have to reload. If items have been loaded before, clearing the cache means the server will request them when necessary.
  
 
=== Drawbacks ===
 
=== Drawbacks ===

Revision as of 20:27, 6 November 2009

Contents

SingleFileResource Refactoring

Problem Statement

The current (KDE 4.[3,4]) design of the SingleFileResource (SFR) is heavily based on the ical/vcard resources. Those two read the whole file at once and keep the entries in memory as long as they exists. However this is not really in line with the Akonadi design, as Akonadi itself keeps items in chache also and has advanced cache policies even. Also, other resources, like the mbox resource don't keep the whole file in memory but only store pointers to the beginning of each new entry. These two concepts conflict with each other as soon as Akonadi detects that the file on disk has changed. Currently SFR makes a backup of the file by calling writeFile() with a different file name. But this can only succeed correctly if the resource has all data in memory. This is not the case for the mbox resource (and this shouldn't be the case for the other SFR based resources in the future) which will result in a backup file that partly consist of the new data and partly the old data (if it succeeds at all).

Suggested Changes

General

  • The file resources should never store the complete data in memory
  • When items are requested from the file resource it always should read from the file it is initialized for

Rational: Data caching is the responsibility of the Akonadi server, controlled by Cache policies. Permanently keeping data in resource memory wastes memory and is a bad example for developers interested in creating resources who might be looking for example code.

  • The SFR only reads the file at retrieveItems

Rational: Akonadi calls this method when it needs items. If it doesn't call it, it doesn't need them. The need could be a client explicitly fetching the items or cache policy interval checking.

If it is deemed necessary to have all items loaded once a resource is configured, we can always just call synchronize() instead of synchronizeCollectionTree(), thus getting the retrieveItems() call.

On item retrieval

  • Make loading always download the file independent of whether it is remote or local

Rational: a copy of the data file is needed to be able to detect/extract changes on item level when a file change notification happens. As a bonus handling of remote files does no longer need separate code paths.

  • Create items from the downloaded file
  • Compare with items from current working copy
  • Call itemsRetrieved
  • Make downloaded file the new working copy

On file change

  • A second copy of the file is created.
  • read both copies, compare item by item, using any dirty item in favor of the respective one from copy 1.
  • do not call synchronize, modify Akonadi like any resource with item level change notification.

Rational: does not require ItemSync, usually only very few changes, e.g. non-Akonadi application modifying it.

  • finally remove copy 1 and make copy 2 the new copy 1

Or

  • Call clearCache()

Rational: if no load has happend yet, we don't have to reload. If items have been loaded before, clearing the cache means the server will request them when necessary.

Drawbacks

  • Two files are parsed on fileChanged()

Advantages

  • Reduced memory usage
  • if dirty items are not part of the change, no need to backup or panic ???
  • Better data consistency in case files are changed by non-Akonadi programs.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal