Logo Search packages:      
Sourcecode: telepathy-mission-control-5 version File versions  Download package

dbus-api.c

/* vi: set et sw=4 ts=8 cino=t0,(0: */
/* -*- Mode: C; indent-tabs-mode: nil; c-basic-offset: 4; tab-width: 8 -*- */
/*
 * dbus-api.c - Mission Control D-Bus API strings, enums etc.
 *
 * Copyright (C) 2008 Collabora Ltd. <http://www.collabora.co.uk/>
 * Copyright (C) 2008 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
 */

#define MC_INTERNAL
#include "dbus-api.h"
#include "mc-gtypes.h"
#include <string.h>

#include <dbus/dbus-protocol.h>

/* auto-generated stubs */
#include "_gen/gtypes-body.h"
#include "_gen/interfaces-body.h"

#define MC_IFACE_IS_READY(iface_data) (*(iface_data->props_data_ptr) != NULL)

typedef struct _McIfaceStatus McIfaceStatus;

struct _CallWhenReadyContext {
    McIfaceWhenReadyCb callback;
    gpointer user_data;
    GDestroyNotify destroy;
    GObject *weak_object;
    McIfaceStatus *iface_status;
};

struct _McIfaceStatus {
    GQuark iface_quark;
    GSList *contexts;
    GSList *removed_contexts;
    McIfaceCreateProps create_props;
};

inline void
_mc_gvalue_stolen (GValue *value)
{
    GType type;

    /* HACK: clear the GValue so that the contents will not be freed */
    type = G_VALUE_TYPE (value); 
    memset (value, 0, sizeof (GValue)); 
    g_value_init (value, type); 
}

static void
lost_weak_ref (gpointer data, GObject *dead)
{
    CallWhenReadyContext *ctx = data;

    g_assert (ctx->weak_object == dead);
    ctx->weak_object = NULL;
    _mc_iface_cancel_callback (ctx);
}

static void
call_when_ready_context_free (CallWhenReadyContext *ctx)
{
    if (ctx->weak_object)
      g_object_weak_unref (ctx->weak_object, lost_weak_ref, ctx);
    if (ctx->destroy)
      ctx->destroy (ctx->user_data);
    g_slice_free (CallWhenReadyContext, ctx);
}

static void
_mc_iface_status_free (gpointer ptr)
{
    McIfaceStatus *iface_status = ptr;
    GSList *list;

    for (list = iface_status->contexts; list; list = list->next)
    {
      if (g_slist_find (iface_status->removed_contexts, list->data))
          continue;
      call_when_ready_context_free (list->data);
    }
    g_slist_free (iface_status->contexts);
    g_slist_free (iface_status->removed_contexts);
    g_slice_free (McIfaceStatus, iface_status);
}

static void
properties_get_all_cb (TpProxy *proxy, GHashTable *props, 
                   const GError *error, gpointer user_data, 
                   GObject *weak_object) 
{
    McIfaceStatus *iface_status = user_data;
    CallWhenReadyContext *ctx;
    GSList *list;

    if (error == NULL)
      iface_status->create_props (proxy, props);

    iface_status->contexts = g_slist_reverse (iface_status->contexts);
    for (list = iface_status->contexts; list; list = list->next)
    {
      ctx = list->data;
      if (g_slist_find (iface_status->removed_contexts, ctx))
          continue;
      ctx->callback (proxy, error, ctx->user_data, ctx->weak_object);
    }
    g_object_set_qdata ((GObject *)proxy, iface_status->iface_quark, NULL);
}

gboolean
_mc_iface_call_when_ready_int (TpProxy *proxy,
                         McIfaceWhenReadyCb callback,
                         gpointer user_data,
                         McIfaceData *iface_data)
{
    return _mc_iface_call_when_ready_object_int (proxy, callback, user_data,
                                     NULL, NULL, iface_data);
}

