summaryrefslogtreecommitdiff
path: root/telepathy-glib/client.c
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2009-06-09 09:28:11 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2009-06-10 14:37:48 +0100
commit83a5de557c926f1de5d0ffc81f3994b063093673 (patch)
tree621579097884392c23e2aebea8e5cc640eb0b259 /telepathy-glib/client.c
parentf0743304591969845663ebf3ab7ba57fadd5b85e (diff)
downloadtelepathy-glib-83a5de557c926f1de5d0ffc81f3994b063093673.tar.gz
Add basic proxies for Client
Diffstat (limited to 'telepathy-glib/client.c')
-rw-r--r--telepathy-glib/client.c114
1 files changed, 114 insertions, 0 deletions
diff --git a/telepathy-glib/client.c b/telepathy-glib/client.c
new file mode 100644
index 000000000..5927d9189
--- /dev/null
+++ b/telepathy-glib/client.c
@@ -0,0 +1,114 @@
+/*
+ * client.c - proxy for a Telepathy client
+ *
+ * Copyright (C) 2009 Collabora Ltd. <http://www.collabora.co.uk/>
+ * Copyright (C) 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 "telepathy-glib/client.h"
+
+#include <telepathy-glib/dbus.h>
+#include <telepathy-glib/defs.h>
+#include <telepathy-glib/errors.h>
+#include <telepathy-glib/interfaces.h>
+#include <telepathy-glib/proxy-subclass.h>
+
+#define DEBUG_FLAG TP_DEBUG_DISPATCHER
+#include "telepathy-glib/debug-internal.h"
+
+#include "telepathy-glib/_gen/tp-cli-client-body.h"
+
+/**
+ * SECTION:client
+ * @title: TpClient
+ * @short_description: proxy object for a client of the ChannelDispatcher
+ *
+ * Each client to which the ChannelDispatcher can send channels must implement
+ * the Client interface. This object represents such a client, and is mainly
+ * useful in the implementation of the ChannelDispatcher itself.
+ *
+ * Since: 0.7.UNRELEASED
+ */
+
+/**
+ * TpClient:
+ *
+ * Each client to which the ChannelDispatcher can send channels must implement
+ * the Client interface. This object represents such a client, and is mainly
+ * useful in the implementation of the ChannelDispatcher itself.
+ *
+ * This proxy is usable but very incomplete: accessors for D-Bus properties
+ * will be added in a later version of telepathy-glib, along with a mechanism
+ * similar to tp_connection_call_when_ready().
+ *
+ * Many operations performed on a Client are done via D-Bus properties.
+ * Until convenience methods for this are implemented, use of the generic
+ * tp_cli_dbus_properties_call_get_all() and tp_cli_dbus_properties_call_set()
+ * methods is recommended.
+ *
+ * Since: 0.7.UNRELEASED
+ */
+
+/**
+ * TpClientClass:
+ *
+ * The class of a #TpClient.
+ */
+
+struct _TpClientPrivate {
+ gpointer dummy;
+};
+
+G_DEFINE_TYPE (TpClient, tp_client, TP_TYPE_PROXY);
+
+static void
+tp_client_init (TpClient *self)
+{
+ self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, TP_TYPE_CLIENT,
+ TpClientPrivate);
+}
+
+static void
+tp_client_constructed (GObject *object)
+{
+ TpClient *self = TP_CLIENT (object);
+ void (*chain_up) (GObject *) =
+ ((GObjectClass *) tp_client_parent_class)->constructed;
+
+ if (chain_up != NULL)
+ chain_up (object);
+
+ g_return_if_fail (tp_proxy_get_dbus_daemon (self) != NULL);
+}
+
+static void
+tp_client_class_init (TpClientClass *klass)
+{
+ GType tp_type = TP_TYPE_CLIENT;
+ TpProxyClass *proxy_class = (TpProxyClass *) klass;
+ GObjectClass *object_class = (GObjectClass *) klass;
+
+ g_type_class_add_private (klass, sizeof (TpClientPrivate));
+
+ object_class->constructed = tp_client_constructed;
+
+ proxy_class->interface = TP_IFACE_QUARK_CLIENT;
+ tp_proxy_or_subclass_hook_on_interface_add (tp_type,
+ tp_cli_client_add_signals);
+ tp_proxy_subclass_add_error_mapping (tp_type,
+ TP_ERROR_PREFIX, TP_ERRORS, TP_TYPE_ERROR);
+}