ECollectionBackend: Add virual methods to create/delete resources.

diff --git a/docs/reference/libebackend/libebackend-sections.txt b/docs/reference/libebackend/libebackend-sections.txt
index 50b0b12..ce41548 100644 (file)
--- a/docs/reference/libebackend/libebackend-sections.txt
+++ b/docs/reference/libebackend/libebackend-sections.txt
@@ -121,6 +121,12 @@ e_collection_backend_get_cache_dir
 e_collection_backend_list_calendar_sources
 e_collection_backend_list_contacts_sources
 e_collection_backend_list_mail_sources
+e_collection_backend_create_resource_sync
+e_collection_backend_create_resource
+e_collection_backend_create_resource_finish
+e_collection_backend_delete_resource_sync
+e_collection_backend_delete_resource
+e_collection_backend_delete_resource_finish
 <SUBSECTION Standard>
 E_COLLECTION_BACKEND
 E_IS_COLLECTION_BACKEND

diff --git a/libebackend/e-collection-backend.c b/libebackend/e-collection-backend.c
index 8a1cbda..4de423f 100644 (file)
--- a/libebackend/e-collection-backend.c
+++ b/libebackend/e-collection-backend.c
@@ -41,6 +41,9 @@
 
 #include "e-collection-backend.h"
 
+#include <config.h>
+#include <glib/gi18n-lib.h>
+
 #include <libedataserver/libedataserver.h>
 
 #include <libebackend/e-server-side-source.h>
@@ -690,6 +693,124 @@ collection_backend_child_removed (ECollectionBackend *backend,
        collection_backend_children_remove (backend, child_source);
 }
 
