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;
58 static void empathy_contact_class_init (EmpathyContactClass *class);
59 static void empathy_contact_init (EmpathyContact *contact);
60 static void contact_finalize (GObject *object);
61 static void contact_get_property (GObject *object,
65 static void contact_set_property (GObject *object,
70 G_DEFINE_TYPE (EmpathyContact, empathy_contact, G_TYPE_OBJECT);
79 PROP_PRESENCE_MESSAGE,
86 empathy_contact_class_init (EmpathyContactClass *class)
88 GObjectClass *object_class;
90 object_class = G_OBJECT_CLASS (class);
92 object_class->finalize = contact_finalize;
93 object_class->get_property = contact_get_property;
94 object_class->set_property = contact_set_property;
96 g_object_class_install_property (object_class,
98 g_param_spec_string ("id",
100 "String identifying contact",
104 g_object_class_install_property (object_class,
106 g_param_spec_string ("name",
108 "The name of the contact",
112 g_object_class_install_property (object_class,
114 g_param_spec_boxed ("avatar",
120 g_object_class_install_property (object_class,
122 g_param_spec_object ("account",
124 "The account associated with the contact",
128 g_object_class_install_property (object_class,
130 g_param_spec_uint ("presence",
132 "Presence of contact",
138 g_object_class_install_property (object_class,
139 PROP_PRESENCE_MESSAGE,
140 g_param_spec_string ("presence-message",
141 "Contact presence message",
142 "Presence message of contact",
145 g_object_class_install_property (object_class,
147 g_param_spec_uint ("handle",
149 "The handle of the contact",
155 g_object_class_install_property (object_class,
157 g_param_spec_flags ("capabilities",
158 "Contact Capabilities",
159 "Capabilities of the contact",
160 EMPATHY_TYPE_CAPABILITIES,
161 EMPATHY_CAPABILITIES_UNKNOWN,
162 G_PARAM_CONSTRUCT | G_PARAM_READWRITE));
164 g_object_class_install_property (object_class,
166 g_param_spec_boolean ("is-user",
168 "Is contact the user",
172 g_type_class_add_private (object_class, sizeof (EmpathyContactPriv));
176 empathy_contact_init (EmpathyContact *contact)
181 contact_finalize (GObject *object)
183 EmpathyContactPriv *priv;
185 priv = GET_PRIV (object);
187 empathy_debug (DEBUG_DOMAIN, "finalize: %p", object);
191 g_free (priv->presence_message);
194 empathy_avatar_unref (priv->avatar);
198 g_object_unref (priv->account);
201 G_OBJECT_CLASS (empathy_contact_parent_class)->finalize (object);
205 contact_get_property (GObject *object,
210 EmpathyContactPriv *priv;
212 priv = GET_PRIV (object);
216 g_value_set_string (value,
217 empathy_contact_get_id (EMPATHY_CONTACT (object)));
220 g_value_set_string (value,
221 empathy_contact_get_name (EMPATHY_CONTACT (object)));
224 g_value_set_boxed (value, priv->avatar);
227 g_value_set_object (value, priv->account);
230 g_value_set_uint (value, priv->presence);
232 case PROP_PRESENCE_MESSAGE:
233 g_value_set_string (value, priv->presence_message);
236 g_value_set_uint (value, priv->handle);
238 case PROP_CAPABILITIES:
239 g_value_set_flags (value, priv->capabilities);
242 g_value_set_boolean (value, priv->is_user);
245 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
251 contact_set_property (GObject *object,
256 EmpathyContactPriv *priv;
258 priv = GET_PRIV (object);
262 empathy_contact_set_id (EMPATHY_CONTACT (object),
263 g_value_get_string (value));
266 empathy_contact_set_name (EMPATHY_CONTACT (object),
267 g_value_get_string (value));
270 empathy_contact_set_avatar (EMPATHY_CONTACT (object),
271 g_value_get_boxed (value));
274 empathy_contact_set_account (EMPATHY_CONTACT (object),
275 MC_ACCOUNT (g_value_get_object (value)));
278 empathy_contact_set_presence (EMPATHY_CONTACT (object),
279 g_value_get_uint (value));
281 case PROP_PRESENCE_MESSAGE:
282 empathy_contact_set_presence_message (EMPATHY_CONTACT (object),
283 g_value_get_string (value));
286 empathy_contact_set_handle (EMPATHY_CONTACT (object),
287 g_value_get_uint (value));
289 case PROP_CAPABILITIES:
290 empathy_contact_set_capabilities (EMPATHY_CONTACT (object),
291 g_value_get_flags (value));
294 empathy_contact_set_is_user (EMPATHY_CONTACT (object),
295 g_value_get_boolean (value));
298 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
304 empathy_contact_new (McAccount *account)
306 return g_object_new (EMPATHY_TYPE_CONTACT,
312 empathy_contact_new_full (McAccount *account,
316 return g_object_new (EMPATHY_TYPE_CONTACT,
324 empathy_contact_get_id (EmpathyContact *contact)
326 EmpathyContactPriv *priv;
328 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
330 priv = GET_PRIV (contact);
340 empathy_contact_set_id (EmpathyContact *contact,
343 EmpathyContactPriv *priv;
345 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
346 g_return_if_fail (id != NULL);
348 priv = GET_PRIV (contact);
350 if (priv->id && strcmp (id, priv->id) == 0) {
355 priv->id = g_strdup (id);
357 g_object_notify (G_OBJECT (contact), "id");
358 if (G_STR_EMPTY (priv->name)) {
359 g_object_notify (G_OBJECT (contact), "name");
364 empathy_contact_get_name (EmpathyContact *contact)
366 EmpathyContactPriv *priv;
368 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
370 priv = GET_PRIV (contact);
372 if (G_STR_EMPTY (priv->name)) {
373 return empathy_contact_get_id (contact);
380 empathy_contact_set_name (EmpathyContact *contact,
383 EmpathyContactPriv *priv;
385 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
386 g_return_if_fail (name != NULL);
388 priv = GET_PRIV (contact);
390 if (priv->name && strcmp (name, priv->name) == 0) {
395 priv->name = g_strdup (name);
397 g_object_notify (G_OBJECT (contact), "name");
401 empathy_contact_get_avatar (EmpathyContact *contact)
403 EmpathyContactPriv *priv;
405 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
407 priv = GET_PRIV (contact);
413 empathy_contact_set_avatar (EmpathyContact *contact,
414 EmpathyAvatar *avatar)
416 EmpathyContactPriv *priv;
418 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
420 priv = GET_PRIV (contact);
422 if (priv->avatar == avatar) {
427 empathy_avatar_unref (priv->avatar);
432 priv->avatar = empathy_avatar_ref (avatar);
435 g_object_notify (G_OBJECT (contact), "avatar");
439 empathy_contact_get_account (EmpathyContact *contact)
441 EmpathyContactPriv *priv;
443 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
445 priv = GET_PRIV (contact);
447 return priv->account;
451 empathy_contact_set_account (EmpathyContact *contact,
454 EmpathyContactPriv *priv;
456 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
457 g_return_if_fail (MC_IS_ACCOUNT (account));
459 priv = GET_PRIV (contact);
461 if (account == priv->account) {
466 g_object_unref (priv->account);
468 priv->account = g_object_ref (account);
470 g_object_notify (G_OBJECT (contact), "account");
474 empathy_contact_get_presence (EmpathyContact *contact)
476 EmpathyContactPriv *priv;
478 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), MC_PRESENCE_UNSET);
480 priv = GET_PRIV (contact);
482 return priv->presence;
486 empathy_contact_set_presence (EmpathyContact *contact,
489 EmpathyContactPriv *priv;
491 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
493 priv = GET_PRIV (contact);
495 if (presence == priv->presence) {
499 priv->presence = presence;
501 g_object_notify (G_OBJECT (contact), "presence");
505 empathy_contact_get_presence_message (EmpathyContact *contact)
507 EmpathyContactPriv *priv;
509 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
511 priv = GET_PRIV (contact);
513 return priv->presence_message;
517 empathy_contact_set_presence_message (EmpathyContact *contact,
518 const gchar *message)
520 EmpathyContactPriv *priv = GET_PRIV (contact);
522 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
524 if (!tp_strdiff (message, priv->presence_message)) {
528 g_free (priv->presence_message);
529 priv->presence_message = g_strdup (message);
531 g_object_notify (G_OBJECT (contact), "presence-message");
535 empathy_contact_get_handle (EmpathyContact *contact)
537 EmpathyContactPriv *priv;
539 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
541 priv = GET_PRIV (contact);
547 empathy_contact_set_handle (EmpathyContact *contact,
550 EmpathyContactPriv *priv;
552 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
554 priv = GET_PRIV (contact);
556 if (priv->handle == handle) {
560 priv->handle = handle;
562 g_object_notify (G_OBJECT (contact), "handle");
566 empathy_contact_get_capabilities (EmpathyContact *contact)
568 EmpathyContactPriv *priv;
570 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
572 priv = GET_PRIV (contact);
574 return priv->capabilities;
578 empathy_contact_set_capabilities (EmpathyContact *contact,
579 EmpathyCapabilities capabilities)
581 EmpathyContactPriv *priv;
583 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
585 priv = GET_PRIV (contact);
587 if (priv->capabilities == capabilities) {
591 priv->capabilities = capabilities;
593 g_object_notify (G_OBJECT (contact), "capabilities");
597 empathy_contact_is_user (EmpathyContact *contact)
599 EmpathyContactPriv *priv;
601 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
603 priv = GET_PRIV (contact);
605 return priv->is_user;
609 empathy_contact_set_is_user (EmpathyContact *contact,
612 EmpathyContactPriv *priv;
614 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
616 priv = GET_PRIV (contact);
618 if (priv->is_user == is_user) {
622 priv->is_user = is_user;
624 g_object_notify (G_OBJECT (contact), "is-user");
628 empathy_contact_is_online (EmpathyContact *contact)
630 EmpathyContactPriv *priv;
632 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
634 priv = GET_PRIV (contact);
636 return (priv->presence > MC_PRESENCE_OFFLINE);
640 empathy_contact_get_status (EmpathyContact *contact)
642 EmpathyContactPriv *priv;
644 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
646 priv = GET_PRIV (contact);
648 if (priv->presence_message) {
649 return priv->presence_message;
652 return empathy_presence_get_default_message (priv->presence);
656 empathy_contact_can_voip (EmpathyContact *contact)
658 EmpathyContactPriv *priv;
660 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
662 priv = GET_PRIV (contact);
664 return priv->capabilities & (EMPATHY_CAPABILITIES_AUDIO |
665 EMPATHY_CAPABILITIES_VIDEO);
669 empathy_contact_equal (gconstpointer v1,
672 McAccount *account_a;
673 McAccount *account_b;
677 g_return_val_if_fail (EMPATHY_IS_CONTACT (v1), FALSE);
678 g_return_val_if_fail (EMPATHY_IS_CONTACT (v2), FALSE);
680 account_a = empathy_contact_get_account (EMPATHY_CONTACT (v1));
681 account_b = empathy_contact_get_account (EMPATHY_CONTACT (v2));
683 id_a = empathy_contact_get_id (EMPATHY_CONTACT (v1));
684 id_b = empathy_contact_get_id (EMPATHY_CONTACT (v2));
686 return empathy_account_equal (account_a, account_b) && g_str_equal (id_a, id_b);
690 empathy_contact_hash (gconstpointer key)
692 EmpathyContactPriv *priv;
694 g_return_val_if_fail (EMPATHY_IS_CONTACT (key), +1);
696 priv = GET_PRIV (EMPATHY_CONTACT (key));
698 if (priv->hash == 0) {
699 priv->hash = empathy_account_hash (priv->account) + g_str_hash (priv->id);