gboolean
_mc_iface_call_when_ready_object_int (TpProxy *proxy,
                              McIfaceWhenReadyCb callback,
                              gpointer user_data,
                              GDestroyNotify destroy,
                              GObject *weak_object,
                              McIfaceData *iface_data)
{
    gboolean first_invocation = FALSE;

    g_return_val_if_fail (callback != NULL, FALSE);

    if (MC_IFACE_IS_READY (iface_data) || proxy->invalidated)
    {
      callback (proxy, proxy->invalidated, user_data, weak_object);
      if (destroy)
          destroy (user_data);
    }
    else
    {
      CallWhenReadyContext *ctx = g_slice_new (CallWhenReadyContext);
      GObject *object = (GObject *) proxy;
      McIfaceStatus *iface_status;

      ctx->callback = callback;
      ctx->user_data = user_data;
      ctx->destroy = destroy;
      ctx->weak_object = weak_object;
      if (weak_object != NULL)
          g_object_weak_ref (weak_object, lost_weak_ref, ctx);


      iface_status = g_object_get_qdata (object, iface_data->id);
      if (!iface_status)
      {
          /* it's the first time we are interested in this interface:
           * setup the struct and call the GetAll method */
          iface_status = g_slice_new (McIfaceStatus);
          iface_status->contexts = NULL;
          iface_status->removed_contexts = NULL;
          iface_status->iface_quark = iface_data->id;
          iface_status->create_props = iface_data->create_props;
          g_object_set_qdata_full (object, iface_data->id,
                             iface_status, _mc_iface_status_free);

          const gchar *name = g_quark_to_string (iface_data->id);
          tp_cli_dbus_properties_call_get_all (proxy, -1, name, 
                                     properties_get_all_cb, 
                                     iface_status,
                                     NULL,
                                     NULL);
          first_invocation = TRUE;
      }

      ctx->iface_status = iface_status;
      iface_status->contexts = g_slist_prepend (iface_status->contexts, ctx);
    }

    return first_invocation;
}

void
_mc_iface_cancel_callback (CallWhenReadyContext *ctx)
{
    if (G_UNLIKELY (ctx == NULL)) return;

    ctx->iface_status->removed_contexts =
            g_slist_prepend (ctx->iface_status->removed_contexts, ctx);
    call_when_ready_context_free (ctx);
}

gboolean
_mc_iface_is_ready (gpointer object, GQuark iface)
{
    /* The interface is ready when the struct has been deleted */
    return g_object_get_qdata (object, iface) ? FALSE : TRUE;
}

void
_mc_iface_add (GType type, GQuark interface,
             McIfaceDescription *iface_description)
{
    g_type_set_qdata (type, interface, iface_description);
}

void
_mc_iface_call_when_ready (TpProxy *proxy, GType type, GQuark interface,
                     McIfaceWhenReadyCb callback,
                     gpointer user_data, GDestroyNotify destroy,
                     GObject *weak_object)
{
    McIfaceDescription *desc;
    McIfaceData iface_data;
    gpointer private;
    
    desc = g_type_get_qdata (type, interface);
    if (G_UNLIKELY (!desc))
    {
      g_warning ("Type %s has not a McIfaceDescription for interface %s",
               g_type_name (type), g_quark_to_string (interface));
      return;
    }

    private = g_type_instance_get_private ((GTypeInstance *)proxy, type);
    g_assert (private != NULL);
    iface_data.id = interface;
    iface_data.props_data_ptr =
            G_STRUCT_MEMBER_P (private, desc->props_data_offset);
    iface_data.create_props = desc->create_props;

    if (_mc_iface_call_when_ready_object_int (proxy, callback, user_data,
                                    destroy, weak_object,
                                    &iface_data))
    {
      if (desc->setup_props_monitor)
          desc->setup_props_monitor (proxy, interface);
    }
}

typedef struct _MultiCbData {
    McIfaceWhenReadyCb callback;
    gpointer user_data;
    GDestroyNotify destroy;
    gint remaining_ifaces;
    gint ref_count;
    GError *error;
} MultiCbData;

static void
multi_cb_data_free (gpointer ptr)
{
    MultiCbData *mcbd = ptr;

    mcbd->ref_count--;
    g_assert (mcbd->ref_count >= 0);
    if (mcbd->ref_count == 0)
    {
      if (mcbd->destroy)
          mcbd->destroy (mcbd->user_data);
      if (mcbd->error)
          g_error_free (mcbd->error);
      g_slice_free (MultiCbData, mcbd);
    }
}

