1 /* * Copyright (C) 2007-2009 Collabora Ltd.
3 * This library is free software; you can redistribute it and/or
4 * modify it under the terms of the GNU Lesser General Public
5 * License as published by the Free Software Foundation; either
6 * version 2.1 of the License, or (at your option) any later version.
8 * This library is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * Lesser General Public License for more details.
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the Free Software
15 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
17 * Authors: Xavier Claessens <xclaesse@gmail.com>
18 * Sjoerd Simons <sjoerd.simons@collabora.co.uk>
19 * Cosimo Cecchi <cosimo.cecchi@collabora.co.uk>
22 #define DISPATCHER_BUS_NAME TP_CLIENT_BUS_NAME_BASE "Empathy"
23 #define DISPATCHER_OBJECT_PATH TP_CLIENT_OBJECT_PATH_BASE "Empathy"
29 #include <glib/gi18n-lib.h>
31 #include <telepathy-glib/enums.h>
32 #include <telepathy-glib/connection.h>
33 #include <telepathy-glib/util.h>
34 #include <telepathy-glib/dbus.h>
35 #include <telepathy-glib/proxy-subclass.h>
36 #include <telepathy-glib/gtypes.h>
37 #include <telepathy-glib/defs.h>
38 #include <telepathy-glib/svc-client.h>
39 #include <telepathy-glib/svc-generic.h>
40 #include <telepathy-glib/interfaces.h>
42 #include <extensions/extensions.h>
44 #include "empathy-dispatcher.h"
45 #include "empathy-handler.h"
46 #include "empathy-utils.h"
47 #include "empathy-tube-handler.h"
48 #include "empathy-account-manager.h"
49 #include "empathy-tp-contact-factory.h"
50 #include "empathy-chatroom-manager.h"
51 #include "empathy-utils.h"
53 #define DEBUG_FLAG EMPATHY_DEBUG_DISPATCHER
54 #include <libempathy/empathy-debug.h>
56 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyDispatcher)
59 gboolean dispose_has_run;
61 EmpathyAccountManager *account_manager;
62 /* connection to connection data mapping */
63 GHashTable *connections;
64 GHashTable *outstanding_classes_requests;
68 /* channels which the dispatcher is listening "invalidated" */
73 EmpathyHandler *handler;
78 GHashTable *request_channel_class_async_ids;
79 } EmpathyDispatcherPriv;
82 empathy_dispatcher_get_channels (EmpathyHandler *handler,
86 empathy_dispatcher_handle_channels (EmpathyHandler *handler,
87 const gchar *account_path,
88 const gchar *connection_path,
89 const GPtrArray *channels,
90 const GPtrArray *requests_satisfied,
92 GHashTable *handler_info,
96 G_DEFINE_TYPE (EmpathyDispatcher, empathy_dispatcher, G_TYPE_OBJECT);
112 static guint signals[LAST_SIGNAL];
113 static EmpathyDispatcher *dispatcher = NULL;
115 static void dispatcher_init_connection_if_needed (
116 EmpathyDispatcher *dispatcher,
117 TpConnection *connection);
119 static GList * empathy_dispatcher_find_channel_classes
120 (EmpathyDispatcher *dispatcher, TpConnection *connection,
121 const gchar *channel_type, guint handle_type, GArray *fixed_properties);
126 EmpathyDispatcher *dispatcher;
127 EmpathyDispatchOperation *operation;
128 TpConnection *connection;
129 gboolean should_ensure;
133 EmpathyContact *contact;
134 TpProxyPendingCall *pending_call;
136 /* Properties to pass to the channel when requesting it */
138 EmpathyDispatcherRequestCb *cb;
140 gpointer *request_data;
141 } DispatcherRequestData;
146 /* Channel type specific wrapper object */
147 GObject *channel_wrapper;
152 /* ObjectPath => DispatchData.. */
153 GHashTable *dispatched_channels;
154 /* ObjectPath -> EmpathyDispatchOperations */
155 GHashTable *dispatching_channels;
157 /* ObjectPath -> EmpathyDispatchOperations
159 * This holds channels which were announced with NewChannel while we have an
160 * outstanding channel request for a channel of this type. On the Requests
161 * interface, CreateChannel and EnsureChannel are guaranteed by the spec to
162 * return before NewChannels is emitted, but there was no guarantee of the
163 * ordering of RequestChannel vs. NewChannel. So if necessary, channels are
164 * held in limbo here until we know whether they were requested.
166 GHashTable *outstanding_channels;
167 /* List of DispatcherRequestData */
168 GList *outstanding_requests;
169 /* List of requestable channel classes */
170 GPtrArray *requestable_channels;
175 EmpathyDispatcher *dispatcher;
176 TpConnection *connection;
180 EmpathyDispatcherFindChannelClassCb *callback;
182 } FindChannelRequest;
185 empathy_dispatcher_call_create_or_ensure_channel (
186 EmpathyDispatcher *dispatcher,
187 DispatcherRequestData *request_data);
189 static DispatchData *
190 new_dispatch_data (TpChannel *channel,
191 GObject *channel_wrapper)
193 DispatchData *d = g_slice_new0 (DispatchData);
194 d->channel = g_object_ref (channel);
195 if (channel_wrapper != NULL)
196 d->channel_wrapper = g_object_ref (channel_wrapper);
202 free_dispatch_data (DispatchData *data)
204 g_object_unref (data->channel);
205 if (data->channel_wrapper != NULL)
206 g_object_unref (data->channel_wrapper);
208 g_slice_free (DispatchData, data);
211 static DispatcherRequestData *
212 new_dispatcher_request_data (EmpathyDispatcher *self,
213 TpConnection *connection,
214 const gchar *channel_type,
218 EmpathyContact *contact,
219 EmpathyDispatcherRequestCb *cb,
222 DispatcherRequestData *result = g_slice_new0 (DispatcherRequestData);
224 result->dispatcher = g_object_ref (self);
225 result->connection = connection;
227 result->should_ensure = FALSE;
229 result->channel_type = g_strdup (channel_type);
230 result->handle_type = handle_type;
231 result->handle = handle;
232 result->request = request;
235 result->contact = g_object_ref (contact);
238 result->user_data = user_data;
244 free_dispatcher_request_data (DispatcherRequestData *r)
246 g_free (r->channel_type);
248 if (r->dispatcher != NULL)
249 g_object_unref (r->dispatcher);
251 if (r->contact != NULL)
252 g_object_unref (r->contact);
254 if (r->request != NULL)
255 g_hash_table_unref (r->request);
257 if (r->pending_call != NULL)
258 tp_proxy_pending_call_cancel (r->pending_call);
260 g_slice_free (DispatcherRequestData, r);
263 static ConnectionData *
264 new_connection_data (void)
266 ConnectionData *cd = g_slice_new0 (ConnectionData);
268 cd->dispatched_channels = g_hash_table_new_full (g_str_hash, g_str_equal,
269 g_free, (GDestroyNotify) free_dispatch_data);
271 cd->dispatching_channels = g_hash_table_new_full (g_str_hash, g_str_equal,
272 g_free, g_object_unref);
274 cd->outstanding_channels = g_hash_table_new_full (g_str_hash, g_str_equal,
281 free_connection_data (ConnectionData *cd)
286 g_hash_table_destroy (cd->dispatched_channels);
287 g_hash_table_destroy (cd->dispatching_channels);
289 for (l = cd->outstanding_requests ; l != NULL; l = g_list_delete_link (l,l))
291 free_dispatcher_request_data (l->data);
294 if (cd->requestable_channels != NULL)
296 for (i = 0 ; i < cd->requestable_channels->len ; i++)
298 g_ptr_array_index (cd->requestable_channels, i));
299 g_ptr_array_free (cd->requestable_channels, TRUE);
304 free_find_channel_request (FindChannelRequest *r)
309 g_object_unref (r->dispatcher);
310 g_free (r->channel_type);
312 if (r->properties != NULL)
314 for (idx = 0; idx < r->properties->len ; idx++)
316 str = g_array_index (r->properties, char *, idx);
320 g_array_free (r->properties, TRUE);
323 g_slice_free (FindChannelRequest, r);
327 dispatcher_connection_invalidated_cb (TpConnection *connection,
331 EmpathyDispatcher *self)
333 EmpathyDispatcherPriv *priv = GET_PRIV (self);
335 DEBUG ("Error: %s", message);
336 g_hash_table_remove (priv->connections, connection);
340 dispatcher_operation_can_start (EmpathyDispatcher *self,
341 EmpathyDispatchOperation *operation,
345 const gchar *channel_type =
346 empathy_dispatch_operation_get_channel_type (operation);
348 for (l = cd->outstanding_requests; l != NULL; l = g_list_next (l))
350 DispatcherRequestData *d = (DispatcherRequestData *) l->data;
352 if (d->operation == NULL && !tp_strdiff (d->channel_type, channel_type))
362 dispatch_operation_flush_requests (EmpathyDispatcher *self,
363 EmpathyDispatchOperation *operation,
369 l = cd->outstanding_requests;
372 DispatcherRequestData *d = (DispatcherRequestData *) l->data;
377 if (d->operation == operation)
382 d->cb (NULL, error, d->user_data);
384 d->cb (operation, NULL, d->user_data);
387 cd->outstanding_requests = g_list_delete_link
388 (cd->outstanding_requests, lt);
390 free_dispatcher_request_data (d);
396 dispatcher_channel_invalidated_cb (TpProxy *proxy,
400 EmpathyDispatcher *self)
402 /* Channel went away... */
403 EmpathyDispatcherPriv *priv = GET_PRIV (self);
404 TpConnection *connection;
405 EmpathyDispatchOperation *operation;
407 const gchar *object_path;
409 connection = tp_channel_borrow_connection (TP_CHANNEL (proxy));
411 cd = g_hash_table_lookup (priv->connections, connection);
412 /* Connection itself invalidated? */
416 object_path = tp_proxy_get_object_path (proxy);
418 DEBUG ("Channel %s invalidated", object_path);
420 g_hash_table_remove (cd->dispatched_channels, object_path);
421 g_hash_table_remove (cd->dispatching_channels, object_path);
423 priv->channels = g_list_remove (priv->channels, proxy);
425 operation = g_hash_table_lookup (cd->outstanding_channels, object_path);
426 if (operation != NULL)
428 GError error = { domain, code, message };
429 dispatch_operation_flush_requests (self, operation, &error, cd);
430 g_hash_table_remove (cd->outstanding_channels, object_path);
431 g_object_unref (operation);
436 dispatch_operation_approved_cb (EmpathyDispatchOperation *operation,
437 EmpathyDispatcher *self)
439 g_assert (empathy_dispatch_operation_is_incoming (operation));
440 DEBUG ("Send of for dispatching: %s",
441 empathy_dispatch_operation_get_object_path (operation));
442 g_signal_emit (self, signals[DISPATCH], 0, operation);
446 dispatch_operation_claimed_cb (EmpathyDispatchOperation *operation,
447 EmpathyDispatcher *self)
449 /* Our job is done, remove the dispatch operation and mark the channel as
451 EmpathyDispatcherPriv *priv = GET_PRIV (self);
452 TpConnection *connection;
454 const gchar *object_path;
456 connection = empathy_dispatch_operation_get_tp_connection (operation);
457 cd = g_hash_table_lookup (priv->connections, connection);
458 g_assert (cd != NULL);
460 object_path = empathy_dispatch_operation_get_object_path (operation);
462 if (g_hash_table_lookup (cd->dispatched_channels, object_path) == NULL)
465 d = new_dispatch_data (
466 empathy_dispatch_operation_get_channel (operation),
467 empathy_dispatch_operation_get_channel_wrapper (operation));
468 g_hash_table_insert (cd->dispatched_channels,
469 g_strdup (object_path), d);
471 g_hash_table_remove (cd->dispatching_channels, object_path);
473 DEBUG ("Channel claimed: %s", object_path);
477 dispatch_operation_ready_cb (EmpathyDispatchOperation *operation,
478 EmpathyDispatcher *self)
480 EmpathyDispatcherPriv *priv = GET_PRIV (self);
481 TpConnection *connection;
483 EmpathyDispatchOperationState status;
485 g_signal_connect (operation, "approved",
486 G_CALLBACK (dispatch_operation_approved_cb), self);
488 g_signal_connect (operation, "claimed",
489 G_CALLBACK (dispatch_operation_claimed_cb), self);
491 /* Signal the observers */
492 DEBUG ("Send to observers: %s",
493 empathy_dispatch_operation_get_object_path (operation));
494 g_signal_emit (self, signals[OBSERVE], 0, operation);
496 empathy_dispatch_operation_start (operation);
498 /* Signal potential requestors */
499 connection = empathy_dispatch_operation_get_tp_connection (operation);
500 cd = g_hash_table_lookup (priv->connections, connection);
501 g_assert (cd != NULL);
503 g_object_ref (operation);
506 dispatch_operation_flush_requests (self, operation, NULL, cd);
507 status = empathy_dispatch_operation_get_status (operation);
508 g_object_unref (operation);
510 if (status == EMPATHY_DISPATCHER_OPERATION_STATE_CLAIMED)
513 if (status == EMPATHY_DISPATCHER_OPERATION_STATE_APPROVING)
515 DEBUG ("Send to approvers: %s",
516 empathy_dispatch_operation_get_object_path (operation));
517 g_signal_emit (self, signals[APPROVE], 0, operation);
521 g_assert (status == EMPATHY_DISPATCHER_OPERATION_STATE_DISPATCHING);
522 DEBUG ("Send of for dispatching: %s",
523 empathy_dispatch_operation_get_object_path (operation));
524 g_signal_emit (self, signals[DISPATCH], 0, operation);
527 g_object_unref (self);
531 dispatcher_start_dispatching (EmpathyDispatcher *self,
532 EmpathyDispatchOperation *operation,
535 const gchar *object_path =
536 empathy_dispatch_operation_get_object_path (operation);
538 DEBUG ("Dispatching process started for %s", object_path);
540 if (g_hash_table_lookup (cd->dispatching_channels, object_path) == NULL)
542 g_assert (g_hash_table_lookup (cd->outstanding_channels,
543 object_path) == NULL);
545 g_hash_table_insert (cd->dispatching_channels,
546 g_strdup (object_path), operation);
548 switch (empathy_dispatch_operation_get_status (operation))
550 case EMPATHY_DISPATCHER_OPERATION_STATE_PREPARING:
551 g_signal_connect (operation, "ready",
552 G_CALLBACK (dispatch_operation_ready_cb), self);
554 case EMPATHY_DISPATCHER_OPERATION_STATE_PENDING:
555 dispatch_operation_ready_cb (operation, self);
558 g_assert_not_reached ();
562 else if (empathy_dispatch_operation_get_status (operation) >=
563 EMPATHY_DISPATCHER_OPERATION_STATE_PENDING)
565 /* Already dispatching and the operation is pending, thus the observers
566 * have seen it (if applicable), so we can flush the request right away.
568 dispatch_operation_flush_requests (self, operation, NULL, cd);
573 dispatcher_flush_outstanding_operations (EmpathyDispatcher *self,
579 g_hash_table_iter_init (&iter, cd->outstanding_channels);
580 while (g_hash_table_iter_next (&iter, NULL, &value))
582 EmpathyDispatchOperation *operation = EMPATHY_DISPATCH_OPERATION (value);
584 if (dispatcher_operation_can_start (self, operation, cd))
586 g_hash_table_iter_remove (&iter);
587 dispatcher_start_dispatching (self, operation, cd);
593 dispatcher_connection_new_channel (EmpathyDispatcher *self,
594 TpConnection *connection,
595 const gchar *object_path,
596 const gchar *channel_type,
599 GHashTable *properties,
602 EmpathyDispatcherPriv *priv = GET_PRIV (self);
605 EmpathyDispatchOperation *operation;
607 /* Channel types we never want to dispatch because they're either deprecated
608 * or can't sensibly be dispatch (e.g. channels that should always be
610 const char *blacklist[] = {
611 TP_IFACE_CHANNEL_TYPE_CONTACT_LIST,
612 TP_IFACE_CHANNEL_TYPE_TUBES,
613 TP_IFACE_CHANNEL_TYPE_ROOM_LIST,
617 dispatcher_init_connection_if_needed (self, connection);
619 cd = g_hash_table_lookup (priv->connections, connection);
621 /* Don't bother with channels we have already dispatched or are dispatching
622 * currently. This can happen when NewChannel(s) is fired after
623 * RequestChannel/CreateChannel/EnsureChannel */
624 if (g_hash_table_lookup (cd->dispatched_channels, object_path) != NULL)
627 if (g_hash_table_lookup (cd->dispatching_channels, object_path) != NULL)
630 /* Should never occur, but just in case a CM fires spurious NewChannel(s)
632 if (g_hash_table_lookup (cd->outstanding_channels, object_path) != NULL)
635 /* Only pick up non-requested text and file channels. For all other it
636 * doesn't make sense to handle it if we didn't request it. The same goes
637 * for channels we discovered by the Channels property or ListChannels */
638 if (!incoming && tp_strdiff (channel_type, TP_IFACE_CHANNEL_TYPE_TEXT)
639 && tp_strdiff (channel_type, TP_IFACE_CHANNEL_TYPE_FILE_TRANSFER))
641 DEBUG ("Ignoring incoming channel of type %s on %s",
642 channel_type, object_path);
646 for (i = 0 ; blacklist[i] != NULL; i++)
648 if (!tp_strdiff (channel_type, blacklist[i]))
650 DEBUG ("Ignoring blacklisted channel type %s on %s",
651 channel_type, object_path);
656 DEBUG ("New channel of type %s on %s", channel_type, object_path);
658 if (properties == NULL)
659 channel = tp_channel_new (connection, object_path, channel_type,
660 handle_type, handle, NULL);
662 channel = tp_channel_new_from_properties (connection, object_path,
665 g_signal_connect (channel, "invalidated",
666 G_CALLBACK (dispatcher_channel_invalidated_cb),
669 priv->channels = g_list_prepend (priv->channels, channel);
671 operation = empathy_dispatch_operation_new (connection, channel, NULL,
674 g_object_unref (channel);
678 /* Request could either be by us or by a remote party. If there are no
679 * outstanding requests for this channel type we can assume it's remote.
680 * Otherwise we wait untill they are all satisfied */
681 if (dispatcher_operation_can_start (self, operation, cd))
682 dispatcher_start_dispatching (self, operation, cd);
684 g_hash_table_insert (cd->outstanding_channels,
685 g_strdup (object_path), operation);
689 dispatcher_start_dispatching (self, operation, cd);
694 dispatcher_connection_new_channel_with_properties (
695 EmpathyDispatcher *self,
696 TpConnection *connection,
697 const gchar *object_path,
698 GHashTable *properties)
700 const gchar *channel_type;
707 channel_type = tp_asv_get_string (properties,
708 TP_IFACE_CHANNEL ".ChannelType");
709 if (channel_type == NULL)
711 g_message ("%s had an invalid ChannelType property", object_path);
715 handle_type = tp_asv_get_uint32 (properties,
716 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
719 g_message ("%s had an invalid TargetHandleType property", object_path);
723 handle = tp_asv_get_uint32 (properties,
724 TP_IFACE_CHANNEL ".TargetHandle", &valid);
727 g_message ("%s had an invalid TargetHandle property", object_path);
731 /* We assume there is no channel dispather, so we're the only one dispatching
732 * it. Which means that a requested channel it is outgoing one */
733 requested = tp_asv_get_boolean (properties,
734 TP_IFACE_CHANNEL ".Requested", &valid);
737 g_message ("%s had an invalid Requested property", object_path);
741 dispatcher_connection_new_channel (self, connection,
742 object_path, channel_type, handle_type, handle, properties, !requested);
746 dispatcher_connection_got_all (TpProxy *proxy,
747 GHashTable *properties,
752 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
753 EmpathyDispatcherPriv *priv = GET_PRIV (self);
754 GPtrArray *requestable_channels;
755 GPtrArray *existing_channels;
758 DEBUG ("Error: %s", error->message);
762 requestable_channels = tp_asv_get_boxed (properties,
763 "RequestableChannelClasses", TP_ARRAY_TYPE_REQUESTABLE_CHANNEL_CLASS_LIST);
765 if (requestable_channels == NULL)
766 DEBUG ("No RequestableChannelClasses property !?! on connection");
771 FindChannelRequest *request;
774 cd = g_hash_table_lookup (priv->connections, proxy);
775 g_assert (cd != NULL);
777 cd->requestable_channels = g_boxed_copy (
778 TP_ARRAY_TYPE_REQUESTABLE_CHANNEL_CLASS_LIST, requestable_channels);
780 requests = g_hash_table_lookup (priv->outstanding_classes_requests,
783 for (l = requests; l != NULL; l = l->next)
787 retval = empathy_dispatcher_find_channel_classes (self,
788 TP_CONNECTION (proxy), request->channel_type,
789 request->handle_type, request->properties);
790 request->callback (retval, request->user_data);
792 free_find_channel_request (request);
793 g_list_free (retval);
796 g_list_free (requests);
798 g_hash_table_remove (priv->outstanding_classes_requests, proxy);
801 existing_channels = tp_asv_get_boxed (properties,
802 "Channels", TP_ARRAY_TYPE_CHANNEL_DETAILS_LIST);
804 if (existing_channels != NULL)
808 for (idx = 0; idx < existing_channels->len; idx++)
810 GValueArray *values = g_ptr_array_index (existing_channels, idx);
811 const gchar *object_path;
814 object_path = g_value_get_boxed (g_value_array_get_nth (values, 0));
815 props = g_value_get_boxed (g_value_array_get_nth (values, 1));
817 if (tp_strdiff (tp_asv_get_string (props,
818 TP_IFACE_CHANNEL ".ChannelType"),
819 TP_IFACE_CHANNEL_TYPE_TEXT))
822 dispatcher_connection_new_channel_with_properties (self,
823 TP_CONNECTION (proxy), object_path, props);
829 dispatcher_connection_advertise_capabilities_cb (TpConnection *connection,
830 const GPtrArray *capabilities,
836 DEBUG ("Error: %s", error->message);
840 dispatcher_init_connection_if_needed (EmpathyDispatcher *self,
841 TpConnection *connection)
843 EmpathyDispatcherPriv *priv = GET_PRIV (self);
844 GPtrArray *capabilities;
847 const gchar *remove_ = NULL;
849 if (g_hash_table_lookup (priv->connections, connection) != NULL)
852 g_hash_table_insert (priv->connections, g_object_ref (connection),
853 new_connection_data ());
855 g_signal_connect (connection, "invalidated",
856 G_CALLBACK (dispatcher_connection_invalidated_cb), self);
858 if (tp_proxy_has_interface_by_id (TP_PROXY (connection),
859 TP_IFACE_QUARK_CONNECTION_INTERFACE_REQUESTS))
861 tp_cli_dbus_properties_call_get_all (connection, -1,
862 TP_IFACE_CONNECTION_INTERFACE_REQUESTS,
863 dispatcher_connection_got_all,
864 NULL, NULL, G_OBJECT (self));
867 /* Advertise VoIP capabilities */
868 capabilities = g_ptr_array_sized_new (1);
869 cap_type = dbus_g_type_get_struct ("GValueArray", G_TYPE_STRING,
870 G_TYPE_UINT, G_TYPE_INVALID);
871 g_value_init (&cap, cap_type);
872 g_value_take_boxed (&cap, dbus_g_type_specialized_construct (cap_type));
873 dbus_g_type_struct_set (&cap,
874 0, TP_IFACE_CHANNEL_TYPE_STREAMED_MEDIA,
875 1, TP_CHANNEL_MEDIA_CAPABILITY_AUDIO |
876 TP_CHANNEL_MEDIA_CAPABILITY_VIDEO |
877 TP_CHANNEL_MEDIA_CAPABILITY_NAT_TRAVERSAL_STUN |
878 TP_CHANNEL_MEDIA_CAPABILITY_NAT_TRAVERSAL_GTALK_P2P |
879 TP_CHANNEL_MEDIA_CAPABILITY_NAT_TRAVERSAL_ICE_UDP,
881 g_ptr_array_add (capabilities, g_value_get_boxed (&cap));
883 tp_cli_connection_interface_capabilities_call_advertise_capabilities (
884 connection, -1, capabilities, &remove_,
885 dispatcher_connection_advertise_capabilities_cb,
886 NULL, NULL, G_OBJECT (self));
888 g_value_unset (&cap);
889 g_ptr_array_free (capabilities, TRUE);
893 dispatcher_new_connection_cb (EmpathyAccountManager *manager,
894 TpConnection *connection,
895 EmpathyDispatcher *self)
897 dispatcher_init_connection_if_needed (self, connection);
901 remove_idle_handlers (gpointer key,
907 source_id = GPOINTER_TO_UINT (value);
908 g_source_remove (source_id);
912 dispatcher_constructor (GType type,
913 guint n_construct_params,
914 GObjectConstructParam *construct_params)
917 EmpathyDispatcherPriv *priv;
919 if (dispatcher != NULL)
920 return g_object_ref (dispatcher);
922 retval = G_OBJECT_CLASS (empathy_dispatcher_parent_class)->constructor
923 (type, n_construct_params, construct_params);
925 dispatcher = EMPATHY_DISPATCHER (retval);
926 g_object_add_weak_pointer (retval, (gpointer) &dispatcher);
928 priv = GET_PRIV (dispatcher);
930 if (priv->handler == NULL)
931 priv->handler = empathy_handler_new (NULL, NULL, NULL);
933 empathy_handler_set_handle_channels_func (priv->handler,
934 empathy_dispatcher_handle_channels,
937 empathy_handler_set_channels_func (priv->handler,
938 empathy_dispatcher_get_channels,
945 dispatcher_dispose (GObject *object)
947 EmpathyDispatcherPriv *priv = GET_PRIV (object);
952 if (priv->dispose_has_run)
955 priv->dispose_has_run = TRUE;
957 for (l = priv->handlers ; l != NULL; l = g_list_next (l))
958 g_object_unref (G_OBJECT (l->data));
960 g_list_free (priv->handlers);
961 priv->handlers = NULL;
963 if (priv->handler != NULL)
964 g_object_unref (priv->handler);
965 priv->handler = NULL;
967 g_hash_table_iter_init (&iter, priv->connections);
968 while (g_hash_table_iter_next (&iter, &connection, NULL))
970 g_signal_handlers_disconnect_by_func (connection,
971 dispatcher_connection_invalidated_cb, object);
974 g_hash_table_destroy (priv->connections);
975 priv->connections = NULL;
977 G_OBJECT_CLASS (empathy_dispatcher_parent_class)->dispose (object);
981 dispatcher_finalize (GObject *object)
983 EmpathyDispatcherPriv *priv = GET_PRIV (object);
989 if (priv->request_channel_class_async_ids != NULL)
991 g_hash_table_foreach (priv->request_channel_class_async_ids,
992 remove_idle_handlers, NULL);
993 g_hash_table_destroy (priv->request_channel_class_async_ids);
996 g_signal_handlers_disconnect_by_func (priv->account_manager,
997 dispatcher_new_connection_cb, object);
999 for (l = priv->channels; l; l = l->next)
1001 g_signal_handlers_disconnect_by_func (l->data,
1002 dispatcher_channel_invalidated_cb, object);
1005 g_list_free (priv->channels);
1007 g_hash_table_iter_init (&iter, priv->outstanding_classes_requests);
1008 while (g_hash_table_iter_next (&iter, &connection, (gpointer *) &list))
1010 g_list_foreach (list, (GFunc) free_find_channel_request, NULL);
1014 g_object_unref (priv->account_manager);
1016 g_hash_table_destroy (priv->outstanding_classes_requests);
1020 dispatcher_set_property (GObject *object,
1022 const GValue *value,
1025 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1026 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1028 switch (property_id)
1031 priv->handler = g_value_dup_object (value);
1034 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
1040 dispatcher_get_property (GObject *object,
1045 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1046 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1048 switch (property_id)
1051 g_value_set_object (value, priv->handler);
1054 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
1060 empathy_dispatcher_class_init (EmpathyDispatcherClass *klass)
1062 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1063 GParamSpec *param_spec;
1065 object_class->dispose = dispatcher_dispose;
1066 object_class->finalize = dispatcher_finalize;
1067 object_class->constructor = dispatcher_constructor;
1069 object_class->get_property = dispatcher_get_property;
1070 object_class->set_property = dispatcher_set_property;
1072 param_spec = g_param_spec_object ("handler", "handler",
1073 "The main Telepathy Client Hander object",
1074 EMPATHY_TYPE_HANDLER,
1075 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY);
1076 g_object_class_install_property (object_class,
1077 PROP_HANDLER, param_spec);
1080 g_signal_new ("observe",
1081 G_TYPE_FROM_CLASS (klass),
1085 g_cclosure_marshal_VOID__OBJECT,
1087 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1090 g_signal_new ("approve",
1091 G_TYPE_FROM_CLASS (klass),
1095 g_cclosure_marshal_VOID__OBJECT,
1097 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1100 g_signal_new ("dispatch",
1101 G_TYPE_FROM_CLASS (klass),
1105 g_cclosure_marshal_VOID__OBJECT,
1107 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1110 g_type_class_add_private (object_class, sizeof (EmpathyDispatcherPriv));
1114 empathy_dispatcher_init (EmpathyDispatcher *self)
1116 GList *connections, *l;
1117 EmpathyDispatcherPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
1118 EMPATHY_TYPE_DISPATCHER, EmpathyDispatcherPriv);
1121 priv->account_manager = empathy_account_manager_dup_singleton ();
1123 g_signal_connect (priv->account_manager, "new-connection",
1124 G_CALLBACK (dispatcher_new_connection_cb),
1127 priv->connections = g_hash_table_new_full (g_direct_hash, g_direct_equal,
1128 g_object_unref, (GDestroyNotify) free_connection_data);
1130 priv->outstanding_classes_requests = g_hash_table_new_full (g_direct_hash,
1131 g_direct_equal, g_object_unref, NULL);
1133 priv->channels = NULL;
1135 connections = empathy_account_manager_dup_connections (
1136 priv->account_manager);
1137 for (l = connections; l; l = l->next)
1139 dispatcher_new_connection_cb (priv->account_manager, l->data,
1141 g_object_unref (l->data);
1143 g_list_free (connections);
1145 priv->request_channel_class_async_ids = g_hash_table_new (g_direct_hash,
1150 empathy_dispatcher_new (const gchar *name,
1154 EmpathyHandler *handler;
1155 EmpathyDispatcher *ret;
1157 g_assert (dispatcher == NULL);
1158 handler = empathy_handler_new (name, filters, capabilities);
1160 ret = EMPATHY_DISPATCHER (
1161 g_object_new (EMPATHY_TYPE_DISPATCHER,
1164 g_object_unref (handler);
1170 empathy_dispatcher_dup_singleton (void)
1172 return EMPATHY_DISPATCHER (g_object_new (EMPATHY_TYPE_DISPATCHER, NULL));
1176 dispatcher_request_failed (EmpathyDispatcher *self,
1177 DispatcherRequestData *request_data,
1178 const GError *error)
1180 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1181 ConnectionData *conn_data;
1183 conn_data = g_hash_table_lookup (priv->connections,
1184 request_data->connection);
1185 if (request_data->cb != NULL)
1186 request_data->cb (NULL, error, request_data->user_data);
1188 if (conn_data != NULL)
1190 conn_data->outstanding_requests =
1191 g_list_remove (conn_data->outstanding_requests, request_data);
1193 /* else Connection has been invalidated */
1195 free_dispatcher_request_data (request_data);
1199 dispatcher_connection_new_requested_channel (EmpathyDispatcher *self,
1200 DispatcherRequestData *request_data,
1201 const gchar *object_path,
1202 GHashTable *properties,
1203 const GError *error)
1205 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1206 EmpathyDispatchOperation *operation = NULL;
1207 ConnectionData *conn_data;
1209 conn_data = g_hash_table_lookup (priv->connections,
1210 request_data->connection);
1214 DEBUG ("Channel request failed: %s", error->message);
1216 dispatcher_request_failed (self, request_data, error);
1221 operation = g_hash_table_lookup (conn_data->outstanding_channels,
1224 if (operation != NULL)
1225 g_hash_table_remove (conn_data->outstanding_channels, object_path);
1227 operation = g_hash_table_lookup (conn_data->dispatching_channels,
1230 if (operation == NULL)
1232 DispatchData *data = g_hash_table_lookup (conn_data->dispatched_channels,
1237 operation = empathy_dispatch_operation_new_with_wrapper (
1238 request_data->connection,
1239 data->channel, request_data->contact, FALSE,
1240 data->channel_wrapper);
1246 if (properties != NULL)
1247 channel = tp_channel_new_from_properties (request_data->connection,
1248 object_path, properties, NULL);
1250 channel = tp_channel_new (request_data->connection, object_path,
1251 request_data->channel_type, request_data->handle_type,
1252 request_data->handle, NULL);
1254 g_signal_connect (channel, "invalidated",
1255 G_CALLBACK (dispatcher_channel_invalidated_cb),
1256 request_data->dispatcher);
1258 priv->channels = g_list_prepend (priv->channels, channel);
1260 operation = empathy_dispatch_operation_new (request_data->connection,
1261 channel, request_data->contact, FALSE);
1262 g_object_unref (channel);
1267 /* Already existed set potential extra information */
1268 g_object_set (G_OBJECT (operation),
1269 "contact", request_data->contact,
1273 request_data->operation = operation;
1275 /* (pre)-approve this right away as we requested it
1276 * This might cause the channel to be claimed, in which case the operation
1277 * will disappear. So ref it, and check the status before starting the
1280 g_object_ref (operation);
1281 empathy_dispatch_operation_approve (operation);
1283 if (empathy_dispatch_operation_get_status (operation) <
1284 EMPATHY_DISPATCHER_OPERATION_STATE_APPROVING)
1285 dispatcher_start_dispatching (request_data->dispatcher, operation,
1288 g_object_unref (operation);
1291 dispatcher_flush_outstanding_operations (request_data->dispatcher,
1296 dispatcher_request_channel_cb (TpConnection *connection,
1297 const gchar *object_path,
1298 const GError *error,
1300 GObject *weak_object)
1302 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1303 EmpathyDispatcher *self =
1304 EMPATHY_DISPATCHER (request_data->dispatcher);
1306 request_data->pending_call = NULL;
1308 dispatcher_connection_new_requested_channel (self,
1309 request_data, object_path, NULL, error);
1313 dispatcher_request_channel (DispatcherRequestData *request_data)
1315 if (tp_proxy_has_interface_by_id (TP_PROXY (request_data->connection),
1316 TP_IFACE_QUARK_CONNECTION_INTERFACE_REQUESTS))
1318 /* Extend the request_data to be a valid request */
1319 g_assert (request_data->request == NULL);
1320 request_data->request = tp_asv_new (
1321 TP_IFACE_CHANNEL ".ChannelType",
1322 G_TYPE_STRING, request_data->channel_type,
1323 TP_IFACE_CHANNEL ".TargetHandleType",
1324 G_TYPE_UINT, request_data->handle_type,
1327 if (request_data->handle_type != TP_HANDLE_TYPE_NONE)
1328 tp_asv_set_uint32 (request_data->request,
1329 TP_IFACE_CHANNEL ".TargetHandle", request_data->handle);
1331 empathy_dispatcher_call_create_or_ensure_channel (
1332 request_data->dispatcher, request_data);
1336 request_data->pending_call = tp_cli_connection_call_request_channel (
1337 request_data->connection, -1,
1338 request_data->channel_type,
1339 request_data->handle_type,
1340 request_data->handle,
1341 TRUE, dispatcher_request_channel_cb,
1342 request_data, NULL, NULL);
1347 empathy_dispatcher_chat_with_contact (EmpathyContact *contact,
1348 EmpathyDispatcherRequestCb *callback,
1351 EmpathyDispatcher *self;
1352 EmpathyDispatcherPriv *priv;
1353 TpConnection *connection;
1354 ConnectionData *connection_data;
1355 DispatcherRequestData *request_data;
1357 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1359 self = empathy_dispatcher_dup_singleton ();
1360 priv = GET_PRIV (self);
1362 connection = empathy_contact_get_connection (contact);
1363 connection_data = g_hash_table_lookup (priv->connections, connection);
1365 /* The contact handle might not be known yet */
1366 request_data = new_dispatcher_request_data (self, connection,
1367 TP_IFACE_CHANNEL_TYPE_TEXT, TP_HANDLE_TYPE_CONTACT,
1368 empathy_contact_get_handle (contact), NULL, contact, callback, user_data);
1369 request_data->should_ensure = TRUE;
1371 connection_data->outstanding_requests = g_list_prepend
1372 (connection_data->outstanding_requests, request_data);
1374 dispatcher_request_channel (request_data);
1376 g_object_unref (self);
1381 EmpathyDispatcher *dispatcher;
1382 EmpathyDispatcherRequestCb *callback;
1384 } ChatWithContactIdData;
1387 dispatcher_chat_with_contact_id_cb (EmpathyTpContactFactory *factory,
1388 EmpathyContact *contact,
1389 const GError *error,
1391 GObject *weak_object)
1393 ChatWithContactIdData *data = user_data;
1397 /* FIXME: Should call data->callback with the error */
1398 DEBUG ("Error: %s", error->message);
1402 empathy_dispatcher_chat_with_contact (contact, data->callback,
1406 g_object_unref (data->dispatcher);
1407 g_slice_free (ChatWithContactIdData, data);
1411 empathy_dispatcher_chat_with_contact_id (TpConnection *connection,
1412 const gchar *contact_id,
1413 EmpathyDispatcherRequestCb *callback,
1416 EmpathyDispatcher *self;
1417 EmpathyTpContactFactory *factory;
1418 ChatWithContactIdData *data;
1420 g_return_if_fail (TP_IS_CONNECTION (connection));
1421 g_return_if_fail (!EMP_STR_EMPTY (contact_id));
1423 self = empathy_dispatcher_dup_singleton ();
1424 factory = empathy_tp_contact_factory_dup_singleton (connection);
1425 data = g_slice_new0 (ChatWithContactIdData);
1426 data->dispatcher = self;
1427 data->callback = callback;
1428 data->user_data = user_data;
1429 empathy_tp_contact_factory_get_from_id (factory, contact_id,
1430 dispatcher_chat_with_contact_id_cb, data, NULL, NULL);
1432 g_object_unref (factory);
1436 dispatcher_request_handles_cb (TpConnection *connection,
1437 const GArray *handles,
1438 const GError *error,
1442 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1444 request_data->pending_call = NULL;
1448 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1449 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1452 cd = g_hash_table_lookup (priv->connections, request_data->connection);
1454 if (request_data->cb)
1455 request_data->cb (NULL, error, request_data->user_data);
1457 cd->outstanding_requests = g_list_remove (cd->outstanding_requests,
1460 free_dispatcher_request_data (request_data);
1462 dispatcher_flush_outstanding_operations (self, cd);
1466 request_data->handle = g_array_index (handles, guint, 0);
1467 dispatcher_request_channel (request_data);
1471 empathy_dispatcher_join_muc (TpConnection *connection,
1472 const gchar *roomname,
1473 EmpathyDispatcherRequestCb *callback,
1476 EmpathyDispatcher *self;
1477 EmpathyDispatcherPriv *priv;
1478 DispatcherRequestData *request_data;
1479 ConnectionData *connection_data;
1480 const gchar *names[] = { roomname, NULL };
1482 g_return_if_fail (TP_IS_CONNECTION (connection));
1483 g_return_if_fail (!EMP_STR_EMPTY (roomname));
1485 self = empathy_dispatcher_dup_singleton ();
1486 priv = GET_PRIV (self);
1488 connection_data = g_hash_table_lookup (priv->connections, connection);
1490 /* Don't know the room handle yet */
1491 request_data = new_dispatcher_request_data (self, connection,
1492 TP_IFACE_CHANNEL_TYPE_TEXT, TP_HANDLE_TYPE_ROOM, 0, NULL,
1493 NULL, callback, user_data);
1495 connection_data->outstanding_requests = g_list_prepend
1496 (connection_data->outstanding_requests, request_data);
1498 request_data->pending_call = tp_cli_connection_call_request_handles (
1500 TP_HANDLE_TYPE_ROOM, names,
1501 dispatcher_request_handles_cb, request_data, NULL, NULL);
1503 g_object_unref (self);
1507 dispatcher_create_channel_cb (TpConnection *connect,
1508 const gchar *object_path,
1509 GHashTable *properties,
1510 const GError *error,
1512 GObject *weak_object)
1514 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1515 EmpathyDispatcher *self =
1516 EMPATHY_DISPATCHER (request_data->dispatcher);
1518 request_data->pending_call = NULL;
1520 dispatcher_connection_new_requested_channel (self,
1521 request_data, object_path, properties, error);
1525 dispatcher_ensure_channel_cb (TpConnection *connect,
1527 const gchar *object_path,
1528 GHashTable *properties,
1529 const GError *error,
1531 GObject *weak_object)
1533 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1534 EmpathyDispatcher *self =
1535 EMPATHY_DISPATCHER (request_data->dispatcher);
1537 request_data->pending_call = NULL;
1539 dispatcher_connection_new_requested_channel (self,
1540 request_data, object_path, properties, error);
1544 empathy_dispatcher_call_create_or_ensure_channel (
1545 EmpathyDispatcher *self,
1546 DispatcherRequestData *request_data)
1548 if (request_data->should_ensure)
1550 request_data->pending_call =
1551 tp_cli_connection_interface_requests_call_ensure_channel (
1552 request_data->connection, -1,
1553 request_data->request, dispatcher_ensure_channel_cb,
1554 request_data, NULL, NULL);
1558 request_data->pending_call =
1559 tp_cli_connection_interface_requests_call_create_channel (
1560 request_data->connection, -1,
1561 request_data->request, dispatcher_create_channel_cb,
1562 request_data, NULL, NULL);
1567 empathy_dispatcher_create_channel (EmpathyDispatcher *self,
1568 TpConnection *connection,
1569 GHashTable *request,
1570 EmpathyDispatcherRequestCb *callback,
1573 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1574 ConnectionData *connection_data;
1575 DispatcherRequestData *request_data;
1576 const gchar *channel_type;
1581 g_return_if_fail (EMPATHY_IS_DISPATCHER (self));
1582 g_return_if_fail (TP_IS_CONNECTION (connection));
1583 g_return_if_fail (request != NULL);
1585 connection_data = g_hash_table_lookup (priv->connections, connection);
1586 g_assert (connection_data != NULL);
1588 channel_type = tp_asv_get_string (request, TP_IFACE_CHANNEL ".ChannelType");
1590 handle_type = tp_asv_get_uint32 (request,
1591 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
1593 handle_type = TP_UNKNOWN_HANDLE_TYPE;
1595 handle = tp_asv_get_uint32 (request, TP_IFACE_CHANNEL ".TargetHandle", NULL);
1597 request_data = new_dispatcher_request_data (self, connection,
1598 channel_type, handle_type, handle, request,
1599 NULL, callback, user_data);
1601 connection_data->outstanding_requests = g_list_prepend
1602 (connection_data->outstanding_requests, request_data);
1604 empathy_dispatcher_call_create_or_ensure_channel (self, request_data);
1608 channel_class_matches (GValueArray *class,
1609 const char *channel_type,
1611 GArray *fixed_properties)
1619 v = g_value_array_get_nth (class, 0);
1621 /* if the class doesn't match channel type discard it. */
1622 fprops = g_value_get_boxed (v);
1623 c_type = tp_asv_get_string (fprops, TP_IFACE_CHANNEL ".ChannelType");
1625 if (tp_strdiff (channel_type, c_type))
1628 /* we have the right channel type, see if the handle type matches */
1629 h_type = tp_asv_get_uint32 (fprops,
1630 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
1632 if (!valid || handle_type != h_type)
1635 if (fixed_properties != NULL)
1637 gpointer h_key, h_val;
1639 GHashTableIter iter;
1642 g_hash_table_iter_init (&iter, fprops);
1644 while (g_hash_table_iter_next (&iter, &h_key, &h_val))
1646 /* discard ChannelType and TargetHandleType, as we already
1649 if (!tp_strdiff ((char *) h_key, TP_IFACE_CHANNEL ".ChannelType") ||
1651 ((char *) h_key, TP_IFACE_CHANNEL ".TargetHandleType"))
1656 for (idx = 0; idx < fixed_properties->len; idx++)
1658 /* if |key| doesn't exist in |fixed_properties|, discard
1663 g_array_index (fixed_properties, char *, idx)))
1666 /* exit the for() loop */
1677 /* if no fixed_properties are specified, discard the classes
1678 * with some fixed properties other than the two we already
1681 if (g_hash_table_size (fprops) > 2)
1689 empathy_dispatcher_find_channel_classes (EmpathyDispatcher *self,
1690 TpConnection *connection,
1691 const gchar *channel_type,
1693 GArray *fixed_properties)
1695 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1698 GList *matching_classes;
1702 g_return_val_if_fail (channel_type != NULL, NULL);
1703 g_return_val_if_fail (handle_type != 0, NULL);
1705 cd = g_hash_table_lookup (priv->connections, connection);
1710 classes = cd->requestable_channels;
1711 if (classes == NULL)
1714 matching_classes = NULL;
1716 for (i = 0; i < classes->len; i++)
1718 class = g_ptr_array_index (classes, i);
1720 if (!channel_class_matches
1721 (class, channel_type, handle_type, fixed_properties))
1724 matching_classes = g_list_prepend (matching_classes, class);
1727 return matching_classes;
1731 find_channel_class_idle_cb (gpointer user_data)
1735 FindChannelRequest *request = user_data;
1737 gboolean is_ready = TRUE;
1738 EmpathyDispatcherPriv *priv = GET_PRIV (request->dispatcher);
1740 g_hash_table_remove (priv->request_channel_class_async_ids, request);
1742 cd = g_hash_table_lookup (priv->connections, request->connection);
1746 else if (cd->requestable_channels == NULL)
1751 retval = empathy_dispatcher_find_channel_classes (request->dispatcher,
1752 request->connection, request->channel_type, request->handle_type,
1753 request->properties);
1755 request->callback (retval, request->user_data);
1756 free_find_channel_request (request);
1757 g_list_free (retval);
1762 requests = g_hash_table_lookup (priv->outstanding_classes_requests,
1763 request->connection);
1764 requests = g_list_prepend (requests, request);
1766 g_hash_table_insert (priv->outstanding_classes_requests,
1767 request->connection, requests);
1773 setup_varargs (va_list var_args,
1774 const char *channel_namespace,
1775 const char *first_property_name)
1781 if (first_property_name == NULL)
1784 name = first_property_name;
1785 properties = g_array_new (TRUE, TRUE, sizeof (char *));
1787 while (name != NULL)
1789 name_full = g_strdup (name);
1790 properties = g_array_append_val (properties, name_full);
1791 name = va_arg (var_args, char *);
1798 * empathy_dispatcher_find_requestable_channel_classes:
1799 * @dispatcher: an #EmpathyDispatcher
1800 * @connection: a #TpConnection
1801 * @channel_type: a string identifying the type of the channel to lookup
1802 * @handle_type: the handle type for the channel
1803 * @first_property_name: %NULL, or the name of the first fixed property,
1804 * followed optionally by more names, followed by %NULL.
1806 * Returns all the channel classes that a client can request for the connection
1807 * @connection, of the type identified by @channel_type, @handle_type and the
1808 * fixed properties list.
1809 * The classes which are compatible with a fixed properties list (i.e. those
1810 * that will be returned by this function) are intended as those that do not
1811 * contain any fixed property other than those in the list; note that this
1812 * doesn't guarantee that all the classes compatible with the list will contain
1813 * all the requested fixed properties, so the clients will have to filter
1814 * the returned list themselves.
1815 * If @first_property_name is %NULL, only the classes with no other fixed
1816 * properties than ChannelType and TargetHandleType will be returned.
1817 * Note that this function may return %NULL without performing any lookup if
1818 * @connection is not ready. To ensure that @connection is always ready,
1819 * use the empathy_dispatcher_find_requestable_channel_classes_async() variant.
1821 * Return value: a #GList of #GValueArray objects, where the first element in
1822 * the array is a #GHashTable of the fixed properties, and the second is
1823 * a #GStrv of the allowed properties for the class. The list should be free'd
1824 * with g_list_free() when done, but the objects inside the list are owned
1825 * by the #EmpathyDispatcher and must not be modified.
1828 empathy_dispatcher_find_requestable_channel_classes
1829 (EmpathyDispatcher *self,
1830 TpConnection *connection,
1831 const gchar *channel_type,
1833 const char *first_property_name,
1838 EmpathyDispatcherPriv *priv;
1843 g_return_val_if_fail (EMPATHY_IS_DISPATCHER (self), NULL);
1844 g_return_val_if_fail (TP_IS_CONNECTION (connection), NULL);
1845 g_return_val_if_fail (channel_type != NULL, NULL);
1846 g_return_val_if_fail (handle_type != 0, NULL);
1848 priv = GET_PRIV (self);
1850 va_start (var_args, first_property_name);
1852 properties = setup_varargs (var_args, channel_type, first_property_name);
1856 retval = empathy_dispatcher_find_channel_classes (self, connection,
1857 channel_type, handle_type, properties);
1859 if (properties != NULL)
1861 /* free the properties array */
1862 for (idx = 0; idx < properties->len ; idx++)
1864 str = g_array_index (properties, char *, idx);
1868 g_array_free (properties, TRUE);
1875 * empathy_dispatcher_find_requestable_channel_classes_async:
1876 * @dispatcher: an #EmpathyDispatcher
1877 * @connection: a #TpConnection
1878 * @channel_type: a string identifying the type of the channel to lookup
1879 * @handle_type: the handle type for the channel
1880 * @callback: the callback to call when @connection is ready
1881 * @user_data: the user data to pass to @callback
1882 * @first_property_name: %NULL, or the name of the first fixed property,
1883 * followed optionally by more names, followed by %NULL.
1885 * Please see the documentation of
1886 * empathy_dispatcher_find_requestable_channel_classes() for a detailed
1887 * description of this function.
1890 empathy_dispatcher_find_requestable_channel_classes_async
1891 (EmpathyDispatcher *self,
1892 TpConnection *connection,
1893 const gchar *channel_type,
1895 EmpathyDispatcherFindChannelClassCb callback,
1897 const char *first_property_name,
1902 FindChannelRequest *request;
1903 EmpathyDispatcherPriv *priv;
1906 g_return_if_fail (EMPATHY_IS_DISPATCHER (self));
1907 g_return_if_fail (TP_IS_CONNECTION (connection));
1908 g_return_if_fail (channel_type != NULL);
1909 g_return_if_fail (handle_type != 0);
1911 priv = GET_PRIV (self);
1913 va_start (var_args, first_property_name);
1915 properties = setup_varargs (var_args, channel_type, first_property_name);
1919 /* append another request for this connection */
1920 request = g_slice_new0 (FindChannelRequest);
1921 request->dispatcher = g_object_ref (self);
1922 request->channel_type = g_strdup (channel_type);
1923 request->handle_type = handle_type;
1924 request->connection = connection;
1925 request->callback = callback;
1926 request->user_data = user_data;
1927 request->properties = properties;
1929 source_id = g_idle_add (find_channel_class_idle_cb, request);
1931 g_hash_table_insert (priv->request_channel_class_async_ids,
1932 request, GUINT_TO_POINTER (source_id));
1936 empathy_dispatcher_get_channels (EmpathyHandler *handler,
1939 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
1940 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1942 return priv->channels;
1946 empathy_dispatcher_handle_channels (EmpathyHandler *handler,
1947 const gchar *account_path,
1948 const gchar *connection_path,
1949 const GPtrArray *channels,
1950 const GPtrArray *requests_satisfied,
1952 GHashTable *handler_info,
1956 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
1957 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1959 EmpathyAccount *account;
1960 TpConnection *connection;
1962 account = empathy_account_manager_ensure_account (priv->account_manager,
1964 g_assert (account != NULL);
1966 connection = empathy_account_get_connection_for_path (account,
1968 if (connection == NULL)
1970 g_set_error_literal (error, TP_ERRORS, TP_ERROR_INVALID_ARGUMENT,
1971 "Invalid connection argument");
1975 for (i = 0; i < channels->len ; i++)
1977 GValueArray *arr = g_ptr_array_index (channels, i);
1978 const gchar *object_path;
1979 GHashTable *properties;
1981 object_path = g_value_get_boxed (g_value_array_get_nth (arr, 0));
1982 properties = g_value_get_boxed (g_value_array_get_nth (arr, 1));
1984 dispatcher_connection_new_channel_with_properties (self,
1985 connection, object_path, properties);
1993 empathy_dispatcher_add_handler (EmpathyDispatcher *self,
1998 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1999 EmpathyHandler *handler;
2001 handler = empathy_handler_new (name, filters, capabilities);
2002 priv->handlers = g_list_prepend (priv->handlers, handler);
2004 /* Only set the handle_channels function, the Channel property on the main
2005 * handler will always report all dispatched channels even if they came from
2006 * a different Handler */
2007 empathy_handler_set_handle_channels_func (handler,
2008 empathy_dispatcher_handle_channels, self);
2014 empathy_dispatcher_remove_handler (EmpathyDispatcher *self,
2015 EmpathyHandler *handler)
2017 EmpathyDispatcherPriv *priv = GET_PRIV (self);
2020 h = g_list_find (priv->handlers, handler);
2021 g_return_if_fail (h != NULL);
2023 priv->handlers = g_list_delete_link (priv->handlers, h);
2025 g_object_unref (handler);