CalMetaBackend

---

Object Hierarchy:

Description:

Content:

Properties:

• public CalCache cache { owned get; set; }
  The CalCache being used for this meta backend.

Creation methods:

• protected CalMetaBackend ()

Methods:

• public virtual bool connect_sync (NamedParameters? credentials, out SourceAuthenticationResult out_auth_result, out string out_certificate_pem, out TlsCertificateFlags out_certificate_errors, Cancellable? cancellable = null) throws Error
  This is called always before any operation which requires a connection to the remote side.
• public virtual bool disconnect_sync (Cancellable? cancellable = null) throws Error
  This is called when the backend goes into offline mode or when the disconnect is required.
• public string? dup_sync_tag ()
  Returns the last known synchronization tag, the same as used to call get_changes_sync.
• public bool empty_cache_sync (Cancellable? cancellable = null) throws Error
  Empties the local cache by removing all known components from it and notifies about such removal any opened views.
• public bool ensure_connected_sync (Cancellable? cancellable = null) throws Error
  Ensures that the this is connected to its destination.
• public bool gather_timezones_sync (Component vcalendar, bool remove_existing, Cancellable? cancellable = null) throws Error
  Extracts all VTIMEZONE components from the vcalendar and adds them to the memory cache, thus they are available when needed.
• public unowned string get_capabilities ()
• public virtual bool get_changes_sync (string? last_sync_tag, bool is_repeat, out string out_new_sync_tag, out bool out_repeat, out SList<CalMetaBackendInfo> out_created_objects, out SList<CalMetaBackendInfo> out_modified_objects, out SList<CalMetaBackendInfo> out_removed_objects, Cancellable? cancellable = null) throws Error
  Gathers the changes since the last check which had been done on the remote side.
• public bool get_connected_writable ()
  This value has meaning only if get_ever_connected is true.
• public bool get_ever_connected ()
• public virtual bool get_ssl_error_details (out string out_certificate_pem, out TlsCertificateFlags out_certificate_errors)
  It is optional to implement this virtual method by the descendants.
• public bool inline_local_attachments_sync (Component component, Cancellable? cancellable = null) throws Error
  Changes all URL attachments which point to a local file in component to inline attachments, aka adds the file content into the component.
• public virtual bool list_existing_sync (out string out_new_sync_tag, out SList<CalMetaBackendInfo> out_existing_objects, Cancellable? cancellable = null) throws Error
  Used to get list of all existing objects on the remote side.
• public virtual bool load_component_sync (string uid, string? extra, out Component out_component, out string out_extra, Cancellable? cancellable = null) throws Error
  Loads a component from the remote side.
• public Component merge_instances (SList<Component> instances, bool replace_tzid_with_location)
  Merges all the instances provided in instances list into one VCALENDAR object, which would eventually contain also all the used timezones.
• public bool process_changes_sync (SList<CalMetaBackendInfo>? created_objects, SList<CalMetaBackendInfo>? modified_objects, SList<CalMetaBackendInfo>? removed_objects, Cancellable? cancellable = null) throws Error
  Processes given changes by updating local cache content accordingly.
• public CalCache ref_cache ()
• public bool refresh_sync (Cancellable? cancellable = null) throws Error
  Refreshes the this immediately.
• public virtual bool remove_component_sync (ConflictResolution conflict_resolution, string uid, string? extra, string? object, OperationFlags opflags, Cancellable? cancellable = null) throws Error
  Removes a component from the remote side, with all its detached instances.
• public virtual bool requires_reconnect ()
  Determines, whether current source content requires reconnect of the backend.
• public virtual bool save_component_sync (bool overwrite_existing, ConflictResolution conflict_resolution, SList<Component> instances, string? extra, OperationFlags opflags, out string out_new_uid, out string out_new_extra, Cancellable? cancellable = null) throws Error
  Saves one component into the remote side.
• public void schedule_refresh ()
  Schedules refresh of the content of the this.
• public virtual bool search_components_sync (string? expr, out SList<Component> out_components, Cancellable? cancellable = null) throws Error
  Searches this with given expression expr and returns found components as a SList of Component out_components.
• public virtual bool search_sync (string? expr, out SList<string> out_icalstrings, Cancellable? cancellable = null) throws Error
  Searches this with given expression expr and returns found components as a SList of iCal strings out_icalstrings.
• public void set_cache (CalCache cache)
  Sets the cache as the cache to be used by the this.
• public void set_connected_writable (bool value)
  Sets whether the this connected to a writable destination.
• public void set_ever_connected (bool value)
  Sets whether the this ever made a successful connection to its destination.
• public void set_sync_tag (string? sync_tag)
  Sets the sync_tag for the this .
• public bool split_changes_sync (ref SList<CalMetaBackendInfo> objects, out SList<CalMetaBackendInfo> out_created_objects, out SList<CalMetaBackendInfo> out_modified_objects, out SList<CalMetaBackendInfo>? out_removed_objects, Cancellable? cancellable = null) throws Error
  Splits objects into created/modified/removed lists according to current local cache content.
• public bool store_inline_attachments_sync (Component component, Cancellable? cancellable = null) throws Error
  Changes all inline attachments to URL attachments in component , which will point to a local file instead.

Signals:

• public signal void refresh_completed ()
• public virtual signal void source_changed ()
  This signal is emitted whenever the underlying backend Source changes.

Inherited Members: