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/account-manager.h>
32 #include <telepathy-glib/enums.h>
33 #include <telepathy-glib/connection.h>
34 #include <telepathy-glib/util.h>
35 #include <telepathy-glib/dbus.h>
36 #include <telepathy-glib/proxy-subclass.h>
37 #include <telepathy-glib/gtypes.h>
38 #include <telepathy-glib/defs.h>
39 #include <telepathy-glib/svc-client.h>
40 #include <telepathy-glib/svc-generic.h>
41 #include <telepathy-glib/interfaces.h>
43 #include <extensions/extensions.h>
45 #include "empathy-dispatcher.h"
46 #include "empathy-handler.h"
47 #include "empathy-utils.h"
48 #include "empathy-tube-handler.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 TpAccountManager *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_status_changed_cb (TpAccount *account,
897 gchar *dbus_error_name,
899 EmpathyDispatcher *self)
901 TpConnection *conn = tp_account_get_connection (account);
904 dispatcher_init_connection_if_needed (self, conn);
908 remove_idle_handlers (gpointer key,
914 source_id = GPOINTER_TO_UINT (value);
915 g_source_remove (source_id);
919 dispatcher_constructor (GType type,
920 guint n_construct_params,
921 GObjectConstructParam *construct_params)
924 EmpathyDispatcherPriv *priv;
926 if (dispatcher != NULL)
927 return g_object_ref (dispatcher);
929 retval = G_OBJECT_CLASS (empathy_dispatcher_parent_class)->constructor
930 (type, n_construct_params, construct_params);
932 dispatcher = EMPATHY_DISPATCHER (retval);
933 g_object_add_weak_pointer (retval, (gpointer) &dispatcher);
935 priv = GET_PRIV (dispatcher);
937 if (priv->handler == NULL)
938 priv->handler = empathy_handler_new (NULL, NULL, NULL);
940 empathy_handler_set_handle_channels_func (priv->handler,
941 empathy_dispatcher_handle_channels,
944 empathy_handler_set_channels_func (priv->handler,
945 empathy_dispatcher_get_channels,
952 dispatcher_dispose (GObject *object)
954 EmpathyDispatcherPriv *priv = GET_PRIV (object);
959 if (priv->dispose_has_run)
962 priv->dispose_has_run = TRUE;
964 for (l = priv->handlers ; l != NULL; l = g_list_next (l))
965 g_object_unref (G_OBJECT (l->data));
967 g_list_free (priv->handlers);
968 priv->handlers = NULL;
970 if (priv->handler != NULL)
971 g_object_unref (priv->handler);
972 priv->handler = NULL;
974 g_hash_table_iter_init (&iter, priv->connections);
975 while (g_hash_table_iter_next (&iter, &connection, NULL))
977 g_signal_handlers_disconnect_by_func (connection,
978 dispatcher_connection_invalidated_cb, object);
981 g_hash_table_destroy (priv->connections);
982 priv->connections = NULL;
984 G_OBJECT_CLASS (empathy_dispatcher_parent_class)->dispose (object);
988 dispatcher_finalize (GObject *object)
990 EmpathyDispatcherPriv *priv = GET_PRIV (object);
996 if (priv->request_channel_class_async_ids != NULL)
998 g_hash_table_foreach (priv->request_channel_class_async_ids,
999 remove_idle_handlers, NULL);
1000 g_hash_table_destroy (priv->request_channel_class_async_ids);
1003 for (l = priv->channels; l; l = l->next)
1005 g_signal_handlers_disconnect_by_func (l->data,
1006 dispatcher_channel_invalidated_cb, object);
1009 g_list_free (priv->channels);
1011 g_hash_table_iter_init (&iter, priv->outstanding_classes_requests);
1012 while (g_hash_table_iter_next (&iter, &connection, (gpointer *) &list))
1014 g_list_foreach (list, (GFunc) free_find_channel_request, NULL);
1018 g_object_unref (priv->account_manager);
1020 g_hash_table_destroy (priv->outstanding_classes_requests);
1024 dispatcher_set_property (GObject *object,
1026 const GValue *value,
1029 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1030 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1032 switch (property_id)
1035 priv->handler = g_value_dup_object (value);
1038 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
1044 dispatcher_get_property (GObject *object,
1049 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1050 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1052 switch (property_id)
1055 g_value_set_object (value, priv->handler);
1058 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
1064 empathy_dispatcher_class_init (EmpathyDispatcherClass *klass)
1066 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1067 GParamSpec *param_spec;
1069 object_class->dispose = dispatcher_dispose;
1070 object_class->finalize = dispatcher_finalize;
1071 object_class->constructor = dispatcher_constructor;
1073 object_class->get_property = dispatcher_get_property;
1074 object_class->set_property = dispatcher_set_property;
1076 param_spec = g_param_spec_object ("handler", "handler",
1077 "The main Telepathy Client Hander object",
1078 EMPATHY_TYPE_HANDLER,
1079 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY);
1080 g_object_class_install_property (object_class,
1081 PROP_HANDLER, param_spec);
1084 g_signal_new ("observe",
1085 G_TYPE_FROM_CLASS (klass),
1089 g_cclosure_marshal_VOID__OBJECT,
1091 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1094 g_signal_new ("approve",
1095 G_TYPE_FROM_CLASS (klass),
1099 g_cclosure_marshal_VOID__OBJECT,
1101 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1104 g_signal_new ("dispatch",
1105 G_TYPE_FROM_CLASS (klass),
1109 g_cclosure_marshal_VOID__OBJECT,
1111 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1114 g_type_class_add_private (object_class, sizeof (EmpathyDispatcherPriv));
1118 account_manager_prepared_cb (GObject *source_object,
1119 GAsyncResult *result,
1122 GList *accounts, *l;
1123 EmpathyDispatcher *self = user_data;
1124 TpAccountManager *account_manager = TP_ACCOUNT_MANAGER (source_object);
1126 if (!tp_account_manager_prepare_finish (account_manager, result, NULL))
1129 accounts = tp_account_manager_get_valid_accounts (account_manager);
1130 for (l = accounts; l; l = l->next)
1132 TpAccount *a = l->data;
1133 TpConnection *conn = tp_account_get_connection (a);
1136 dispatcher_status_changed_cb (a, 0, 0, 0, NULL, NULL, self);
1138 empathy_signal_connect_weak (a, "status-changed",
1139 G_CALLBACK (dispatcher_status_changed_cb),
1142 g_list_free (accounts);
1146 empathy_dispatcher_init (EmpathyDispatcher *self)
1148 EmpathyDispatcherPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
1149 EMPATHY_TYPE_DISPATCHER, EmpathyDispatcherPriv);
1152 priv->account_manager = tp_account_manager_dup ();
1154 priv->connections = g_hash_table_new_full (g_direct_hash, g_direct_equal,
1155 g_object_unref, (GDestroyNotify) free_connection_data);
1157 priv->outstanding_classes_requests = g_hash_table_new_full (g_direct_hash,
1158 g_direct_equal, g_object_unref, NULL);
1160 priv->channels = NULL;
1162 tp_account_manager_prepare_async (priv->account_manager, NULL,
1163 account_manager_prepared_cb, self);
1165 priv->request_channel_class_async_ids = g_hash_table_new (g_direct_hash,
1170 empathy_dispatcher_new (const gchar *name,
1174 EmpathyHandler *handler;
1175 EmpathyDispatcher *ret;
1177 g_assert (dispatcher == NULL);
1178 handler = empathy_handler_new (name, filters, capabilities);
1180 ret = EMPATHY_DISPATCHER (
1181 g_object_new (EMPATHY_TYPE_DISPATCHER,
1184 g_object_unref (handler);
1190 empathy_dispatcher_dup_singleton (void)
1192 return EMPATHY_DISPATCHER (g_object_new (EMPATHY_TYPE_DISPATCHER, NULL));
1196 dispatcher_request_failed (EmpathyDispatcher *self,
1197 DispatcherRequestData *request_data,
1198 const GError *error)
1200 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1201 ConnectionData *conn_data;
1203 conn_data = g_hash_table_lookup (priv->connections,
1204 request_data->connection);
1205 if (request_data->cb != NULL)
1206 request_data->cb (NULL, error, request_data->user_data);
1208 if (conn_data != NULL)
1210 conn_data->outstanding_requests =
1211 g_list_remove (conn_data->outstanding_requests, request_data);
1213 /* else Connection has been invalidated */
1215 free_dispatcher_request_data (request_data);
1219 dispatcher_connection_new_requested_channel (EmpathyDispatcher *self,
1220 DispatcherRequestData *request_data,
1221 const gchar *object_path,
1222 GHashTable *properties,
1223 const GError *error)
1225 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1226 EmpathyDispatchOperation *operation = NULL;
1227 ConnectionData *conn_data;
1229 conn_data = g_hash_table_lookup (priv->connections,
1230 request_data->connection);
1234 DEBUG ("Channel request failed: %s", error->message);
1236 dispatcher_request_failed (self, request_data, error);
1241 operation = g_hash_table_lookup (conn_data->outstanding_channels,
1244 if (operation != NULL)
1245 g_hash_table_remove (conn_data->outstanding_channels, object_path);
1247 operation = g_hash_table_lookup (conn_data->dispatching_channels,
1250 if (operation == NULL)
1252 DispatchData *data = g_hash_table_lookup (conn_data->dispatched_channels,
1257 operation = empathy_dispatch_operation_new_with_wrapper (
1258 request_data->connection,
1259 data->channel, request_data->contact, FALSE,
1260 data->channel_wrapper);
1266 if (properties != NULL)
1267 channel = tp_channel_new_from_properties (request_data->connection,
1268 object_path, properties, NULL);
1270 channel = tp_channel_new (request_data->connection, object_path,
1271 request_data->channel_type, request_data->handle_type,
1272 request_data->handle, NULL);
1274 g_signal_connect (channel, "invalidated",
1275 G_CALLBACK (dispatcher_channel_invalidated_cb),
1276 request_data->dispatcher);
1278 priv->channels = g_list_prepend (priv->channels, channel);
1280 operation = empathy_dispatch_operation_new (request_data->connection,
1281 channel, request_data->contact, FALSE);
1282 g_object_unref (channel);
1287 /* Already existed set potential extra information */
1288 g_object_set (G_OBJECT (operation),
1289 "contact", request_data->contact,
1293 request_data->operation = operation;
1295 /* (pre)-approve this right away as we requested it
1296 * This might cause the channel to be claimed, in which case the operation
1297 * will disappear. So ref it, and check the status before starting the
1300 g_object_ref (operation);
1301 empathy_dispatch_operation_approve (operation);
1303 if (empathy_dispatch_operation_get_status (operation) <
1304 EMPATHY_DISPATCHER_OPERATION_STATE_APPROVING)
1305 dispatcher_start_dispatching (request_data->dispatcher, operation,
1308 g_object_unref (operation);
1311 dispatcher_flush_outstanding_operations (request_data->dispatcher,
1316 dispatcher_request_channel_cb (TpConnection *connection,
1317 const gchar *object_path,
1318 const GError *error,
1320 GObject *weak_object)
1322 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1323 EmpathyDispatcher *self =
1324 EMPATHY_DISPATCHER (request_data->dispatcher);
1326 request_data->pending_call = NULL;
1328 dispatcher_connection_new_requested_channel (self,
1329 request_data, object_path, NULL, error);
1333 dispatcher_request_channel (DispatcherRequestData *request_data)
1335 if (tp_proxy_has_interface_by_id (TP_PROXY (request_data->connection),
1336 TP_IFACE_QUARK_CONNECTION_INTERFACE_REQUESTS))
1338 /* Extend the request_data to be a valid request */
1339 g_assert (request_data->request == NULL);
1340 request_data->request = tp_asv_new (
1341 TP_IFACE_CHANNEL ".ChannelType",
1342 G_TYPE_STRING, request_data->channel_type,
1343 TP_IFACE_CHANNEL ".TargetHandleType",
1344 G_TYPE_UINT, request_data->handle_type,
1347 if (request_data->handle_type != TP_HANDLE_TYPE_NONE)
1348 tp_asv_set_uint32 (request_data->request,
1349 TP_IFACE_CHANNEL ".TargetHandle", request_data->handle);
1351 empathy_dispatcher_call_create_or_ensure_channel (
1352 request_data->dispatcher, request_data);
1356 request_data->pending_call = tp_cli_connection_call_request_channel (
1357 request_data->connection, -1,
1358 request_data->channel_type,
1359 request_data->handle_type,
1360 request_data->handle,
1361 TRUE, dispatcher_request_channel_cb,
1362 request_data, NULL, NULL);
1367 empathy_dispatcher_chat_with_contact (EmpathyContact *contact,
1368 EmpathyDispatcherRequestCb *callback,
1371 EmpathyDispatcher *self;
1372 EmpathyDispatcherPriv *priv;
1373 TpConnection *connection;
1374 ConnectionData *connection_data;
1375 DispatcherRequestData *request_data;
1377 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1379 self = empathy_dispatcher_dup_singleton ();
1380 priv = GET_PRIV (self);
1382 connection = empathy_contact_get_connection (contact);
1383 connection_data = g_hash_table_lookup (priv->connections, connection);
1385 /* The contact handle might not be known yet */
1386 request_data = new_dispatcher_request_data (self, connection,
1387 TP_IFACE_CHANNEL_TYPE_TEXT, TP_HANDLE_TYPE_CONTACT,
1388 empathy_contact_get_handle (contact), NULL, contact, callback, user_data);
1389 request_data->should_ensure = TRUE;
1391 connection_data->outstanding_requests = g_list_prepend
1392 (connection_data->outstanding_requests, request_data);
1394 dispatcher_request_channel (request_data);
1396 g_object_unref (self);
1401 EmpathyDispatcher *dispatcher;
1402 EmpathyDispatcherRequestCb *callback;
1404 } ChatWithContactIdData;
1407 dispatcher_chat_with_contact_id_cb (EmpathyTpContactFactory *factory,
1408 EmpathyContact *contact,
1409 const GError *error,
1411 GObject *weak_object)
1413 ChatWithContactIdData *data = user_data;
1417 /* FIXME: Should call data->callback with the error */
1418 DEBUG ("Error: %s", error->message);
1422 empathy_dispatcher_chat_with_contact (contact, data->callback,
1426 g_object_unref (data->dispatcher);
1427 g_slice_free (ChatWithContactIdData, data);
1431 empathy_dispatcher_chat_with_contact_id (TpConnection *connection,
1432 const gchar *contact_id,
1433 EmpathyDispatcherRequestCb *callback,
1436 EmpathyDispatcher *self;
1437 EmpathyTpContactFactory *factory;
1438 ChatWithContactIdData *data;
1440 g_return_if_fail (TP_IS_CONNECTION (connection));
1441 g_return_if_fail (!EMP_STR_EMPTY (contact_id));
1443 self = empathy_dispatcher_dup_singleton ();
1444 factory = empathy_tp_contact_factory_dup_singleton (connection);
1445 data = g_slice_new0 (ChatWithContactIdData);
1446 data->dispatcher = self;
1447 data->callback = callback;
1448 data->user_data = user_data;
1449 empathy_tp_contact_factory_get_from_id (factory, contact_id,
1450 dispatcher_chat_with_contact_id_cb, data, NULL, NULL);
1452 g_object_unref (factory);
1456 dispatcher_request_handles_cb (TpConnection *connection,
1457 const GArray *handles,
1458 const GError *error,
1462 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1464 request_data->pending_call = NULL;
1468 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1469 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1472 cd = g_hash_table_lookup (priv->connections, request_data->connection);
1474 if (request_data->cb)
1475 request_data->cb (NULL, error, request_data->user_data);
1477 cd->outstanding_requests = g_list_remove (cd->outstanding_requests,
1480 free_dispatcher_request_data (request_data);
1482 dispatcher_flush_outstanding_operations (self, cd);
1486 request_data->handle = g_array_index (handles, guint, 0);
1487 dispatcher_request_channel (request_data);
1491 empathy_dispatcher_join_muc (TpConnection *connection,
1492 const gchar *roomname,
1493 EmpathyDispatcherRequestCb *callback,
1496 EmpathyDispatcher *self;
1497 EmpathyDispatcherPriv *priv;
1498 DispatcherRequestData *request_data;
1499 ConnectionData *connection_data;
1500 const gchar *names[] = { roomname, NULL };
1502 g_return_if_fail (TP_IS_CONNECTION (connection));
1503 g_return_if_fail (!EMP_STR_EMPTY (roomname));
1505 self = empathy_dispatcher_dup_singleton ();
1506 priv = GET_PRIV (self);
1508 connection_data = g_hash_table_lookup (priv->connections, connection);
1510 /* Don't know the room handle yet */
1511 request_data = new_dispatcher_request_data (self, connection,
1512 TP_IFACE_CHANNEL_TYPE_TEXT, TP_HANDLE_TYPE_ROOM, 0, NULL,
1513 NULL, callback, user_data);
1515 connection_data->outstanding_requests = g_list_prepend
1516 (connection_data->outstanding_requests, request_data);
1518 request_data->pending_call = tp_cli_connection_call_request_handles (
1520 TP_HANDLE_TYPE_ROOM, names,
1521 dispatcher_request_handles_cb, request_data, NULL, NULL);
1523 g_object_unref (self);
1527 dispatcher_create_channel_cb (TpConnection *connect,
1528 const gchar *object_path,
1529 GHashTable *properties,
1530 const GError *error,
1532 GObject *weak_object)
1534 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1535 EmpathyDispatcher *self =
1536 EMPATHY_DISPATCHER (request_data->dispatcher);
1538 request_data->pending_call = NULL;
1540 dispatcher_connection_new_requested_channel (self,
1541 request_data, object_path, properties, error);
1545 dispatcher_ensure_channel_cb (TpConnection *connect,
1547 const gchar *object_path,
1548 GHashTable *properties,
1549 const GError *error,
1551 GObject *weak_object)
1553 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1554 EmpathyDispatcher *self =
1555 EMPATHY_DISPATCHER (request_data->dispatcher);
1557 request_data->pending_call = NULL;
1559 dispatcher_connection_new_requested_channel (self,
1560 request_data, object_path, properties, error);
1564 empathy_dispatcher_call_create_or_ensure_channel (
1565 EmpathyDispatcher *self,
1566 DispatcherRequestData *request_data)
1568 if (request_data->should_ensure)
1570 request_data->pending_call =
1571 tp_cli_connection_interface_requests_call_ensure_channel (
1572 request_data->connection, -1,
1573 request_data->request, dispatcher_ensure_channel_cb,
1574 request_data, NULL, NULL);
1578 request_data->pending_call =
1579 tp_cli_connection_interface_requests_call_create_channel (
1580 request_data->connection, -1,
1581 request_data->request, dispatcher_create_channel_cb,
1582 request_data, NULL, NULL);
1587 empathy_dispatcher_create_channel (EmpathyDispatcher *self,
1588 TpConnection *connection,
1589 GHashTable *request,
1590 EmpathyDispatcherRequestCb *callback,
1593 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1594 ConnectionData *connection_data;
1595 DispatcherRequestData *request_data;
1596 const gchar *channel_type;
1601 g_return_if_fail (EMPATHY_IS_DISPATCHER (self));
1602 g_return_if_fail (TP_IS_CONNECTION (connection));
1603 g_return_if_fail (request != NULL);
1605 connection_data = g_hash_table_lookup (priv->connections, connection);
1606 g_assert (connection_data != NULL);
1608 channel_type = tp_asv_get_string (request, TP_IFACE_CHANNEL ".ChannelType");
1610 handle_type = tp_asv_get_uint32 (request,
1611 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
1613 handle_type = TP_UNKNOWN_HANDLE_TYPE;
1615 handle = tp_asv_get_uint32 (request, TP_IFACE_CHANNEL ".TargetHandle", NULL);
1617 request_data = new_dispatcher_request_data (self, connection,
1618 channel_type, handle_type, handle, request,
1619 NULL, callback, user_data);
1621 connection_data->outstanding_requests = g_list_prepend
1622 (connection_data->outstanding_requests, request_data);
1624 empathy_dispatcher_call_create_or_ensure_channel (self, request_data);
1628 channel_class_matches (GValueArray *class,
1629 const char *channel_type,
1631 GArray *fixed_properties)
1639 v = g_value_array_get_nth (class, 0);
1641 /* if the class doesn't match channel type discard it. */
1642 fprops = g_value_get_boxed (v);
1643 c_type = tp_asv_get_string (fprops, TP_IFACE_CHANNEL ".ChannelType");
1645 if (tp_strdiff (channel_type, c_type))
1648 /* we have the right channel type, see if the handle type matches */
1649 h_type = tp_asv_get_uint32 (fprops,
1650 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
1652 if (!valid || handle_type != h_type)
1655 if (fixed_properties != NULL)
1657 gpointer h_key, h_val;
1659 GHashTableIter iter;
1662 g_hash_table_iter_init (&iter, fprops);
1664 while (g_hash_table_iter_next (&iter, &h_key, &h_val))
1666 /* discard ChannelType and TargetHandleType, as we already
1669 if (!tp_strdiff ((char *) h_key, TP_IFACE_CHANNEL ".ChannelType") ||
1671 ((char *) h_key, TP_IFACE_CHANNEL ".TargetHandleType"))
1676 for (idx = 0; idx < fixed_properties->len; idx++)
1678 /* if |key| doesn't exist in |fixed_properties|, discard
1683 g_array_index (fixed_properties, char *, idx)))
1686 /* exit the for() loop */
1697 /* if no fixed_properties are specified, discard the classes
1698 * with some fixed properties other than the two we already
1701 if (g_hash_table_size (fprops) > 2)
1709 empathy_dispatcher_find_channel_classes (EmpathyDispatcher *self,
1710 TpConnection *connection,
1711 const gchar *channel_type,
1713 GArray *fixed_properties)
1715 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1718 GList *matching_classes;
1722 g_return_val_if_fail (channel_type != NULL, NULL);
1723 g_return_val_if_fail (handle_type != 0, NULL);
1725 cd = g_hash_table_lookup (priv->connections, connection);
1730 classes = cd->requestable_channels;
1731 if (classes == NULL)
1734 matching_classes = NULL;
1736 for (i = 0; i < classes->len; i++)
1738 class = g_ptr_array_index (classes, i);
1740 if (!channel_class_matches
1741 (class, channel_type, handle_type, fixed_properties))
1744 matching_classes = g_list_prepend (matching_classes, class);
1747 return matching_classes;
1751 find_channel_class_idle_cb (gpointer user_data)
1755 FindChannelRequest *request = user_data;
1757 gboolean is_ready = TRUE;
1758 EmpathyDispatcherPriv *priv = GET_PRIV (request->dispatcher);
1760 g_hash_table_remove (priv->request_channel_class_async_ids, request);
1762 cd = g_hash_table_lookup (priv->connections, request->connection);
1766 else if (cd->requestable_channels == NULL)
1771 retval = empathy_dispatcher_find_channel_classes (request->dispatcher,
1772 request->connection, request->channel_type, request->handle_type,
1773 request->properties);
1775 request->callback (retval, request->user_data);
1776 free_find_channel_request (request);
1777 g_list_free (retval);
1782 requests = g_hash_table_lookup (priv->outstanding_classes_requests,
1783 request->connection);
1784 requests = g_list_prepend (requests, request);
1786 g_hash_table_insert (priv->outstanding_classes_requests,
1787 request->connection, requests);
1793 setup_varargs (va_list var_args,
1794 const char *channel_namespace,
1795 const char *first_property_name)
1801 if (first_property_name == NULL)
1804 name = first_property_name;
1805 properties = g_array_new (TRUE, TRUE, sizeof (char *));
1807 while (name != NULL)
1809 name_full = g_strdup (name);
1810 properties = g_array_append_val (properties, name_full);
1811 name = va_arg (var_args, char *);
1818 * empathy_dispatcher_find_requestable_channel_classes:
1819 * @dispatcher: an #EmpathyDispatcher
1820 * @connection: a #TpConnection
1821 * @channel_type: a string identifying the type of the channel to lookup
1822 * @handle_type: the handle type for the channel
1823 * @first_property_name: %NULL, or the name of the first fixed property,
1824 * followed optionally by more names, followed by %NULL.
1826 * Returns all the channel classes that a client can request for the connection
1827 * @connection, of the type identified by @channel_type, @handle_type and the
1828 * fixed properties list.
1829 * The classes which are compatible with a fixed properties list (i.e. those
1830 * that will be returned by this function) are intended as those that do not
1831 * contain any fixed property other than those in the list; note that this
1832 * doesn't guarantee that all the classes compatible with the list will contain
1833 * all the requested fixed properties, so the clients will have to filter
1834 * the returned list themselves.
1835 * If @first_property_name is %NULL, only the classes with no other fixed
1836 * properties than ChannelType and TargetHandleType will be returned.
1837 * Note that this function may return %NULL without performing any lookup if
1838 * @connection is not ready. To ensure that @connection is always ready,
1839 * use the empathy_dispatcher_find_requestable_channel_classes_async() variant.
1841 * Return value: a #GList of #GValueArray objects, where the first element in
1842 * the array is a #GHashTable of the fixed properties, and the second is
1843 * a #GStrv of the allowed properties for the class. The list should be free'd
1844 * with g_list_free() when done, but the objects inside the list are owned
1845 * by the #EmpathyDispatcher and must not be modified.
1848 empathy_dispatcher_find_requestable_channel_classes
1849 (EmpathyDispatcher *self,
1850 TpConnection *connection,
1851 const gchar *channel_type,
1853 const char *first_property_name,
1858 EmpathyDispatcherPriv *priv;
1863 g_return_val_if_fail (EMPATHY_IS_DISPATCHER (self), NULL);
1864 g_return_val_if_fail (TP_IS_CONNECTION (connection), NULL);
1865 g_return_val_if_fail (channel_type != NULL, NULL);
1866 g_return_val_if_fail (handle_type != 0, NULL);
1868 priv = GET_PRIV (self);
1870 va_start (var_args, first_property_name);
1872 properties = setup_varargs (var_args, channel_type, first_property_name);
1876 retval = empathy_dispatcher_find_channel_classes (self, connection,
1877 channel_type, handle_type, properties);
1879 if (properties != NULL)
1881 /* free the properties array */
1882 for (idx = 0; idx < properties->len ; idx++)
1884 str = g_array_index (properties, char *, idx);
1888 g_array_free (properties, TRUE);
1895 * empathy_dispatcher_find_requestable_channel_classes_async:
1896 * @dispatcher: an #EmpathyDispatcher
1897 * @connection: a #TpConnection
1898 * @channel_type: a string identifying the type of the channel to lookup
1899 * @handle_type: the handle type for the channel
1900 * @callback: the callback to call when @connection is ready
1901 * @user_data: the user data to pass to @callback
1902 * @first_property_name: %NULL, or the name of the first fixed property,
1903 * followed optionally by more names, followed by %NULL.
1905 * Please see the documentation of
1906 * empathy_dispatcher_find_requestable_channel_classes() for a detailed
1907 * description of this function.
1910 empathy_dispatcher_find_requestable_channel_classes_async
1911 (EmpathyDispatcher *self,
1912 TpConnection *connection,
1913 const gchar *channel_type,
1915 EmpathyDispatcherFindChannelClassCb callback,
1917 const char *first_property_name,
1922 FindChannelRequest *request;
1923 EmpathyDispatcherPriv *priv;
1926 g_return_if_fail (EMPATHY_IS_DISPATCHER (self));
1927 g_return_if_fail (TP_IS_CONNECTION (connection));
1928 g_return_if_fail (channel_type != NULL);
1929 g_return_if_fail (handle_type != 0);
1931 priv = GET_PRIV (self);
1933 va_start (var_args, first_property_name);
1935 properties = setup_varargs (var_args, channel_type, first_property_name);
1939 /* append another request for this connection */
1940 request = g_slice_new0 (FindChannelRequest);
1941 request->dispatcher = g_object_ref (self);
1942 request->channel_type = g_strdup (channel_type);
1943 request->handle_type = handle_type;
1944 request->connection = connection;
1945 request->callback = callback;
1946 request->user_data = user_data;
1947 request->properties = properties;
1949 source_id = g_idle_add (find_channel_class_idle_cb, request);
1951 g_hash_table_insert (priv->request_channel_class_async_ids,
1952 request, GUINT_TO_POINTER (source_id));
1956 empathy_dispatcher_get_channels (EmpathyHandler *handler,
1959 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
1960 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1962 return priv->channels;
1966 empathy_dispatcher_handle_channels (EmpathyHandler *handler,
1967 const gchar *account_path,
1968 const gchar *connection_path,
1969 const GPtrArray *channels,
1970 const GPtrArray *requests_satisfied,
1972 GHashTable *handler_info,
1976 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
1977 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1980 TpConnection *connection;
1982 /* FIXME: should probably find out whether the account manager is prepared
1983 * before ensuring. */
1984 account = tp_account_manager_ensure_account (priv->account_manager,
1986 g_assert (account != NULL);
1988 connection = tp_account_ensure_connection (account, connection_path);
1989 if (connection == NULL)
1991 g_set_error_literal (error, TP_ERRORS, TP_ERROR_INVALID_ARGUMENT,
1992 "Invalid connection argument");
1996 for (i = 0; i < channels->len ; i++)
1998 GValueArray *arr = g_ptr_array_index (channels, i);
1999 const gchar *object_path;
2000 GHashTable *properties;
2002 object_path = g_value_get_boxed (g_value_array_get_nth (arr, 0));
2003 properties = g_value_get_boxed (g_value_array_get_nth (arr, 1));
2005 dispatcher_connection_new_channel_with_properties (self,
2006 connection, object_path, properties);
2014 empathy_dispatcher_add_handler (EmpathyDispatcher *self,
2019 EmpathyDispatcherPriv *priv = GET_PRIV (self);
2020 EmpathyHandler *handler;
2022 handler = empathy_handler_new (name, filters, capabilities);
2023 priv->handlers = g_list_prepend (priv->handlers, handler);
2025 /* Only set the handle_channels function, the Channel property on the main
2026 * handler will always report all dispatched channels even if they came from
2027 * a different Handler */
2028 empathy_handler_set_handle_channels_func (handler,
2029 empathy_dispatcher_handle_channels, self);
2035 empathy_dispatcher_remove_handler (EmpathyDispatcher *self,
2036 EmpathyHandler *handler)
2038 EmpathyDispatcherPriv *priv = GET_PRIV (self);
2041 h = g_list_find (priv->handlers, handler);
2042 g_return_if_fail (h != NULL);
2044 priv->handlers = g_list_delete_link (priv->handlers, h);
2046 g_object_unref (handler);