1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
3 * Copyright (C) 2007-2010 Collabora Ltd.
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.
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.
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
19 * Authors: Xavier Claessens <xclaesse@gmail.com>
20 * Travis Reitter <travis.reitter@collabora.co.uk>
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>
32 #include <folks/folks.h>
33 #include <folks/folks-telepathy.h>
35 #include <extensions/extensions.h>
37 #include "empathy-individual-manager.h"
38 #include "empathy-utils.h"
39 #include "empathy-contact-manager.h"
41 #define DEBUG_FLAG EMPATHY_DEBUG_CONTACT
42 #include "empathy-debug.h"
44 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyIndividualManager)
46 /* This class only stores and refs Individuals who contain an EmpathyContact.
48 * This class merely forwards along signals from the aggregator and individuals
49 * and wraps aggregator functions for other client code. */
52 FolksIndividualAggregator *aggregator;
53 GHashTable *individuals; /* Individual.id -> Individual */
54 } EmpathyIndividualManagerPriv;
64 static guint signals[LAST_SIGNAL] = { 0 };
66 G_DEFINE_TYPE (EmpathyIndividualManager, empathy_individual_manager,
69 static EmpathyIndividualManager *manager_singleton = NULL;
72 individual_group_changed_cb (FolksIndividual *individual,
75 EmpathyIndividualManager *self)
77 g_signal_emit (self, signals[GROUPS_CHANGED], 0, individual, group,
82 individual_notify_is_favourite_cb (FolksIndividual *individual,
84 EmpathyIndividualManager *self)
86 gboolean is_favourite = folks_favourite_details_get_is_favourite (
87 FOLKS_FAVOURITE_DETAILS (individual));
88 g_signal_emit (self, signals[FAVOURITES_CHANGED], 0, individual,
93 add_individual (EmpathyIndividualManager *self, FolksIndividual *individual)
95 EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
97 g_hash_table_insert (priv->individuals,
98 g_strdup (folks_individual_get_id (individual)),
99 g_object_ref (individual));
101 g_signal_connect (individual, "group-changed",
102 G_CALLBACK (individual_group_changed_cb), self);
103 g_signal_connect (individual, "notify::is-favourite",
104 G_CALLBACK (individual_notify_is_favourite_cb), self);
108 remove_individual (EmpathyIndividualManager *self, FolksIndividual *individual)
110 EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
112 g_signal_handlers_disconnect_by_func (individual,
113 individual_group_changed_cb, self);
114 g_signal_handlers_disconnect_by_func (individual,
115 individual_notify_is_favourite_cb, self);
117 g_hash_table_remove (priv->individuals, folks_individual_get_id (individual));
120 /* This is emitted for *all* individuals in the individual aggregator (not
121 * just the ones we keep a reference to), to allow for the case where a new
122 * individual doesn't contain an EmpathyContact, but later has a persona added
125 individual_notify_personas_cb (FolksIndividual *individual,
127 EmpathyIndividualManager *self)
129 EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
131 const gchar *id = folks_individual_get_id (individual);
132 gboolean has_contact = empathy_folks_individual_contains_contact (individual);
133 gboolean had_contact = (g_hash_table_lookup (priv->individuals,
134 id) != NULL) ? TRUE : FALSE;
136 if (had_contact == TRUE && has_contact == FALSE)
138 GList *removed = NULL;
140 /* The Individual has lost its EmpathyContact */
141 removed = g_list_prepend (removed, individual);
142 g_signal_emit (self, signals[MEMBERS_CHANGED], 0, NULL, NULL, removed,
143 TP_CHANNEL_GROUP_CHANGE_REASON_NONE /* FIXME */);
144 g_list_free (removed);
146 remove_individual (self, individual);
148 else if (had_contact == FALSE && has_contact == TRUE)
152 /* The Individual has gained its first EmpathyContact */
153 add_individual (self, individual);
155 added = g_list_prepend (added, individual);
156 g_signal_emit (self, signals[MEMBERS_CHANGED], 0, NULL, added, NULL,
157 TP_CHANNEL_GROUP_CHANGE_REASON_NONE /* FIXME */);
163 aggregator_individuals_changed_cb (FolksIndividualAggregator *aggregator,
164 GeeMultiMap *changes,
165 EmpathyIndividualManager *self)
167 EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
170 GeeCollection *added;
171 GList *added_set = NULL, *added_filtered = NULL, *removed_list = NULL;
173 /* We're not interested in the relationships between the added and removed
174 * individuals, so just extract collections of them. Note that the added
175 * collection may contain duplicates, while the removed set won't. */
176 removed = gee_multi_map_get_keys (changes);
177 added = gee_multi_map_get_values (changes);
179 /* Handle the removals first, as one of the added Individuals might have the
180 * same ID as one of the removed Individuals (due to linking). */
181 iter = gee_iterable_iterator (GEE_ITERABLE (removed));
182 while (gee_iterator_next (iter))
184 FolksIndividual *ind = gee_iterator_get (iter);
189 g_signal_handlers_disconnect_by_func (ind,
190 individual_notify_personas_cb, self);
192 if (g_hash_table_lookup (priv->individuals,
193 folks_individual_get_id (ind)) != NULL)
195 remove_individual (self, ind);
196 removed_list = g_list_prepend (removed_list, ind);
199 g_clear_object (&ind);
201 g_clear_object (&iter);
203 /* Filter the individuals for ones which contain EmpathyContacts */
204 iter = gee_iterable_iterator (GEE_ITERABLE (added));
205 while (gee_iterator_next (iter))
207 FolksIndividual *ind = gee_iterator_get (iter);
209 /* Make sure we handle each added individual only once. */
210 if (ind == NULL || g_list_find (added_set, ind) != NULL)
212 added_set = g_list_prepend (added_set, ind);
214 g_signal_connect (ind, "notify::personas",
215 G_CALLBACK (individual_notify_personas_cb), self);
217 if (empathy_folks_individual_contains_contact (ind) == TRUE)
219 add_individual (self, ind);
220 added_filtered = g_list_prepend (added_filtered, ind);
223 g_clear_object (&ind);
225 g_clear_object (&iter);
227 g_list_free (added_set);
229 g_object_unref (added);
230 g_object_unref (removed);
232 /* Bail if we have no individuals left */
233 if (added_filtered == NULL && removed == NULL)
236 added_filtered = g_list_reverse (added_filtered);
238 g_signal_emit (self, signals[MEMBERS_CHANGED], 0, NULL,
239 added_filtered, removed_list,
240 TP_CHANNEL_GROUP_CHANGE_REASON_NONE,
243 g_list_free (added_filtered);
244 g_list_free (removed_list);
248 individual_manager_dispose (GObject *object)
250 EmpathyIndividualManagerPriv *priv = GET_PRIV (object);
252 g_hash_table_destroy (priv->individuals);
254 g_signal_handlers_disconnect_by_func (priv->aggregator,
255 aggregator_individuals_changed_cb, object);
256 tp_clear_object (&priv->aggregator);
258 G_OBJECT_CLASS (empathy_individual_manager_parent_class)->dispose (object);
262 individual_manager_constructor (GType type,
264 GObjectConstructParam *props)
268 if (manager_singleton)
270 retval = g_object_ref (manager_singleton);
275 G_OBJECT_CLASS (empathy_individual_manager_parent_class)->
276 constructor (type, n_props, props);
278 manager_singleton = EMPATHY_INDIVIDUAL_MANAGER (retval);
279 g_object_add_weak_pointer (retval, (gpointer) & manager_singleton);
286 * empathy_individual_manager_initialized:
288 * Reports whether or not the singleton has already been created.
290 * There can be instances where you want to access the #EmpathyIndividualManager
291 * only if it has been set up for this process.
293 * Returns: %TRUE if the #EmpathyIndividualManager singleton has previously
297 empathy_individual_manager_initialized (void)
299 return (manager_singleton != NULL);
303 empathy_individual_manager_class_init (EmpathyIndividualManagerClass *klass)
305 GObjectClass *object_class = G_OBJECT_CLASS (klass);
307 object_class->dispose = individual_manager_dispose;
308 object_class->constructor = individual_manager_constructor;
310 signals[GROUPS_CHANGED] =
311 g_signal_new ("groups-changed",
312 G_TYPE_FROM_CLASS (klass),
316 g_cclosure_marshal_generic,
317 G_TYPE_NONE, 3, FOLKS_TYPE_INDIVIDUAL, G_TYPE_STRING, G_TYPE_BOOLEAN);
319 signals[FAVOURITES_CHANGED] =
320 g_signal_new ("favourites-changed",
321 G_TYPE_FROM_CLASS (klass),
325 g_cclosure_marshal_generic,
326 G_TYPE_NONE, 2, FOLKS_TYPE_INDIVIDUAL, G_TYPE_BOOLEAN);
328 signals[MEMBERS_CHANGED] =
329 g_signal_new ("members-changed",
330 G_TYPE_FROM_CLASS (klass),
334 g_cclosure_marshal_generic,
336 4, G_TYPE_STRING, G_TYPE_POINTER, G_TYPE_POINTER, G_TYPE_UINT);
338 g_type_class_add_private (object_class,
339 sizeof (EmpathyIndividualManagerPriv));
343 empathy_individual_manager_init (EmpathyIndividualManager *self)
345 EmpathyIndividualManagerPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
346 EMPATHY_TYPE_INDIVIDUAL_MANAGER, EmpathyIndividualManagerPriv);
349 priv->individuals = g_hash_table_new_full (g_str_hash, g_str_equal,
350 g_free, g_object_unref);
352 priv->aggregator = folks_individual_aggregator_new ();
353 g_signal_connect (priv->aggregator, "individuals-changed-detailed",
354 G_CALLBACK (aggregator_individuals_changed_cb), self);
355 folks_individual_aggregator_prepare (priv->aggregator, NULL, NULL);
358 EmpathyIndividualManager *
359 empathy_individual_manager_dup_singleton (void)
361 return g_object_new (EMPATHY_TYPE_INDIVIDUAL_MANAGER, NULL);
365 empathy_individual_manager_get_members (EmpathyIndividualManager *self)
367 EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
369 g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self), NULL);
371 return g_hash_table_get_values (priv->individuals);
375 empathy_individual_manager_lookup_member (EmpathyIndividualManager *self,
378 EmpathyIndividualManagerPriv *priv = GET_PRIV (self);
380 g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self), NULL);
382 return g_hash_table_lookup (priv->individuals, id);
386 aggregator_add_persona_from_details_cb (GObject *source,
387 GAsyncResult *result,
390 FolksIndividualAggregator *aggregator = FOLKS_INDIVIDUAL_AGGREGATOR (source);
391 EmpathyContact *contact = EMPATHY_CONTACT (user_data);
392 FolksPersona *persona;
393 GError *error = NULL;
395 persona = folks_individual_aggregator_add_persona_from_details_finish (
396 aggregator, result, &error);
399 g_warning ("failed to add individual from contact: %s", error->message);
400 g_clear_error (&error);
403 /* The persona can be NULL even if there wasn't an error, if the persona was
404 * already in the contact list */
407 /* Set the contact's persona */
408 empathy_contact_set_persona (contact, persona);
409 g_object_unref (persona);
412 g_object_unref (contact);
416 empathy_individual_manager_add_from_contact (EmpathyIndividualManager *self,
417 EmpathyContact *contact)
419 EmpathyIndividualManagerPriv *priv;
420 FolksBackendStore *backend_store;
421 FolksBackend *backend;
422 FolksPersonaStore *persona_store;
424 GeeMap *persona_stores;
426 const gchar *store_id;
428 g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
429 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
431 priv = GET_PRIV (self);
433 /* We need to ref the contact since otherwise its linked TpHandle will be
435 g_object_ref (contact);
437 DEBUG ("adding individual from contact %s (%s)",
438 empathy_contact_get_id (contact), empathy_contact_get_alias (contact));
440 account = empathy_contact_get_account (contact);
441 store_id = tp_proxy_get_object_path (TP_PROXY (account));
443 /* Get the persona store to use */
444 backend_store = folks_backend_store_dup ();
446 folks_backend_store_dup_backend_by_name (backend_store, "telepathy");
450 g_warning ("Failed to add individual from contact: couldn't get "
451 "'telepathy' backend");
455 persona_stores = folks_backend_get_persona_stores (backend);
456 persona_store = gee_map_get (persona_stores, store_id);
458 if (persona_store == NULL)
460 g_warning ("Failed to add individual from contact: couldn't get persona "
461 "store '%s'", store_id);
465 details = tp_asv_new (
466 "contact", G_TYPE_STRING, empathy_contact_get_id (contact),
469 folks_individual_aggregator_add_persona_from_details (
470 priv->aggregator, NULL, persona_store, details,
471 aggregator_add_persona_from_details_cb, contact);
473 g_hash_table_destroy (details);
474 g_object_unref (persona_store);
477 tp_clear_object (&backend);
478 tp_clear_object (&backend_store);
482 aggregator_remove_individual_cb (GObject *source,
483 GAsyncResult *result,
486 FolksIndividualAggregator *aggregator = FOLKS_INDIVIDUAL_AGGREGATOR (source);
487 GError *error = NULL;
489 folks_individual_aggregator_remove_individual_finish (
490 aggregator, result, &error);
493 g_warning ("failed to remove individual: %s", error->message);
494 g_clear_error (&error);
499 * Removes the inner contact from the server (and thus the Individual). Not
500 * meant for de-shelling inner personas from an Individual.
503 empathy_individual_manager_remove (EmpathyIndividualManager *self,
504 FolksIndividual *individual,
505 const gchar *message)
507 EmpathyIndividualManagerPriv *priv;
509 g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
510 g_return_if_fail (FOLKS_IS_INDIVIDUAL (individual));
512 priv = GET_PRIV (self);
514 DEBUG ("removing individual %s (%s)",
515 folks_individual_get_id (individual),
516 folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (individual)));
518 folks_individual_aggregator_remove_individual (priv->aggregator, individual,
519 aggregator_remove_individual_cb, self);
522 /* FIXME: The parameter @self is not required and the method can be placed in
523 * utilities. I left it as it is to stay coherent with empathy-2.34 */
525 * empathy_individual_manager_supports_blocking
526 * @self: the #EmpathyIndividualManager
527 * @individual: an individual to check
529 * Indicates whether any personas of an @individual can be blocked.
531 * Returns: %TRUE if any persona supports contact blocking
534 empathy_individual_manager_supports_blocking (EmpathyIndividualManager *self,
535 FolksIndividual *individual)
539 gboolean retval = FALSE;
541 g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self), FALSE);
543 personas = folks_individual_get_personas (individual);
544 iter = gee_iterable_iterator (GEE_ITERABLE (personas));
545 while (!retval && gee_iterator_next (iter))
547 TpfPersona *persona = gee_iterator_get (iter);
549 EmpathyContactManager *manager;
551 if (TPF_IS_PERSONA (persona))
553 TpContact *tp_contact;
555 tp_contact = tpf_persona_get_contact (persona);
556 if (tp_contact != NULL)
558 conn = tp_contact_get_connection (tp_contact);
559 manager = empathy_contact_manager_dup_singleton ();
561 if (empathy_contact_manager_get_flags_for_connection (
563 EMPATHY_CONTACT_LIST_CAN_BLOCK)
566 g_object_unref (manager);
569 g_clear_object (&persona);
571 g_clear_object (&iter);
577 empathy_individual_manager_set_blocked (EmpathyIndividualManager *self,
578 FolksIndividual *individual,
585 g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
587 personas = folks_individual_get_personas (individual);
588 iter = gee_iterable_iterator (GEE_ITERABLE (personas));
589 while (gee_iterator_next (iter))
591 TpfPersona *persona = gee_iterator_get (iter);
592 EmpathyContact *contact;
593 EmpathyContactManager *manager;
594 EmpathyContactListFlags flags;
596 if (TPF_IS_PERSONA (persona))
598 TpContact *tp_contact;
600 tp_contact = tpf_persona_get_contact (persona);
601 if (tp_contact != NULL)
603 contact = empathy_contact_dup_from_tp_contact (tp_contact);
604 empathy_contact_set_persona (contact, FOLKS_PERSONA (persona));
605 manager = empathy_contact_manager_dup_singleton ();
606 flags = empathy_contact_manager_get_flags_for_connection (manager,
607 empathy_contact_get_connection (contact));
609 if (flags & EMPATHY_CONTACT_LIST_CAN_BLOCK)
610 empathy_contact_list_set_blocked (
611 EMPATHY_CONTACT_LIST (manager),
612 contact, blocked, abusive);
614 g_object_unref (manager);
615 g_object_unref (contact);
618 g_clear_object (&persona);
620 g_clear_object (&iter);
624 groups_change_group_cb (GObject *source,
625 GAsyncResult *result,
628 FolksGroupDetails *group_details = FOLKS_GROUP_DETAILS (source);
629 GError *error = NULL;
631 folks_group_details_change_group_finish (group_details, result, &error);
634 g_warning ("failed to change group: %s", error->message);
635 g_clear_error (&error);
640 remove_group_cb (const gchar *id,
641 FolksIndividual *individual,
644 folks_group_details_change_group (FOLKS_GROUP_DETAILS (individual), group,
645 FALSE, groups_change_group_cb, NULL);
649 empathy_individual_manager_remove_group (EmpathyIndividualManager *manager,
652 EmpathyIndividualManagerPriv *priv;
654 g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (manager));
655 g_return_if_fail (group != NULL);
657 priv = GET_PRIV (manager);
659 DEBUG ("removing group %s", group);
661 /* Remove every individual from the group */
662 g_hash_table_foreach (priv->individuals, (GHFunc) remove_group_cb,
667 link_personas_cb (FolksIndividualAggregator *aggregator,
668 GAsyncResult *async_result,
671 GError *error = NULL;
673 folks_individual_aggregator_link_personas_finish (aggregator, async_result,
678 g_warning ("Failed to link personas: %s", error->message);
679 g_clear_error (&error);
684 empathy_individual_manager_link_personas (EmpathyIndividualManager *self,
687 EmpathyIndividualManagerPriv *priv;
689 g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
690 g_return_if_fail (personas != NULL);
692 priv = GET_PRIV (self);
694 DEBUG ("Linking %u personas",
695 gee_collection_get_size (GEE_COLLECTION (personas)));
697 folks_individual_aggregator_link_personas (priv->aggregator, personas,
698 (GAsyncReadyCallback) link_personas_cb, NULL);
702 unlink_individual_cb (FolksIndividualAggregator *aggregator,
703 GAsyncResult *async_result,
706 GError *error = NULL;
708 folks_individual_aggregator_unlink_individual_finish (aggregator,
709 async_result, &error);
713 g_warning ("Failed to unlink individual: %s", error->message);
714 g_clear_error (&error);
719 empathy_individual_manager_unlink_individual (EmpathyIndividualManager *self,
720 FolksIndividual *individual)
722 EmpathyIndividualManagerPriv *priv;
724 g_return_if_fail (EMPATHY_IS_INDIVIDUAL_MANAGER (self));
725 g_return_if_fail (FOLKS_IS_INDIVIDUAL (individual));
727 priv = GET_PRIV (self);
729 DEBUG ("Unlinking individual '%s'", folks_individual_get_id (individual));
731 folks_individual_aggregator_unlink_individual (priv->aggregator, individual,
732 (GAsyncReadyCallback) unlink_individual_cb, NULL);