libempathy/empathy-individual-manager.c

   1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
   2 /*
   3  * Copyright (C) 2007-2010 Collabora Ltd.
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2.1 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  18  *
  19  * Authors: Xavier Claessens <xclaesse@gmail.com>
  20  *          Travis Reitter <travis.reitter@collabora.co.uk>
  21  */
  22
  23 #include <config.h>
  24
  25 #include <string.h>
  26
  27 #include <telepathy-glib/account-manager.h>
  28 #include <telepathy-glib/enums.h>
  29 #include <telepathy-glib/proxy-subclass.h>
  30 #include <telepathy-glib/util.h>
  31
  32 #include <folks/folks.h>
  33
  34 #include <extensions/extensions.h>
  35
  36 #include "empathy-individual-manager.h"
  37 #include "empathy-contact-manager.h"
  38 #include "empathy-contact-list.h"
  39 #include "empathy-marshal.h"
  40 #include "empathy-utils.h"
  41
  42 #define DEBUG_FLAG EMPATHY_DEBUG_CONTACT
  43 #include "empathy-debug.h"
  44
  45 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyIndividualManager)
  46
  47 /* This class doesn't store or ref any of the individuals, since they're already
  48  * stored and referenced in the aggregator.
  49  *
  50  * This class merely forwards along signals from the aggregator and individuals
  51  * and wraps aggregator functions for other client code. */
  52 typedef struct
  53 {
  54   FolksIndividualAggregator *aggregator;
  55   EmpathyContactManager *contact_manager;
  56 } EmpathyIndividualManagerPriv;
  57
  58 enum
  59 {
  60   FAVOURITES_CHANGED,
  61   GROUPS_CHANGED,
  62   MEMBERS_CHANGED,
  63   LAST_SIGNAL
  64 };
  65
  66 static guint signals[LAST_SIGNAL] = { 0 };
  67
  68 G_DEFINE_TYPE (EmpathyIndividualManager, empathy_individual_manager,
  69     G_TYPE_OBJECT);
  70
  71 static EmpathyIndividualManager *manager_singleton = NULL;
  72
  73 static void
  74 individual_group_changed_cb (FolksIndividual *individual,
  75     gchar *group,
  76     gboolean is_member,
  77     EmpathyIndividualManager *self)
  78 {
  79   g_signal_emit (self, signals[GROUPS_CHANGED], 0, individual, group,
  80       is_member);
  81 }
  82
  83 static void
  84 individual_notify_is_favourite_cb (FolksIndividual *individual,
  85     GParamSpec *pspec,
  86     EmpathyIndividualManager *self)
  87 {
  88   gboolean is_favourite = folks_favourite_get_is_favourite (
  89       FOLKS_FAVOURITE (individual));
  90   g_signal_emit (self, signals[FAVOURITES_CHANGED], 0, individual,
  91       is_favourite);
  92 }
  93
  94 static void
  95 aggregator_individuals_changed_cb (FolksIndividualAggregator *aggregator,
  96     GList *added,
  97     GList *removed,
  98     const char *message,
  99     FolksPersona *actor,
 100     guint reason,
 101     EmpathyIndividualManager *self)
 102 {
 103   GList *l;
 104
 105   for (l = added; l; l = l->next)
 106     {
 107       g_signal_connect (l->data, "group-changed",
 108           G_CALLBACK (individual_group_changed_cb), self);
 109       g_signal_connect (l->data, "notify::is-favourite",
 110           G_CALLBACK (individual_notify_is_favourite_cb), self);
 111     }
 112
 113   for (l = removed; l; l = l->next)
 114     {
 115       g_signal_handlers_disconnect_by_func (l->data,
 116           individual_group_changed_cb, self);
 117       g_signal_handlers_disconnect_by_func (l->data,
 118           individual_notify_is_favourite_cb, self);
 119     }
 120
 121   g_signal_emit (self, signals[MEMBERS_CHANGED], 0, message,
 122       added, removed,
 123       tp_chanel_group_change_reason_from_folks_groups_change_reason (reason),
 124       TRUE);
 125 }
 126
 127 static void
 128 individual_manager_dispose (GObject *object)
 129 {
 130   EmpathyIndividualManagerPriv *priv = GET_PRIV (object);
 131
 132   tp_clear_object (&priv->contact_manager);
 133   tp_clear_object (&priv->aggregator);
 134
 135   G_OBJECT_CLASS (empathy_individual_manager_parent_class)->dispose (object);
 136 }
 137
 138 static GObject *
 139 individual_manager_constructor (GType type,
 140     guint n_props,
 141     GObjectConstructParam *props)
 142 {
 143   GObject *retval;
 144
 145   if (manager_singleton)
 146     {
 147       retval = g_object_ref (manager_singleton);
 148     }
 149   else
 150     {
 151       retval =
 152           G_OBJECT_CLASS (empathy_individual_manager_parent_class)->
 153           constructor (type, n_props, props);
 154
 155       manager_singleton = EMPATHY_INDIVIDUAL_MANAGER (retval);
 156       g_object_add_weak_pointer (retval, (gpointer) & manager_singleton);
 157     }
 158
 159   return retval;
 160 }
 161
 162 /**
 163  * empathy_individual_manager_initialized:
 164  *
 165  * Reports whether or not the singleton has already been created.
 166  *
 167  * There can be instances where you want to access the #EmpathyIndividualManager
 168  * only if it has been set up for this process.
 169  *
 170  * Returns: %TRUE if the #EmpathyIndividualManager singleton has previously
 171  * been initialized.
 172  */
 173 gboolean
 174 empathy_individual_manager_initialized (void)
 175 {
 176   return (manager_singleton != NULL);
 177 }
 178
 179 static void
 180 empathy_individual_manager_class_init (EmpathyIndividualManagerClass *klass)
 181 {
 182   GObjectClass *object_class = G_OBJECT_CLASS (klass);
 183
 184   object_class->dispose = individual_manager_dispose;
 185   object_class->constructor = individual_manager_constructor;
 186
 187   signals[GROUPS_CHANGED] =
 188       g_signal_new ("groups-changed",
 189           G_TYPE_FROM_CLASS (klass),
 190           G_SIGNAL_RUN_LAST,
 191           0,
 192           NULL, NULL,
 193           _empathy_marshal_VOID__OBJECT_STRING_BOOLEAN,
 194           G_TYPE_NONE, 3, FOLKS_TYPE_INDIVIDUAL, G_TYPE_STRING, G_TYPE_BOOLEAN);
 195
 196   signals[FAVOURITES_CHANGED] =
 197       g_signal_new ("favourites-changed",
 198           G_TYPE_FROM_CLASS (klass),
 199           G_SIGNAL_RUN_LAST,
 200           0,
 201           NULL, NULL,
 202           _empathy_marshal_VOID__OBJECT_BOOLEAN,
 203           G_TYPE_NONE, 2, FOLKS_TYPE_INDIVIDUAL, G_TYPE_BOOLEAN);
 204
 205   signals[MEMBERS_CHANGED] =
 206       g_signal_new ("members-changed",
 207           G_TYPE_FROM_CLASS (klass),
 208           G_SIGNAL_RUN_LAST,
 209           0,
 210           NULL, NULL,
 211           _empathy_marshal_VOID__STRING_OBJECT_OBJECT_UINT,
 212           G_TYPE_NONE,
 213           4, G_TYPE_STRING, G_TYPE_POINTER, G_TYPE_POINTER, G_TYPE_UINT);
 214
 215   g_type_class_add_private (object_class,
 216       sizeof (EmpathyIndividualManagerPriv));
 217 }
 218
 219 static void
 220 empathy_individual_manager_init (EmpathyIndividualManager *self)
 221 {
 222   EmpathyIndividualManagerPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
 223       EMPATHY_TYPE_INDIVIDUAL_MANAGER, EmpathyIndividualManagerPriv);
 224
 225   self->priv = priv;
 226   priv->contact_manager = empathy_contact_manager_dup_singleton ();
 227
 228   priv->aggregator = folks_individual_aggregator_new ();
 229   g_signal_connect (priv->aggregator, "individuals-changed",
 230       G_CALLBACK (aggregator_individuals_changed_cb), self);
 231   folks_individual_aggregator_prepare (priv->aggregator, NULL, NULL);
 232 }
 233
 234 EmpathyIndividualManager *
 235 empathy_individual_manager_dup_singleton (void)
 236 {
 237   return g_object_new (EMPATHY_TYPE_INDIVIDUAL_MANAGER, NULL);
 238 }
 239
 240 GList *
 241 empathy_individual_manager_get_members (EmpathyIndividualManager *self)
 242 {
 243   EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
 244   GHashTable *individuals;
 245
 246   g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self), NULL);
 247
 248   individuals = folks_individual_aggregator_get_individuals (priv->aggregator);
 249   return individuals ? g_hash_table_get_values (individuals) : NULL;
 250 }
 251
 252 FolksIndividual *
 253 empathy_individual_manager_lookup_member (EmpathyIndividualManager *self,
 254     const gchar *id)
 255 {
 256   EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
 257   GHashTable *individuals;
 258
 259   g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self), NULL);
 260
 261   individuals = folks_individual_aggregator_get_individuals (priv->aggregator);
 262   if (individuals != NULL)
 263     return g_hash_table_lookup (individuals, id);
 264
 265   return NULL;
 266 }
 267
 268 static void
 269 aggregator_add_persona_from_details_cb (GObject *source,
 270     GAsyncResult *result,
 271     gpointer user_data)
 272 {
 273   FolksIndividualAggregator *aggregator = FOLKS_INDIVIDUAL_AGGREGATOR (source);
 274   EmpathyContact *contact = EMPATHY_CONTACT (user_data);
 275   FolksPersona *persona;
 276   GError *error = NULL;
 277
 278   persona = folks_individual_aggregator_add_persona_from_details_finish (
 279       aggregator, result, &error);
 280   if (error != NULL)
 281     {
 282       g_warning ("failed to add individual from contact: %s", error->message);
 283       g_clear_error (&error);
 284     }
 285
 286   /* Set the contact's persona */
 287   empathy_contact_set_persona (contact, persona);
 288
 289   /* We can unref the contact now */
 290   g_object_unref (contact);
 291   g_object_unref (persona);
 292 }
 293
 294 void
 295 empathy_individual_manager_add_from_contact (EmpathyIndividualManager *self,
 296     EmpathyContact *contact)
 297 {
 298   EmpathyIndividualManagerPriv *priv;
 299   GHashTable* details;
 300   TpAccount *account;
 301   const gchar *store_id;
 302
 303   g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
 304   g_return_if_fail (EMPATHY_IS_CONTACT (contact));
 305
 306   priv = GET_PRIV (self);
 307
 308   /* We need to ref the contact since otherwise its linked TpHandle will be
 309    * destroyed. */
 310   g_object_ref (contact);
 311
 312   DEBUG ("adding individual from contact %s (%s)",
 313       empathy_contact_get_id (contact), empathy_contact_get_alias (contact));
 314
 315   account = empathy_contact_get_account (contact);
 316   store_id = tp_proxy_get_object_path (TP_PROXY (account));
 317
 318   details = tp_asv_new (
 319       "contact", G_TYPE_STRING, empathy_contact_get_id (contact),
 320       NULL);
 321
 322   folks_individual_aggregator_add_persona_from_details (
 323       priv->aggregator, NULL, "telepathy", store_id, details,
 324       aggregator_add_persona_from_details_cb, contact);
 325
 326   g_hash_table_destroy (details);
 327 }
 328
 329 static void
 330 aggregator_remove_individual_cb (GObject *source,
 331     GAsyncResult *result,
 332     gpointer user_data)
 333 {
 334   FolksIndividualAggregator *aggregator = FOLKS_INDIVIDUAL_AGGREGATOR (source);
 335   GError *error = NULL;
 336
 337   folks_individual_aggregator_remove_individual_finish (
 338       aggregator, result, &error);
 339   if (error != NULL)
 340     {
 341       g_warning ("failed to remove individual: %s", error->message);
 342       g_clear_error (&error);
 343     }
 344 }
 345
 346 /**
 347  * Removes the inner contact from the server (and thus the Individual). Not
 348  * meant for de-shelling inner personas from an Individual.
 349  */
 350 void
 351 empathy_individual_manager_remove (EmpathyIndividualManager *self,
 352     FolksIndividual *individual,
 353     const gchar *message)
 354 {
 355   EmpathyIndividualManagerPriv *priv;
 356
 357   g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
 358   g_return_if_fail (FOLKS_IS_INDIVIDUAL (individual));
 359
 360   priv = GET_PRIV (self);
 361
 362   DEBUG ("removing individual %s (%s)",
 363       folks_individual_get_id (individual),
 364       folks_individual_get_alias (individual));
 365
 366   folks_individual_aggregator_remove_individual (priv->aggregator, individual,
 367       aggregator_remove_individual_cb, self);
 368 }
 369
 370 static void
 371 groups_change_group_cb (GObject *source,
 372     GAsyncResult *result,
 373     gpointer user_data)
 374 {
 375   FolksGroups *groups = FOLKS_GROUPS (source);
 376   GError *error = NULL;
 377
 378   folks_groups_change_group_finish (groups, result, &error);
 379   if (error != NULL)
 380     {
 381       g_warning ("failed to change group: %s", error->message);
 382       g_clear_error (&error);
 383     }
 384 }
 385
 386 static void
 387 remove_group_cb (const gchar *id,
 388     FolksIndividual *individual,
 389     const gchar *group)
 390 {
 391   folks_groups_change_group (FOLKS_GROUPS (individual), group, FALSE,
 392       groups_change_group_cb, NULL);
 393 }
 394
 395 void
 396 empathy_individual_manager_remove_group (EmpathyIndividualManager *manager,
 397     const gchar *group)
 398 {
 399   EmpathyIndividualManagerPriv *priv;
 400   GHashTable *individuals;
 401
 402   g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (manager));
 403   g_return_if_fail (group != NULL);
 404
 405   priv = GET_PRIV (manager);
 406
 407   DEBUG ("removing group %s", group);
 408
 409   /* Remove every individual from the group */
 410   individuals = folks_individual_aggregator_get_individuals (priv->aggregator);
 411   g_hash_table_foreach (individuals, (GHFunc) remove_group_cb,
 412       (gpointer) group);
 413 }
 414
 415 EmpathyIndividualManagerFlags
 416 empathy_individual_manager_get_flags_for_connection (
 417     EmpathyIndividualManager *self,
 418     TpConnection *connection)
 419 {
 420   EmpathyIndividualManagerPriv *priv;
 421   EmpathyContactListFlags list_flags;
 422   EmpathyIndividualManagerFlags flags;
 423
 424   g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self),
 425       EMPATHY_INDIVIDUAL_MANAGER_NO_FLAGS);
 426
 427   priv = GET_PRIV (self);
 428
 429   list_flags = empathy_contact_manager_get_flags_for_connection (
 430     priv->contact_manager, connection);
 431
 432   flags = EMPATHY_INDIVIDUAL_MANAGER_NO_FLAGS;
 433   if (list_flags & EMPATHY_CONTACT_LIST_CAN_ADD)
 434     flags |= EMPATHY_INDIVIDUAL_MANAGER_CAN_ADD;
 435   if (list_flags & EMPATHY_CONTACT_LIST_CAN_REMOVE)
 436     flags |= EMPATHY_INDIVIDUAL_MANAGER_CAN_REMOVE;
 437   if (list_flags & EMPATHY_CONTACT_LIST_CAN_ALIAS)
 438     flags |= EMPATHY_INDIVIDUAL_MANAGER_CAN_ALIAS;
 439   if (list_flags & EMPATHY_CONTACT_LIST_CAN_GROUP)
 440     flags |= EMPATHY_INDIVIDUAL_MANAGER_CAN_GROUP;
 441
 442   return flags;
 443 }