static void
call_when_all_ready_cb (TpProxy *proxy, const GError *error,
                  gpointer user_data, GObject *weak_object)
{
    MultiCbData *mcbd = user_data;

    if (error)
    {
      if (mcbd->error == NULL)
          mcbd->error = g_error_copy (error);
    }
    mcbd->remaining_ifaces--;
    g_assert (mcbd->remaining_ifaces >= 0);
    if (mcbd->remaining_ifaces == 0)
    {
      if (mcbd->callback)
          mcbd->callback (proxy, mcbd->error, mcbd->user_data, weak_object);
    }
}

void
_mc_iface_call_when_all_readyv (TpProxy *proxy, GType type,
                        McIfaceWhenReadyCb callback,
                        gpointer user_data, GDestroyNotify destroy,
                        GObject *weak_object,
                        guint n_ifaces, GQuark *ifaces)
{
    GQuark iface;
    MultiCbData *mcbd;
    guint i;

    mcbd = g_slice_new0 (MultiCbData);
    mcbd->callback = callback;
    mcbd->user_data = user_data;
    mcbd->destroy = destroy;
    mcbd->ref_count = 1;
    mcbd->remaining_ifaces = 1; /* lock released at the end of this function */

    for (i = 0; i < n_ifaces; i++)
    {
      iface = ifaces[i];
      mcbd->remaining_ifaces++;
      mcbd->ref_count++;
      _mc_iface_call_when_ready (proxy, type, iface,
                           call_when_all_ready_cb,
                           mcbd, multi_cb_data_free, weak_object);
    }

    /* release the initial lock set to remaining_ifaces */
    call_when_all_ready_cb (proxy, NULL, mcbd, weak_object);

    multi_cb_data_free (mcbd);
}

GType
_mc_gtype_from_dbus_signature (const gchar *signature)
{
    if (G_UNLIKELY (!signature)) return G_TYPE_INVALID;

    /* dbus-glib's functions that create the GTypes are implemented using a
     * lookup table, so that if the sub-component types are the same, the same
     * GType is returned.
     * So here it should be safe to use any of the functions that return the
     * desired type */
    if (strcmp (signature, "s") == 0)
        return G_TYPE_STRING;
    if (strcmp (signature, "b") == 0)
        return G_TYPE_BOOLEAN;
    if (strcmp (signature, "u") == 0)
        return G_TYPE_UINT;
    if (strcmp (signature, "o") == 0)
        return DBUS_TYPE_G_OBJECT_PATH;
    if (strcmp (signature, "as") == 0)
        return G_TYPE_STRV;
    if (strcmp (signature, "a{sv}") == 0)
        return TP_HASH_TYPE_STRING_VARIANT_MAP;
    if (strcmp (signature, "(uss)") == 0)
        return TP_STRUCT_TYPE_SIMPLE_PRESENCE;
    if (strcmp (signature, "a(oa{sv})") == 0)
        return MC_ARRAY_TYPE_CHANNEL_DETAILS_LIST;
    if (strcmp (signature, "a{su}") == 0)
        return MC_HASH_TYPE_CHANNEL_COUNT_MAP;
    g_warning ("%s: Type %s not mapped", G_STRFUNC, signature);
    return G_TYPE_INVALID;
}

void
_mc_iface_update_props (const McIfaceProperty *props_definition,
                        GHashTable *properties, gpointer proxy_props)
{
    const McIfaceProperty *prop;

    for (prop = props_definition; prop->name != NULL; prop++)
    {
        GValue *value;
        GType type;

        value = g_hash_table_lookup (properties, prop->name);

        if (!value) continue;

        type = _mc_gtype_from_dbus_signature (prop->dbus_signature);

        if (G_LIKELY (G_VALUE_HOLDS (value, type)))
        {
            prop->update_property (prop->name, value, proxy_props);
        }
        else
        {
            g_warning ("%s: %s is a %s, expecting %s",
                       G_STRFUNC, prop->name,
                       G_VALUE_TYPE_NAME (value), g_type_name (type));
        }
    }
}


Generated by  Doxygen 1.6.0   Back to index