1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
3 * Copyright (C) 2004 Imendio AB
4 * Copyright (C) 2007 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;
57 static void empathy_contact_class_init (EmpathyContactClass *class);
58 static void empathy_contact_init (EmpathyContact *contact);
59 static void contact_finalize (GObject *object);
60 static void contact_get_property (GObject *object,
64 static void contact_set_property (GObject *object,
69 G_DEFINE_TYPE (EmpathyContact, empathy_contact, G_TYPE_OBJECT);
78 PROP_PRESENCE_MESSAGE,
87 empathy_contact_class_init (EmpathyContactClass *class)
89 GObjectClass *object_class;
91 object_class = G_OBJECT_CLASS (class);
93 object_class->finalize = contact_finalize;
94 object_class->get_property = contact_get_property;
95 object_class->set_property = contact_set_property;
97 g_object_class_install_property (object_class,
99 g_param_spec_string ("id",
101 "String identifying contact",
105 g_object_class_install_property (object_class,
107 g_param_spec_string ("name",
109 "The name of the contact",
113 g_object_class_install_property (object_class,
115 g_param_spec_boxed ("avatar",
121 g_object_class_install_property (object_class,
123 g_param_spec_object ("account",
125 "The account associated with the contact",
129 g_object_class_install_property (object_class,
131 g_param_spec_uint ("presence",
133 "Presence of contact",
139 g_object_class_install_property (object_class,
140 PROP_PRESENCE_MESSAGE,
141 g_param_spec_string ("presence-message",
142 "Contact presence message",
143 "Presence message of contact",
146 g_object_class_install_property (object_class,
148 g_param_spec_uint ("handle",
150 "The handle of the contact",
156 g_object_class_install_property (object_class,
158 g_param_spec_flags ("capabilities",
159 "Contact Capabilities",
160 "Capabilities of the contact",
161 EMPATHY_TYPE_CAPABILITIES,
165 g_object_class_install_property (object_class,
167 g_param_spec_boolean ("is-user",
169 "Is contact the user",
173 g_type_class_add_private (object_class, sizeof (EmpathyContactPriv));
177 empathy_contact_init (EmpathyContact *contact)
179 EmpathyContactPriv *priv;
181 priv = GET_PRIV (contact);
182 priv->capabilities = EMPATHY_CAPABILITIES_UNKNOWN;
186 contact_finalize (GObject *object)
188 EmpathyContactPriv *priv;
190 priv = GET_PRIV (object);
192 empathy_debug (DEBUG_DOMAIN, "finalize: %p", object);
196 g_free (priv->presence_message);
199 empathy_avatar_unref (priv->avatar);
203 g_object_unref (priv->account);
206 G_OBJECT_CLASS (empathy_contact_parent_class)->finalize (object);
210 contact_get_property (GObject *object,
215 EmpathyContactPriv *priv;
217 priv = GET_PRIV (object);
221 g_value_set_string (value,
222 empathy_contact_get_id (EMPATHY_CONTACT (object)));
225 g_value_set_string (value,
226 empathy_contact_get_name (EMPATHY_CONTACT (object)));
229 g_value_set_boxed (value, priv->avatar);
232 g_value_set_object (value, priv->account);
235 g_value_set_uint (value, priv->presence);
237 case PROP_PRESENCE_MESSAGE:
238 g_value_set_string (value, priv->presence_message);
241 g_value_set_uint (value, priv->handle);
243 case PROP_CAPABILITIES:
244 g_value_set_flags (value, priv->capabilities);
247 g_value_set_boolean (value, priv->is_user);
250 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
256 contact_set_property (GObject *object,
261 EmpathyContactPriv *priv;
263 priv = GET_PRIV (object);
267 empathy_contact_set_id (EMPATHY_CONTACT (object),
268 g_value_get_string (value));
271 empathy_contact_set_name (EMPATHY_CONTACT (object),
272 g_value_get_string (value));
275 empathy_contact_set_avatar (EMPATHY_CONTACT (object),
276 g_value_get_boxed (value));
279 empathy_contact_set_account (EMPATHY_CONTACT (object),
280 MC_ACCOUNT (g_value_get_object (value)));
283 empathy_contact_set_presence (EMPATHY_CONTACT (object),
284 g_value_get_uint (value));
286 case PROP_PRESENCE_MESSAGE:
287 empathy_contact_set_presence_message (EMPATHY_CONTACT (object),
288 g_value_get_string (value));
291 empathy_contact_set_handle (EMPATHY_CONTACT (object),
292 g_value_get_uint (value));
294 case PROP_CAPABILITIES:
295 empathy_contact_set_capabilities (EMPATHY_CONTACT (object),
296 g_value_get_flags (value));
299 empathy_contact_set_is_user (EMPATHY_CONTACT (object),
300 g_value_get_boolean (value));
303 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
309 empathy_contact_new (McAccount *account)
311 return g_object_new (EMPATHY_TYPE_CONTACT,
317 empathy_contact_new_full (McAccount *account,
321 return g_object_new (EMPATHY_TYPE_CONTACT,
329 empathy_contact_get_id (EmpathyContact *contact)
331 EmpathyContactPriv *priv;
333 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
335 priv = GET_PRIV (contact);
345 empathy_contact_set_id (EmpathyContact *contact,
348 EmpathyContactPriv *priv;
350 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
351 g_return_if_fail (id != NULL);
353 priv = GET_PRIV (contact);
355 if (priv->id && strcmp (id, priv->id) == 0) {
360 priv->id = g_strdup (id);
362 g_object_notify (G_OBJECT (contact), "id");
366 empathy_contact_get_name (EmpathyContact *contact)
368 EmpathyContactPriv *priv;
370 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
372 priv = GET_PRIV (contact);
374 if (G_STR_EMPTY (priv->name)) {
375 return empathy_contact_get_id (contact);
382 empathy_contact_set_name (EmpathyContact *contact,
385 EmpathyContactPriv *priv;
387 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
388 g_return_if_fail (name != NULL);
390 priv = GET_PRIV (contact);
392 if (priv->name && strcmp (name, priv->name) == 0) {
397 priv->name = g_strdup (name);
399 g_object_notify (G_OBJECT (contact), "name");
403 empathy_contact_get_avatar (EmpathyContact *contact)
405 EmpathyContactPriv *priv;
407 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
409 priv = GET_PRIV (contact);
415 empathy_contact_set_avatar (EmpathyContact *contact,
416 EmpathyAvatar *avatar)
418 EmpathyContactPriv *priv;
420 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
422 priv = GET_PRIV (contact);
424 if (priv->avatar == avatar) {
429 empathy_avatar_unref (priv->avatar);
434 priv->avatar = empathy_avatar_ref (avatar);
437 g_object_notify (G_OBJECT (contact), "avatar");
441 empathy_contact_get_account (EmpathyContact *contact)
443 EmpathyContactPriv *priv;
445 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
447 priv = GET_PRIV (contact);
449 return priv->account;
453 empathy_contact_set_account (EmpathyContact *contact,
456 EmpathyContactPriv *priv;
458 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
459 g_return_if_fail (MC_IS_ACCOUNT (account));
461 priv = GET_PRIV (contact);
463 if (account == priv->account) {
468 g_object_unref (priv->account);
470 priv->account = g_object_ref (account);
472 g_object_notify (G_OBJECT (contact), "account");
476 empathy_contact_get_presence (EmpathyContact *contact)
478 EmpathyContactPriv *priv;
480 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), MC_PRESENCE_UNSET);
482 priv = GET_PRIV (contact);
484 return priv->presence;
488 empathy_contact_set_presence (EmpathyContact *contact,
491 EmpathyContactPriv *priv;
493 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
495 priv = GET_PRIV (contact);
497 if (presence == priv->presence) {
501 priv->presence = presence;
503 g_object_notify (G_OBJECT (contact), "presence");
507 empathy_contact_get_presence_message (EmpathyContact *contact)
509 EmpathyContactPriv *priv;
511 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
513 priv = GET_PRIV (contact);
515 return priv->presence_message;
519 empathy_contact_set_presence_message (EmpathyContact *contact,
520 const gchar *message)
522 EmpathyContactPriv *priv = GET_PRIV (contact);
524 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
526 if (!tp_strdiff (message, priv->presence_message)) {
530 g_free (priv->presence_message);
531 priv->presence_message = g_strdup (message);
533 g_object_notify (G_OBJECT (contact), "presence-message");
537 empathy_contact_get_handle (EmpathyContact *contact)
539 EmpathyContactPriv *priv;
541 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
543 priv = GET_PRIV (contact);
549 empathy_contact_set_handle (EmpathyContact *contact,
552 EmpathyContactPriv *priv;
554 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
556 priv = GET_PRIV (contact);
558 if (priv->handle == handle) {
562 priv->handle = handle;
564 g_object_notify (G_OBJECT (contact), "handle");
568 empathy_contact_get_capabilities (EmpathyContact *contact)
570 EmpathyContactPriv *priv;
572 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
574 priv = GET_PRIV (contact);
576 return priv->capabilities;
580 empathy_contact_set_capabilities (EmpathyContact *contact,
581 EmpathyCapabilities capabilities)
583 EmpathyContactPriv *priv;
585 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
587 priv = GET_PRIV (contact);
589 if (priv->capabilities == capabilities) {
593 priv->capabilities = capabilities;
595 g_object_notify (G_OBJECT (contact), "capabilities");
599 empathy_contact_is_user (EmpathyContact *contact)
601 EmpathyContactPriv *priv;
603 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
605 priv = GET_PRIV (contact);
607 return priv->is_user;
611 empathy_contact_set_is_user (EmpathyContact *contact,
614 EmpathyContactPriv *priv;
616 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
618 priv = GET_PRIV (contact);
620 if (priv->is_user == is_user) {
624 priv->is_user = is_user;
626 g_object_notify (G_OBJECT (contact), "is-user");
630 empathy_contact_is_online (EmpathyContact *contact)
632 EmpathyContactPriv *priv;
634 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
636 priv = GET_PRIV (contact);
638 return (priv->presence > MC_PRESENCE_OFFLINE);
642 empathy_contact_get_status (EmpathyContact *contact)
644 EmpathyContactPriv *priv;
646 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
648 priv = GET_PRIV (contact);
650 if (priv->presence_message) {
651 return priv->presence_message;
654 return empathy_presence_get_default_message (priv->presence);
658 empathy_contact_can_voip (EmpathyContact *contact)
660 EmpathyContactPriv *priv;
662 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
664 priv = GET_PRIV (contact);
666 return priv->capabilities & (EMPATHY_CAPABILITIES_AUDIO |
667 EMPATHY_CAPABILITIES_VIDEO);
671 empathy_contact_equal (gconstpointer v1,
674 McAccount *account_a;
675 McAccount *account_b;
679 g_return_val_if_fail (EMPATHY_IS_CONTACT (v1), FALSE);
680 g_return_val_if_fail (EMPATHY_IS_CONTACT (v2), FALSE);
682 account_a = empathy_contact_get_account (EMPATHY_CONTACT (v1));
683 account_b = empathy_contact_get_account (EMPATHY_CONTACT (v2));
685 id_a = empathy_contact_get_id (EMPATHY_CONTACT (v1));
686 id_b = empathy_contact_get_id (EMPATHY_CONTACT (v2));
688 return empathy_account_equal (account_a, account_b) && g_str_equal (id_a, id_b);
692 empathy_contact_hash (gconstpointer key)
694 EmpathyContactPriv *priv;
697 g_return_val_if_fail (EMPATHY_IS_CONTACT (key), +1);
699 priv = GET_PRIV (EMPATHY_CONTACT (key));
701 hash = empathy_account_hash (empathy_contact_get_account (EMPATHY_CONTACT (key)));
702 hash += g_str_hash (empathy_contact_get_id (EMPATHY_CONTACT (key)));