libkcal

KCal::ResourceCached Class Reference

#include <resourcecached.h>

Inheritance diagram for KCal::ResourceCached:

KCal::ResourceCalendar KCal::Calendar::Observer KCal::ResourceLocal

List of all members.


Detailed Description

This class provides a calendar resource using a local CalendarLocal object to cache the calendar data.

Definition at line 45 of file resourcecached.h.


Public Types

enum  { ReloadNever, ReloadOnStartup, ReloadInterval }
enum  {
  SaveNever, SaveOnExit, SaveInterval, SaveDelayed,
  SaveAlways
}

Public Member Functions

 ResourceCached (const KConfig *)
void readConfig (const KConfig *config)
void writeConfig (KConfig *config)
void setReloadPolicy (int policy)
int reloadPolicy () const
void setReloadInterval (int minutes)
int reloadInterval () const
void setSavePolicy (int policy)
int savePolicy () const
void setSaveInterval (int minutes)
int saveInterval () const
QDateTime lastLoad () const
QDateTime lastSave () const
bool addEvent (Event *anEvent)
bool deleteEvent (Event *)
Eventevent (const QString &UniqueStr)
Event::List events ()
Event::List rawEvents (EventSortField sortField=EventSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Event::List rawEventsForDate (const QDate &date, EventSortField sortField=EventSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Event::List rawEventsForDate (const QDateTime &qdt)
Event::List rawEvents (const QDate &start, const QDate &end, bool inclusive=false)
bool addTodo (Todo *todo)
bool deleteTodo (Todo *)
Todotodo (const QString &uid)
Todo::List rawTodos (TodoSortField sortField=TodoSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Todo::List rawTodosForDate (const QDate &date)
virtual bool addJournal (Journal *)
virtual bool deleteJournal (Journal *)
virtual Journaljournal (const QString &uid)
Journal::List rawJournals (JournalSortField sortField=JournalSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Journal::List rawJournalsForDate (const QDate &date)
Alarm::List alarms (const QDateTime &from, const QDateTime &to)
Alarm::List alarmsTo (const QDateTime &to)
void setTimeZoneId (const QString &timeZoneId)
QString timeZoneId () const
const PersongetOwner () const
void setOwner (const Person &owner)
void enableChangeNotification ()
void disableChangeNotification ()
void clearChange (Incidence *)
void clearChange (const QString &uid)
void clearChanges ()
bool hasChanges () const
Incidence::List allChanges () const
Incidence::List addedIncidences () const
Incidence::List changedIncidences () const
Incidence::List deletedIncidences () const
void loadCache ()
void saveCache ()
void clearCache ()
void cleanUpEventCache (const KCal::Event::List &eventList)
void cleanUpTodoCache (const KCal::Todo::List &todoList)
KPIM::IdMapper & idMapper ()

Protected Slots

void slotReload ()
void slotSave ()
void setIdMapperIdentifier ()

Protected Member Functions

void calendarIncidenceAdded (KCal::Incidence *incidence)
void calendarIncidenceChanged (KCal::Incidence *incidence)
void calendarIncidenceDeleted (KCal::Incidence *incidence)
virtual void doClose ()
virtual bool doOpen ()
bool checkForReload ()
bool checkForSave ()
void checkForAutomaticSave ()
void addInfoText (QString &) const
void setupSaveTimer ()
void setupReloadTimer ()
virtual QString cacheFile () const
virtual QString changesCacheFile (const QString &) const
void loadChangesCache (QMap< Incidence *, bool > &, const QString &)
void loadChangesCache ()
void saveChangesCache (const QMap< Incidence *, bool > &, const QString &)
void saveChangesCache ()

Protected Attributes

CalendarLocal mCalendar

Member Enumeration Documentation

anonymous enum

Reload policy.

See also:
setReloadPolicy(), reloadPolicy()

Definition at line 55 of file resourcecached.h.

anonymous enum

Save policy.

See also:
setSavePolicy(), savePolicy()

Definition at line 61 of file resourcecached.h.


Member Function Documentation

void ResourceCached::setReloadPolicy ( int  policy  ) 

Set reload policy.

This controls when the cache is refreshed.

ReloadNever never reload ReloadOnStartup reload when resource is started ReloadInterval reload regularly after given interval

Definition at line 60 of file resourcecached.cpp.

int ResourceCached::reloadPolicy (  )  const

Return reload policy.

See also:
setReloadPolicy()

Definition at line 67 of file resourcecached.cpp.

void ResourceCached::setReloadInterval ( int  minutes  ) 

Set reload interval in minutes which is used when reload policy is ReloadInterval.

Definition at line 72 of file resourcecached.cpp.

int ResourceCached::reloadInterval (  )  const

Return reload interval in minutes.

Definition at line 77 of file resourcecached.cpp.

void ResourceCached::setSavePolicy ( int  policy  ) 

Set save policy.

This controls when the cache is refreshed.

SaveNever never save SaveOnExit save when resource is exited SaveInterval save regularly after given interval SaveDelayed save after small delay SaveAlways save on every change

Definition at line 82 of file resourcecached.cpp.

int ResourceCached::savePolicy (  )  const

Return save policy.

See also:
setsavePolicy()

Definition at line 89 of file resourcecached.cpp.

void ResourceCached::setSaveInterval ( int  minutes  ) 

Set save interval in minutes which is used when save policy is SaveInterval.

Definition at line 94 of file resourcecached.cpp.

int ResourceCached::saveInterval (  )  const

Return save interval in minutes.

Definition at line 99 of file resourcecached.cpp.

QDateTime KCal::ResourceCached::lastLoad (  )  const

Return time of last load.

QDateTime KCal::ResourceCached::lastSave (  )  const

Return time of last save.

bool ResourceCached::addEvent ( Event anEvent  )  [virtual]

Add event to calendar.

Implements KCal::ResourceCalendar.

Definition at line 153 of file resourcecached.cpp.

bool ResourceCached::deleteEvent ( Event event  )  [virtual]

Deletes an event from this calendar.

Implements KCal::ResourceCalendar.

Definition at line 159 of file resourcecached.cpp.

Event * ResourceCached::event ( const QString &  UniqueStr  )  [virtual]

Retrieves an event on the basis of the unique string ID.

Implements KCal::ResourceCalendar.

Definition at line 167 of file resourcecached.cpp.

Event::List KCal::ResourceCached::events (  ) 

Return filtered list of all events in calendar.

Event::List ResourceCached::rawEvents ( EventSortField  sortField = EventSortUnsorted,
SortDirection  sortDirection = SortDirectionAscending 
) [virtual]

Return unfiltered list of all events in calendar.

Implements KCal::ResourceCalendar.

Definition at line 192 of file resourcecached.cpp.

Event::List ResourceCached::rawEventsForDate ( const QDate &  date,
EventSortField  sortField = EventSortUnsorted,
SortDirection  sortDirection = SortDirectionAscending 
) [virtual]

Builds and then returns a list of all events that match for the date specified.

useful for dayView, etc. etc.

Implements KCal::ResourceCalendar.

Definition at line 172 of file resourcecached.cpp.

Event::List ResourceCached::rawEventsForDate ( const QDateTime &  qdt  )  [virtual]

Get unfiltered events for date qdt.

Implements KCal::ResourceCalendar.

Definition at line 187 of file resourcecached.cpp.

Event::List ResourceCached::rawEvents ( const QDate &  start,
const QDate &  end,
bool  inclusive = false 
) [virtual]

Get unfiltered events in a range of dates.

If inclusive is set to true, only events are returned, which are completely included in the range.

Implements KCal::ResourceCalendar.

Definition at line 181 of file resourcecached.cpp.

bool ResourceCached::addTodo ( Todo todo  )  [virtual]

Add a todo to the todolist.

Implements KCal::ResourceCalendar.

Definition at line 197 of file resourcecached.cpp.

bool ResourceCached::deleteTodo ( Todo todo  )  [virtual]

Remove a todo from the todolist.

Implements KCal::ResourceCalendar.

Definition at line 202 of file resourcecached.cpp.

Todo * ResourceCached::todo ( const QString &  uid  )  [virtual]

Searches todolist for an event with this unique string identifier, returns a pointer or null.

Implements KCal::ResourceCalendar.

Definition at line 218 of file resourcecached.cpp.

Todo::List ResourceCached::rawTodos ( TodoSortField  sortField = TodoSortUnsorted,
SortDirection  sortDirection = SortDirectionAscending 
) [virtual]

Return list of all todos.

Implements KCal::ResourceCalendar.

Definition at line 213 of file resourcecached.cpp.

Todo::List ResourceCached::rawTodosForDate ( const QDate &  date  )  [virtual]

Returns list of todos due on the specified date.

Implements KCal::ResourceCalendar.

Definition at line 223 of file resourcecached.cpp.

bool ResourceCached::addJournal ( Journal journal  )  [virtual]

Add a Journal entry to calendar.

Implements KCal::ResourceCalendar.

Definition at line 229 of file resourcecached.cpp.

bool ResourceCached::deleteJournal ( Journal journal  )  [virtual]

Remove a Journal from the calendar.

Implements KCal::ResourceCalendar.

Definition at line 207 of file resourcecached.cpp.

Journal * ResourceCached::journal ( const QString &  uid  )  [virtual]

Return Journal with given unique id.

Implements KCal::ResourceCalendar.

Definition at line 236 of file resourcecached.cpp.

Journal::List ResourceCached::rawJournals ( JournalSortField  sortField = JournalSortUnsorted,
SortDirection  sortDirection = SortDirectionAscending 
) [virtual]

Return list of all journals.

Implements KCal::ResourceCalendar.

Definition at line 241 of file resourcecached.cpp.

Journal::List ResourceCached::rawJournalsForDate ( const QDate &  date  )  [virtual]

Return list of journals for the given date.

Implements KCal::ResourceCalendar.

Definition at line 246 of file resourcecached.cpp.

Alarm::List ResourceCached::alarms ( const QDateTime &  from,
const QDateTime &  to 
) [virtual]

Return all alarms, which ocur in the given time interval.

Implements KCal::ResourceCalendar.

Definition at line 257 of file resourcecached.cpp.

Alarm::List ResourceCached::alarmsTo ( const QDateTime &  to  )  [virtual]

Return all alarms, which ocur before given date.

Implements KCal::ResourceCalendar.

Definition at line 252 of file resourcecached.cpp.

void ResourceCached::setTimeZoneId ( const QString &  timeZoneId  )  [virtual]

Set id of timezone, e.g.

"Europe/Berlin"

Implements KCal::ResourceCalendar.

Definition at line 264 of file resourcecached.cpp.

const Person & KCal::ResourceCached::getOwner (  )  const

Return the owner of the calendar's full name.

Definition at line 656 of file resourcecached.cpp.

void KCal::ResourceCached::setOwner ( const Person owner  ) 

Set the owner of the calendar.

Should be owner's full name.

Definition at line 651 of file resourcecached.cpp.

void ResourceCached::loadCache (  ) 

Loads the cache, this method should be called on load.

Definition at line 281 of file resourcecached.cpp.

void ResourceCached::saveCache (  ) 

Saves the cache back.

Definition at line 298 of file resourcecached.cpp.

void ResourceCached::clearCache (  ) 

Clear cache.

Definition at line 313 of file resourcecached.cpp.

KPIM::IdMapper & ResourceCached::idMapper (  ) 

Returns a reference to the id mapper.

Definition at line 377 of file resourcecached.cpp.

void ResourceCached::calendarIncidenceAdded ( KCal::Incidence  )  [protected, virtual]

Notify the Observer that an Incidence has been inserted.

First parameter is a pointer to the Incidence that was inserted.

Reimplemented from KCal::Calendar::Observer.

Definition at line 444 of file resourcecached.cpp.

void ResourceCached::calendarIncidenceChanged ( KCal::Incidence  )  [protected, virtual]

Notify the Observer that an Incidence has been modified.

First parameter is a pointer to the Incidence that was modified.

Reimplemented from KCal::Calendar::Observer.

Definition at line 460 of file resourcecached.cpp.

void ResourceCached::calendarIncidenceDeleted ( KCal::Incidence  )  [protected, virtual]

Notify the Observer that an Incidence has been removed.

First parameter is a pointer to the Incidence that was removed.

Reimplemented from KCal::Calendar::Observer.

Definition at line 477 of file resourcecached.cpp.

void ResourceCached::doClose (  )  [protected, virtual]

Virtual method from KRES::Resource, called when the last instace of the resource is closed.

Definition at line 640 of file resourcecached.cpp.

bool ResourceCached::doOpen (  )  [protected, virtual]

Opens the resource.

Dummy implementation, so child classes don't have to reimplement this method. By default, this does not do anything, but can be reimplemented in child classes

Definition at line 645 of file resourcecached.cpp.

bool ResourceCached::checkForReload (  )  [protected]

Check if reload required according to reload policy.

Definition at line 613 of file resourcecached.cpp.

bool ResourceCached::checkForSave (  )  [protected]

Check if save required according to save policy.

Definition at line 620 of file resourcecached.cpp.

void ResourceCached::addInfoText ( QString &   )  const [protected, virtual]

Add info text for concrete resources.

Called by infoText().

Reimplemented from KCal::ResourceCalendar.

Definition at line 626 of file resourcecached.cpp.

QString ResourceCached::cacheFile (  )  const [protected, virtual]

This method is used by loadCache() and saveCache(), reimplement it to change the location of the cache.

Definition at line 382 of file resourcecached.cpp.

QString ResourceCached::changesCacheFile ( const QString &  type  )  const [protected, virtual]

Functions for keeping the changes persistent.

Definition at line 387 of file resourcecached.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys