EBookBackend: Add a "writable" boolean property.

diff --git a/addressbook/libedata-book/e-book-backend.c b/addressbook/libedata-book/e-book-backend.c
index 8272bb5..3fda287 100644 (file)
--- a/addressbook/libedata-book/e-book-backend.c
+++ b/addressbook/libedata-book/e-book-backend.c
@@ -26,7 +26,8 @@ struct _EBookBackendPrivate {
        GMutex clients_mutex;
        GList *clients;
 
-       gboolean opening, opened, readonly, removed, online;
+       gboolean opening, opened, removed, online;
+       gboolean writable;
 
        GMutex views_mutex;
        GList *views;
@@ -38,7 +39,8 @@ struct _EBookBackendPrivate {
 enum {
        PROP_0,
        PROP_CACHE_DIR,
-       PROP_REGISTRY
+       PROP_REGISTRY,
+       PROP_WRITABLE
 };
 
 G_DEFINE_TYPE (EBookBackend, e_book_backend, E_TYPE_BACKEND)
@@ -134,6 +136,12 @@ book_backend_set_property (GObject *object,
                                E_BOOK_BACKEND (object),
                                g_value_get_object (value));
                        return;
+
+               case PROP_WRITABLE:
+                       e_book_backend_set_writable (
+                               E_BOOK_BACKEND (object),
+                               g_value_get_boolean (value));
+                       return;
        }
 
        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
@@ -157,6 +165,12 @@ book_backend_get_property (GObject *object,
                                value, e_book_backend_get_registry (
                                E_BOOK_BACKEND (object)));
                        return;
+
+               case PROP_WRITABLE:
+                       g_value_set_boolean (
+                               value, e_book_backend_get_writable (
+                               E_BOOK_BACKEND (object)));
+                       return;
        }
 
        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
@@ -289,6 +303,17 @@ e_book_backend_class_init (EBookBackendClass *class)
                        G_PARAM_READWRITE |
                        G_PARAM_CONSTRUCT_ONLY |
                        G_PARAM_STATIC_STRINGS));
+
+       g_object_class_install_property (
+               object_class,
+               PROP_WRITABLE,
+               g_param_spec_boolean (
+                       "writable",
+                       "Writable",
+                       "Whether the backend will accept changes",
+                       FALSE,
+                       G_PARAM_READWRITE |
+                       G_PARAM_STATIC_STRINGS));
 }
 
 static void
@@ -369,6 +394,47 @@ e_book_backend_get_registry (EBookBackend *backend)
 }
 
 /**
+ * e_book_backend_get_writable:
+ * @backend: an #EBookBackend
+ *
+ * Returns whether @backend will accept changes to its data content.
+ *
+ * Returns: whether @backend is writable
+ *
+ * Since: 3.8
+ **/
+gboolean
+e_book_backend_get_writable (EBookBackend *backend)
+{
+       g_return_val_if_fail (E_IS_BOOK_BACKEND (backend), FALSE);
+
+       return backend->priv->writable;
+}
+
+/**
+ * e_book_backend_set_writable:
+ * @backend: an #EBookBackend
+ * @writable: whether @backend is writable
+ *
+ * Sets whether @backend will accept changes to its data content.
+ *
+ * Since: 3.8
+ **/
+void
+e_book_backend_set_writable (EBookBackend *backend,
+                             gboolean writable)
+{
+       g_return_if_fail (E_IS_BOOK_BACKEND (backend));
+
+       if (writable == backend->priv->writable)
+               return;
+
+       backend->priv->writable = writable;
+
+       g_object_notify (G_OBJECT (backend), "writable");
+}
+
+/**
  * e_book_backend_open:
  * @backend: an #EBookBackend
  * @book: an #EDataBook
@@ -439,9 +505,13 @@ e_book_backend_open (EBookBackend *backend,
        g_mutex_lock (&backend->priv->clients_mutex);
 
        if (e_book_backend_is_opened (backend)) {
+               gboolean writable;
+
                g_mutex_unlock (&backend->priv->clients_mutex);
 
-               e_data_book_report_readonly (book, backend->priv->readonly);
+               writable = e_book_backend_get_writable (backend);
+
+               e_data_book_report_readonly (book, !writable);
                e_data_book_report_online (book, backend->priv->online);
 
                e_book_backend_respond_opened (backend, book, opid, NULL);
@@ -1021,7 +1091,7 @@ e_book_backend_is_opening (EBookBackend *backend)
  *
  * Checks if we can write to @backend.
  *
- * Returns: %TRUE if writeable, %FALSE if not.
+ * Returns: %TRUE if read-only, %FALSE if not.
  *
  * Since: 3.2
  **/
@@ -1030,7 +1100,7 @@ e_book_backend_is_readonly (EBookBackend *backend)
 {
        g_return_val_if_fail (E_IS_BOOK_BACKEND (backend), FALSE);
 
-       return backend->priv->readonly;
+       return !e_book_backend_get_writable (backend);
 }
 
 /**
@@ -1217,7 +1287,7 @@ e_book_backend_notify_readonly (EBookBackend *backend,
        GList *clients;
 
        priv = backend->priv;
-       priv->readonly = is_readonly;
+       e_book_backend_set_writable (backend, !is_readonly);
        g_mutex_lock (&priv->clients_mutex);
 
        for (clients = priv->clients; clients != NULL; clients = g_list_next (clients))

diff --git a/addressbook/libedata-book/e-book-backend.h b/addressbook/libedata-book/e-book-backend.h
index cafa765..2b60d72 100644 (file)
--- a/addressbook/libedata-book/e-book-backend.h
+++ b/addressbook/libedata-book/e-book-backend.h
@@ -222,6 +222,9 @@ void                e_book_backend_set_cache_dir    (EBookBackend *backend,
                                                 const gchar *cache_dir);
 ESourceRegistry *
                e_book_backend_get_registry     (EBookBackend *backend);
+gboolean       e_book_backend_get_writable     (EBookBackend *backend);
+void           e_book_backend_set_writable     (EBookBackend *backend,
+                                                gboolean writable);
 
 gboolean       e_book_backend_add_client       (EBookBackend *backend,
                                                 EDataBook *book);

diff --git a/docs/reference/addressbook/libedata-book/libedata-book-sections.txt b/docs/reference/addressbook/libedata-book/libedata-book-sections.txt
index 261c668..b1493bd 100644 (file)
--- a/docs/reference/addressbook/libedata-book/libedata-book-sections.txt
+++ b/docs/reference/addressbook/libedata-book/libedata-book-sections.txt
@@ -14,6 +14,8 @@ BOOK_BACKEND_PROPERTY_REVISION
 e_book_backend_get_cache_dir
 e_book_backend_set_cache_dir
 e_book_backend_get_registry
+e_book_backend_get_writable
+e_book_backend_set_writable
 e_book_backend_add_client
 e_book_backend_remove_client
 e_book_backend_is_opened