[telepathy-gabble/master] Add a GObject interface for sidecar implementations

[Will Thompson]

---
 src/Makefile.am |    2 +
 src/sidecar.c   |   75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 src/sidecar.h   |   59 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 136 insertions(+), 0 deletions(-)
 create mode 100644 src/sidecar.c
 create mode 100644 src/sidecar.h

diff --git a/src/Makefile.am b/src/Makefile.am
index d315079..4178c72 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -128,6 +128,8 @@ libgabble_convenience_la_SOURCES = \
     search-channel.c \
     search-manager.h \
     search-manager.c \
+    sidecar.h \
+    sidecar.c \
     tube-iface.h \
     tube-iface.c \
     tubes-channel.h \
diff --git a/src/sidecar.c b/src/sidecar.c
new file mode 100644
index 0000000..dcdb325
--- /dev/null
+++ b/src/sidecar.c
@@ -0,0 +1,75 @@
+/*
+ * sidecar.c — interface for connection sidecars
+ * Copyright © 2009 Collabora Ltd.
+ * Copyright © 2009 Nokia Corporation
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#include "sidecar.h"
+
+GType
+gabble_sidecar_get_type (void)
+{
+  static GType type = 0;
+
+  if (type == 0) {
+    static const GTypeInfo info = {
+      sizeof (GabbleSidecarInterface),
+      NULL,   /* base_init */
+      NULL,   /* base_finalize */
+      NULL,   /* class_init */
+      NULL,   /* class_finalize */
+      NULL,   /* class_data */
+      0,
+      0,      /* n_preallocs */
+      NULL    /* instance_init */
+    };
+
+    type = g_type_register_static (G_TYPE_INTERFACE, "GabbleSidecar", &info, 0);
+  }
+
+  return type;
+}
+
+const gchar *
+gabble_sidecar_get_interface (GabbleSidecar *sidecar)
+{
+  GabbleSidecarInterface *iface = GABBLE_SIDECAR_GET_INTERFACE (sidecar);
+
+  return iface->interface;
+}
+
+/**
+ * gabble_sidecar_get_immutable_properties:
+ * @sidecar: a sidecar object
+ *
+ * Retrieves the immutable properties for a sidecar, as a map from
+ * fully-qualified property names to GValues containing the properties' values
+ * (such as that created with tp_asv_new ()).
+ *
+ * Returns: a non-%NULL hash of @sidecar's immutable properties, which must be
+ *          unreffed but not modified by the caller.
+ */
+GHashTable *
+gabble_sidecar_get_immutable_properties (GabbleSidecar *sidecar)
+{
+  GabbleSidecarInterface *iface = GABBLE_SIDECAR_GET_INTERFACE (sidecar);
+
+  if (iface->get_immutable_properties)
+    return iface->get_immutable_properties (sidecar);
+  else
+    return g_hash_table_new (NULL, NULL);
+}
diff --git a/src/sidecar.h b/src/sidecar.h
new file mode 100644
index 0000000..531a7f9
--- /dev/null
+++ b/src/sidecar.h
@@ -0,0 +1,59 @@
+/*
+ * sidecar.h — interface for connection sidecars
+ * Copyright © 2009 Collabora Ltd.
+ * Copyright © 2009 Nokia Corporation
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+#ifndef __SIDECAR_H__
+#define __SIDECAR_H__
+
+#include <glib-object.h>
+
+#define GABBLE_TYPE_SIDECAR (gabble_sidecar_get_type ())
+#define GABBLE_SIDECAR(obj) \
+    (G_TYPE_CHECK_INSTANCE_CAST ((obj), GABBLE_TYPE_SIDECAR, GabbleSidecar))
+#define GABBLE_IS_SIDECAR(obj) \
+    (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GABBLE_TYPE_SIDECAR))
+#define GABBLE_SIDECAR_GET_INTERFACE(obj) \
+    (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GABBLE_TYPE_SIDECAR, \
+        GabbleSidecarInterface))
+
+typedef struct _GabbleSidecar GabbleSidecar;
+typedef struct _GabbleSidecarInterface GabbleSidecarInterface;
+
+typedef GHashTable * (*GabbleSidecarGetImmutablePropertiesImpl) (
+    GabbleSidecar *);
+
+struct _GabbleSidecarInterface {
+    GTypeInterface parent;
+
+    /**
+     * The D-Bus interface implemented by this sidecar.
+     */
+    const gchar *interface;
+
+    /**
+     * An implementation of gabble_sidecar_get_immutable_properties().
+     */
+    GabbleSidecarGetImmutablePropertiesImpl get_immutable_properties;
+};
+
+GType gabble_sidecar_get_type (void);
+
+const gchar *gabble_sidecar_get_interface (GabbleSidecar *sidecar);
+GHashTable *gabble_sidecar_get_immutable_properties (GabbleSidecar *sidecar);
+
+#endif
-- 
1.5.6.5