1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
3 * Copyright (C) 2004 Imendio AB
4 * Copyright (C) 2007-2008 Collabora Ltd.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation; either version 2 of the
9 * License, or (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public
17 * License along with this program; if not, write to the
18 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
21 * Authors: Mikael Hallendal <micke@imendio.com>
22 * Martyn Russell <martyn@imendio.com>
23 * Xavier Claessens <xclaesse@gmail.com>
30 #include <glib/gi18n.h>
32 #include <telepathy-glib/util.h>
34 #include "empathy-contact.h"
35 #include "empathy-utils.h"
36 #include "empathy-debug.h"
37 #include "empathy-enum-types.h"
39 #define DEBUG_DOMAIN "Contact"
41 #define GET_PRIV(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), EMPATHY_TYPE_CONTACT, EmpathyContactPriv))
43 typedef struct _EmpathyContactPriv EmpathyContactPriv;
45 struct _EmpathyContactPriv {
48 EmpathyAvatar *avatar;
51 gchar *presence_message;
53 EmpathyCapabilities capabilities;
56 EmpathyContactReady ready;
59 static void empathy_contact_class_init (EmpathyContactClass *class);
60 static void empathy_contact_init (EmpathyContact *contact);
61 static void contact_finalize (GObject *object);
62 static void contact_get_property (GObject *object,
66 static void contact_set_property (GObject *object,
71 G_DEFINE_TYPE (EmpathyContact, empathy_contact, G_TYPE_OBJECT);
80 PROP_PRESENCE_MESSAGE,
88 empathy_contact_class_init (EmpathyContactClass *class)
90 GObjectClass *object_class;
92 object_class = G_OBJECT_CLASS (class);
94 object_class->finalize = contact_finalize;
95 object_class->get_property = contact_get_property;
96 object_class->set_property = contact_set_property;
98 g_object_class_install_property (object_class,
100 g_param_spec_string ("id",
102 "String identifying contact",
106 g_object_class_install_property (object_class,
108 g_param_spec_string ("name",
110 "The name of the contact",
114 g_object_class_install_property (object_class,
116 g_param_spec_boxed ("avatar",
122 g_object_class_install_property (object_class,
124 g_param_spec_object ("account",
126 "The account associated with the contact",
130 g_object_class_install_property (object_class,
132 g_param_spec_uint ("presence",
134 "Presence of contact",
140 g_object_class_install_property (object_class,
141 PROP_PRESENCE_MESSAGE,
142 g_param_spec_string ("presence-message",
143 "Contact presence message",
144 "Presence message of contact",
147 g_object_class_install_property (object_class,
149 g_param_spec_uint ("handle",
151 "The handle of the contact",
157 g_object_class_install_property (object_class,
159 g_param_spec_flags ("capabilities",
160 "Contact Capabilities",
161 "Capabilities of the contact",
162 EMPATHY_TYPE_CAPABILITIES,
163 EMPATHY_CAPABILITIES_UNKNOWN,
164 G_PARAM_CONSTRUCT | G_PARAM_READWRITE));
166 g_object_class_install_property (object_class,
168 g_param_spec_boolean ("is-user",
170 "Is contact the user",
174 g_object_class_install_property (object_class,
176 g_param_spec_flags ("ready",
177 "Contact ready flags",
178 "Flags for ready properties",
179 EMPATHY_TYPE_CONTACT_READY,
180 EMPATHY_CONTACT_READY_NONE,
183 g_type_class_add_private (object_class, sizeof (EmpathyContactPriv));
187 empathy_contact_init (EmpathyContact *contact)
192 contact_finalize (GObject *object)
194 EmpathyContactPriv *priv;
196 priv = GET_PRIV (object);
198 empathy_debug (DEBUG_DOMAIN, "finalize: %p", object);
202 g_free (priv->presence_message);
205 empathy_avatar_unref (priv->avatar);
209 g_object_unref (priv->account);
212 G_OBJECT_CLASS (empathy_contact_parent_class)->finalize (object);
216 contact_get_property (GObject *object,
221 EmpathyContactPriv *priv;
223 priv = GET_PRIV (object);
227 g_value_set_string (value, priv->id);
230 g_value_set_string (value,
231 empathy_contact_get_name (EMPATHY_CONTACT (object)));
234 g_value_set_boxed (value, priv->avatar);
237 g_value_set_object (value, priv->account);
240 g_value_set_uint (value, priv->presence);
242 case PROP_PRESENCE_MESSAGE:
243 g_value_set_string (value, priv->presence_message);
246 g_value_set_uint (value, priv->handle);
248 case PROP_CAPABILITIES:
249 g_value_set_flags (value, priv->capabilities);
252 g_value_set_boolean (value, priv->is_user);
255 g_value_set_flags (value, priv->ready);
258 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
264 contact_set_property (GObject *object,
269 EmpathyContactPriv *priv;
271 priv = GET_PRIV (object);
275 empathy_contact_set_id (EMPATHY_CONTACT (object),
276 g_value_get_string (value));
279 empathy_contact_set_name (EMPATHY_CONTACT (object),
280 g_value_get_string (value));
283 empathy_contact_set_avatar (EMPATHY_CONTACT (object),
284 g_value_get_boxed (value));
287 empathy_contact_set_account (EMPATHY_CONTACT (object),
288 MC_ACCOUNT (g_value_get_object (value)));
291 empathy_contact_set_presence (EMPATHY_CONTACT (object),
292 g_value_get_uint (value));
294 case PROP_PRESENCE_MESSAGE:
295 empathy_contact_set_presence_message (EMPATHY_CONTACT (object),
296 g_value_get_string (value));
299 empathy_contact_set_handle (EMPATHY_CONTACT (object),
300 g_value_get_uint (value));
302 case PROP_CAPABILITIES:
303 empathy_contact_set_capabilities (EMPATHY_CONTACT (object),
304 g_value_get_flags (value));
307 empathy_contact_set_is_user (EMPATHY_CONTACT (object),
308 g_value_get_boolean (value));
311 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
317 contact_set_ready_flag (EmpathyContact *contact,
318 EmpathyContactReady flag,
321 EmpathyContactPriv *priv = GET_PRIV (contact);
322 EmpathyContactReady ready_old = priv->ready;
327 priv->ready &= ~flag;
330 if (priv->ready != ready_old) {
331 g_object_notify (G_OBJECT (contact), "ready");
336 empathy_contact_new (McAccount *account)
338 return g_object_new (EMPATHY_TYPE_CONTACT,
344 empathy_contact_new_full (McAccount *account,
348 return g_object_new (EMPATHY_TYPE_CONTACT,
356 empathy_contact_get_id (EmpathyContact *contact)
358 EmpathyContactPriv *priv;
360 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
362 priv = GET_PRIV (contact);
368 empathy_contact_set_id (EmpathyContact *contact,
371 EmpathyContactPriv *priv;
373 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
374 g_return_if_fail (id != NULL);
376 priv = GET_PRIV (contact);
378 if (!tp_strdiff (id, priv->id)) {
383 priv->id = g_strdup (id);
384 g_object_ref (contact);
385 contact_set_ready_flag (contact, EMPATHY_CONTACT_READY_ID,
387 g_object_notify (G_OBJECT (contact), "id");
388 if (G_STR_EMPTY (priv->name)) {
389 g_object_notify (G_OBJECT (contact), "name");
391 g_object_unref (contact);
395 empathy_contact_get_name (EmpathyContact *contact)
397 EmpathyContactPriv *priv;
399 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
401 priv = GET_PRIV (contact);
403 if (G_STR_EMPTY (priv->name)) {
404 return empathy_contact_get_id (contact);
411 empathy_contact_set_name (EmpathyContact *contact,
414 EmpathyContactPriv *priv;
416 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
418 priv = GET_PRIV (contact);
420 if (!tp_strdiff (name, priv->name)) {
425 priv->name = g_strdup (name);
427 g_object_ref (contact);
428 contact_set_ready_flag (contact, EMPATHY_CONTACT_READY_NAME,
430 g_object_notify (G_OBJECT (contact), "name");
431 g_object_unref (contact);
435 empathy_contact_get_avatar (EmpathyContact *contact)
437 EmpathyContactPriv *priv;
439 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
441 priv = GET_PRIV (contact);
447 empathy_contact_set_avatar (EmpathyContact *contact,
448 EmpathyAvatar *avatar)
450 EmpathyContactPriv *priv;
452 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
454 priv = GET_PRIV (contact);
456 if (priv->avatar == avatar) {
461 empathy_avatar_unref (priv->avatar);
466 priv->avatar = empathy_avatar_ref (avatar);
469 g_object_notify (G_OBJECT (contact), "avatar");
473 empathy_contact_get_account (EmpathyContact *contact)
475 EmpathyContactPriv *priv;
477 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
479 priv = GET_PRIV (contact);
481 return priv->account;
485 empathy_contact_set_account (EmpathyContact *contact,
488 EmpathyContactPriv *priv;
490 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
491 g_return_if_fail (MC_IS_ACCOUNT (account));
493 priv = GET_PRIV (contact);
495 if (account == priv->account) {
500 g_object_unref (priv->account);
502 priv->account = g_object_ref (account);
504 g_object_notify (G_OBJECT (contact), "account");
508 empathy_contact_get_presence (EmpathyContact *contact)
510 EmpathyContactPriv *priv;
512 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), MC_PRESENCE_UNSET);
514 priv = GET_PRIV (contact);
516 return priv->presence;
520 empathy_contact_set_presence (EmpathyContact *contact,
523 EmpathyContactPriv *priv;
525 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
527 priv = GET_PRIV (contact);
529 if (presence == priv->presence) {
533 priv->presence = presence;
535 g_object_notify (G_OBJECT (contact), "presence");
539 empathy_contact_get_presence_message (EmpathyContact *contact)
541 EmpathyContactPriv *priv;
543 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
545 priv = GET_PRIV (contact);
547 return priv->presence_message;
551 empathy_contact_set_presence_message (EmpathyContact *contact,
552 const gchar *message)
554 EmpathyContactPriv *priv = GET_PRIV (contact);
556 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
558 if (!tp_strdiff (message, priv->presence_message)) {
562 g_free (priv->presence_message);
563 priv->presence_message = g_strdup (message);
565 g_object_notify (G_OBJECT (contact), "presence-message");
569 empathy_contact_get_handle (EmpathyContact *contact)
571 EmpathyContactPriv *priv;
573 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
575 priv = GET_PRIV (contact);
581 empathy_contact_set_handle (EmpathyContact *contact,
584 EmpathyContactPriv *priv;
586 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
588 priv = GET_PRIV (contact);
590 if (priv->handle == handle) {
594 priv->handle = handle;
596 g_object_ref (contact);
597 contact_set_ready_flag (contact, EMPATHY_CONTACT_READY_HANDLE,
599 g_object_notify (G_OBJECT (contact), "handle");
600 g_object_unref (contact);
604 empathy_contact_get_capabilities (EmpathyContact *contact)
606 EmpathyContactPriv *priv;
608 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
610 priv = GET_PRIV (contact);
612 return priv->capabilities;
616 empathy_contact_set_capabilities (EmpathyContact *contact,
617 EmpathyCapabilities capabilities)
619 EmpathyContactPriv *priv;
621 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
623 priv = GET_PRIV (contact);
625 if (priv->capabilities == capabilities) {
629 priv->capabilities = capabilities;
631 g_object_notify (G_OBJECT (contact), "capabilities");
635 empathy_contact_is_user (EmpathyContact *contact)
637 EmpathyContactPriv *priv;
639 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
641 priv = GET_PRIV (contact);
643 return priv->is_user;
647 empathy_contact_set_is_user (EmpathyContact *contact,
650 EmpathyContactPriv *priv;
652 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
654 priv = GET_PRIV (contact);
656 if (priv->is_user == is_user) {
660 priv->is_user = is_user;
662 g_object_notify (G_OBJECT (contact), "is-user");
666 empathy_contact_is_online (EmpathyContact *contact)
668 EmpathyContactPriv *priv;
670 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
672 priv = GET_PRIV (contact);
674 return (priv->presence > MC_PRESENCE_OFFLINE);
678 empathy_contact_get_status (EmpathyContact *contact)
680 EmpathyContactPriv *priv;
682 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
684 priv = GET_PRIV (contact);
686 if (priv->presence_message) {
687 return priv->presence_message;
690 return empathy_presence_get_default_message (priv->presence);
694 empathy_contact_can_voip (EmpathyContact *contact)
696 EmpathyContactPriv *priv;
698 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
700 priv = GET_PRIV (contact);
702 return priv->capabilities & (EMPATHY_CAPABILITIES_AUDIO |
703 EMPATHY_CAPABILITIES_VIDEO);
707 empathy_contact_get_ready (EmpathyContact *contact)
709 EmpathyContactPriv *priv;
711 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
713 priv = GET_PRIV (contact);
719 empathy_contact_equal (gconstpointer v1,
722 McAccount *account_a;
723 McAccount *account_b;
727 g_return_val_if_fail (EMPATHY_IS_CONTACT (v1), FALSE);
728 g_return_val_if_fail (EMPATHY_IS_CONTACT (v2), FALSE);
730 account_a = empathy_contact_get_account (EMPATHY_CONTACT (v1));
731 account_b = empathy_contact_get_account (EMPATHY_CONTACT (v2));
733 id_a = empathy_contact_get_id (EMPATHY_CONTACT (v1));
734 id_b = empathy_contact_get_id (EMPATHY_CONTACT (v2));
736 return empathy_account_equal (account_a, account_b) && g_str_equal (id_a, id_b);
740 empathy_contact_hash (gconstpointer key)
742 EmpathyContactPriv *priv;
744 g_return_val_if_fail (EMPATHY_IS_CONTACT (key), +1);
746 priv = GET_PRIV (EMPATHY_CONTACT (key));
748 if (priv->hash == 0) {
749 priv->hash = empathy_account_hash (priv->account) + g_str_hash (priv->id);
756 EmpathyContactReady ready;
761 contact_ready_notify_cb (EmpathyContact *contact,
763 RunUntilReadyData *data)
765 EmpathyContactPriv *priv = GET_PRIV (contact);
767 if ((priv->ready & data->ready) == data->ready) {
768 empathy_debug (DEBUG_DOMAIN, "contact %s (%d) ready %d",
769 priv->id, priv->handle, priv->ready);
770 g_main_loop_quit (data->loop);
775 empathy_contact_run_until_ready (EmpathyContact *contact,
776 EmpathyContactReady ready,
779 EmpathyContactPriv *priv = GET_PRIV (contact);
780 RunUntilReadyData data;
783 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
785 if ((priv->ready & ready) == ready) {
789 empathy_debug (DEBUG_DOMAIN, "Run until ready=%d for contact %s (%d)",
790 ready, priv->id, priv->handle);
793 data.loop = g_main_loop_new (NULL, FALSE);
795 signal_id = g_signal_connect (contact, "notify::ready",
796 G_CALLBACK (contact_ready_notify_cb),
802 g_main_loop_run (data.loop);
808 g_signal_handler_disconnect (contact, signal_id);
809 g_main_loop_unref (data.loop);