+static gboolean
+collection_backend_create_resource_sync (ECollectionBackend *backend,
+                                         ESource *source,
+                                         GCancellable *cancellable,
+                                         GError **error)
+{
+       EAsyncClosure *closure;
+       GAsyncResult *result;
+       gboolean success;
+
+       closure = e_async_closure_new ();
+
+       e_collection_backend_create_resource (
+               backend, source, cancellable,
+               e_async_closure_callback, closure);
+
+       result = e_async_closure_wait (closure);
+
+       success = e_collection_backend_create_resource_finish (
+               backend, result, error);
+
+       e_async_closure_free (closure);
+
+       return success;
+}
+
+static void
+collection_backend_create_resource (ECollectionBackend *backend,
+                                    ESource *source,
+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data)
+{
+       GSimpleAsyncResult *simple;
+
+       simple = g_simple_async_result_new_error (
+               G_OBJECT (backend), callback, user_data,
+               G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
+               _("%s does not support creating remote resources"),
+               G_OBJECT_TYPE_NAME (backend));
+
+       g_simple_async_result_complete_in_idle (simple);
+
+       g_object_unref (simple);
+}
+
+static gboolean
+collection_backend_create_resource_finish (ECollectionBackend *backend,
+                                           GAsyncResult *result,
+                                           GError **error)
+{
+       GSimpleAsyncResult *simple;
+
+       simple = G_SIMPLE_ASYNC_RESULT (result);
+
+       /* Assume success unless a GError is set. */
+       return !g_simple_async_result_propagate_error (simple, error);
+}
+
+static gboolean
+collection_backend_delete_resource_sync (ECollectionBackend *backend,
+                                         ESource *source,
+                                         GCancellable *cancellable,
+                                         GError **error)
+{
+       EAsyncClosure *closure;
+       GAsyncResult *result;
+       gboolean success;
+
+       closure = e_async_closure_new ();
+
+       e_collection_backend_delete_resource (
+               backend, source, cancellable,
+               e_async_closure_callback, closure);
+
+       result = e_async_closure_wait (closure);
+
+       success = e_collection_backend_delete_resource_finish (
+               backend, result, error);
+
+       e_async_closure_free (closure);
+
+       return success;
+}
+
+static void
+collection_backend_delete_resource (ECollectionBackend *backend,
+                                    ESource *source,
+                                    GCancellable *cancellable,
+                                    GAsyncReadyCallback callback,
+                                    gpointer user_data)
+{
+       GSimpleAsyncResult *simple;
+
+       simple = g_simple_async_result_new_error (
+               G_OBJECT (backend), callback, user_data,
+               G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
+               _("%s does not support deleting remote resources"),
+               G_OBJECT_TYPE_NAME (backend));
+
+       g_simple_async_result_complete_in_idle (simple);
+
+       g_object_unref (simple);
+}
+
+static gboolean
+collection_backend_delete_resource_finish (ECollectionBackend *backend,
+                                           GAsyncResult *result,
+                                           GError **error)
+{
+       GSimpleAsyncResult *simple;
+
+       simple = G_SIMPLE_ASYNC_RESULT (result);
+
+       /* Assume success unless a GError is set. */
+       return !g_simple_async_result_propagate_error (simple, error);
+}
+
 static void
 e_collection_backend_class_init (ECollectionBackendClass *class)
 {
@@ -712,6 +833,12 @@ e_collection_backend_class_init (ECollectionBackendClass *class)
        class->dup_resource_id = collection_backend_dup_resource_id;
        class->child_added = collection_backend_child_added;
        class->child_removed = collection_backend_child_removed;
+       class->create_resource_sync = collection_backend_create_resource_sync;
+       class->create_resource = collection_backend_create_resource;
+       class->create_resource_finish = collection_backend_create_resource_finish;
+       class->delete_resource_sync = collection_backend_delete_resource_sync;
+       class->delete_resource = collection_backend_delete_resource;
+       class->delete_resource_finish = collection_backend_delete_resource_finish;
 
        g_object_class_install_property (
                object_class,
@@ -1020,3 +1147,133 @@ e_collection_backend_list_mail_sources (ECollectionBackend *backend)
        return g_list_reverse (result_list);
 }
 
+/**
+ * e_collection_backend_create_resource_sync
+ * @backend: an #ECollectionBackend
+ * @source: an #ESource
+ * @cancellable: optional #GCancellable object, or %NULL
+ * @error: return location for a #GError, or %NULL
+ *
+ * Creates a server-side resource described by @source.  For example, if
+ * @source describes a new calendar, an equivalent calendar is created on
+ * the server.
+ *
+ * It is the implementor's responsibility to examine @source and determine
+ * what the equivalent server-side resource would be.  If this cannot be
+ * determined without ambiguity, the function must return an error.
+ *
+ * After the server-side resource is successfully created, the implementor
+ * must also add an #ESource to @backend's #ECollectionBackend:server.  This
+ * can either be done immediately or in response to some "resource created"
+ * notification from the server.  The added #ESource can be @source itself
+ * or a different #ESource instance that describes the new resource.
+ * implementor's responsibility to add an #ESource to.
+ *
+ * Since: 3.6
+ **/
+gboolean
+e_collection_backend_create_resource_sync (ECollectionBackend *backend,
+                                           ESource *source,
+                                           GCancellable *cancellable,
+                                           GError **error)
+{
+       ECollectionBackendClass *class;
+
+       g_return_val_if_fail (E_IS_COLLECTION_BACKEND (backend), FALSE);
+       g_return_val_if_fail (E_IS_SOURCE (source), FALSE);
+
+       class = E_COLLECTION_BACKEND_GET_CLASS (backend);
+       g_return_val_if_fail (class->create_resource_sync != NULL, FALSE);
+
+       return class->create_resource_sync (
+               backend, source, cancellable, error);
+}
+
+void
+e_collection_backend_create_resource (ECollectionBackend *backend,
+                                      ESource *source,
+                                      GCancellable *cancellable,
+                                      GAsyncReadyCallback callback,
+                                      gpointer user_data)
+{
+       ECollectionBackendClass *class;
+
+       g_return_if_fail (E_IS_COLLECTION_BACKEND (backend));
+       g_return_if_fail (E_IS_SOURCE (source));
+
+       class = E_COLLECTION_BACKEND_GET_CLASS (backend);
+       g_return_if_fail (class->create_resource != NULL);
+
+       class->create_resource (
+               backend, source, cancellable, callback, user_data);
+}
+
+gboolean
+e_collection_backend_create_resource_finish (ECollectionBackend *backend,
+                                             GAsyncResult *result,
+                                             GError **error)
+{
+       ECollectionBackendClass *class;
+
+       g_return_val_if_fail (E_IS_COLLECTION_BACKEND (backend), FALSE);
+       g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
+
+       class = E_COLLECTION_BACKEND_GET_CLASS (backend);
+       g_return_val_if_fail (class->create_resource_finish != NULL, FALSE);
+
+       return class->create_resource_finish (backend, result, error);
+}
+
+gboolean
+e_collection_backend_delete_resource_sync (ECollectionBackend *backend,
+                                           ESource *source,
+                                           GCancellable *cancellable,
+                                           GError **error)
+{
+       ECollectionBackendClass *class;
+
+       g_return_val_if_fail (E_IS_COLLECTION_BACKEND (backend), FALSE);
+       g_return_val_if_fail (E_IS_SOURCE (source), FALSE);
+
+       class = E_COLLECTION_BACKEND_GET_CLASS (backend);
+       g_return_val_if_fail (class->delete_resource_sync != NULL, FALSE);
+
+       return class->delete_resource_sync (
+               backend, source, cancellable, error);
+}
+
+void
+e_collection_backend_delete_resource (ECollectionBackend *backend,
+                                      ESource *source,
+                                      GCancellable *cancellable,
+                                      GAsyncReadyCallback callback,
+                                      gpointer user_data)
+{
+       ECollectionBackendClass *class;
+
+       g_return_if_fail (E_IS_COLLECTION_BACKEND (backend));
+       g_return_if_fail (E_IS_SOURCE (source));
+
+       class = E_COLLECTION_BACKEND_GET_CLASS (backend);
+       g_return_if_fail (class->delete_resource != NULL);
+
+       return class->delete_resource (
+               backend, source, cancellable, callback, user_data);
+}
+
+gboolean
+e_collection_backend_delete_resource_finish (ECollectionBackend *backend,
+                                             GAsyncResult *result,
+                                             GError **error)
+{
+       ECollectionBackendClass *class;
+
+       g_return_val_if_fail (E_IS_COLLECTION_BACKEND (backend), FALSE);
+       g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
+
+       class = E_COLLECTION_BACKEND_GET_CLASS (backend);
+       g_return_val_if_fail (class->delete_resource_finish != NULL, FALSE);
+
+       return class->delete_resource_finish (backend, result, error);
+}
+

diff --git a/libebackend/e-collection-backend.h b/libebackend/e-collection-backend.h
index 3b97922..38b3baf 100644 (file)
--- a/libebackend/e-collection-backend.h
+++ b/libebackend/e-collection-backend.h
@@ -79,7 +79,35 @@ struct _ECollectionBackendClass {
        void            (*child_removed)        (ECollectionBackend *backend,
                                                 ESource *child_source);
 
-       gpointer reserved[16];
+       /* More Methods (grouped separately to preserve the ABI) */
+       gboolean        (*create_resource_sync) (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GError **error);
+       void            (*create_resource)      (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GAsyncReadyCallback callback,
+                                                gpointer user_data);
+       gboolean        (*create_resource_finish)
+                                               (ECollectionBackend *backend,
+                                                GAsyncResult *result,
+                                                GError **error);
+       gboolean        (*delete_resource_sync) (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GError **error);
+       void            (*delete_resource)      (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GAsyncReadyCallback callback,
+                                                gpointer user_data);
+       gboolean        (*delete_resource_finish)
+                                               (ECollectionBackend *backend,
+                                                GAsyncResult *result,
+                                                GError **error);
+
+       gpointer reserved[10];
 };
 
 GType          e_collection_backend_get_type   (void) G_GNUC_CONST;
@@ -95,6 +123,36 @@ GList *             e_collection_backend_list_contacts_sources
                                                (ECollectionBackend *backend);
 GList *                e_collection_backend_list_mail_sources
                                                (ECollectionBackend *backend);
+gboolean       e_collection_backend_create_resource_sync
+                                               (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GError **error);
+void           e_collection_backend_create_resource
+                                               (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GAsyncReadyCallback callback,
+                                                gpointer user_data);
+gboolean       e_collection_backend_create_resource_finish
+                                               (ECollectionBackend *backend,
+                                                GAsyncResult *result,
+                                                GError **error);
+gboolean       e_collection_backend_delete_resource_sync
+                                               (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GError **error);
+void           e_collection_backend_delete_resource
+                                               (ECollectionBackend *backend,
+                                                ESource *source,
+                                                GCancellable *cancellable,
+                                                GAsyncReadyCallback callback,
+                                                gpointer user_data);
+gboolean       e_collection_backend_delete_resource_finish
+                                               (ECollectionBackend *backend,
+                                                GAsyncResult *result,
+                                                GError **error);
 
 G_END_DECLS
 

diff --git a/po/POTFILES.in b/po/POTFILES.in
index f553806..a92554b 100644 (file)
--- a/po/POTFILES.in
+++ b/po/POTFILES.in
@@ -186,6 +186,7 @@ data/org.gnome.evolution-data-server.calendar.gschema.xml.in
 libebackend/e-authentication-mediator.c
 libebackend/e-authentication-session.c
 libebackend/e-backend.c
+libebackend/e-collection-backend.c
 libebackend/e-server-side-source.c
 libebackend/e-source-registry-server.c
 libedataserver/e-categories.c