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/channel-dispatcher.h>
35 #include <telepathy-glib/channel-request.h>
36 #include <telepathy-glib/util.h>
37 #include <telepathy-glib/dbus.h>
38 #include <telepathy-glib/proxy-subclass.h>
39 #include <telepathy-glib/gtypes.h>
40 #include <telepathy-glib/defs.h>
41 #include <telepathy-glib/svc-client.h>
42 #include <telepathy-glib/svc-generic.h>
43 #include <telepathy-glib/interfaces.h>
45 #include <extensions/extensions.h>
47 #include "empathy-dispatcher.h"
48 #include "empathy-handler.h"
49 #include "empathy-utils.h"
50 #include "empathy-tp-contact-factory.h"
51 #include "empathy-chatroom-manager.h"
52 #include "empathy-utils.h"
54 #define DEBUG_FLAG EMPATHY_DEBUG_DISPATCHER
55 #include <libempathy/empathy-debug.h>
57 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyDispatcher)
60 gboolean dispose_has_run;
62 TpAccountManager *account_manager;
63 /* connection to connection data mapping */
64 GHashTable *connections;
65 GHashTable *outstanding_classes_requests;
68 /* channels which the dispatcher is listening "invalidated" */
73 EmpathyHandler *handler;
78 GHashTable *request_channel_class_async_ids;
79 /* (TpAccount *) => gulong
80 * Signal handler ID of the "status-changed" signal */
81 GHashTable *status_changed_handlers;
83 TpChannelDispatcher *channel_dispatcher;
85 } EmpathyDispatcherPriv;
88 empathy_dispatcher_get_channels (EmpathyHandler *handler,
92 empathy_dispatcher_handle_channels (EmpathyHandler *handler,
93 const gchar *account_path,
94 const gchar *connection_path,
95 const GPtrArray *channels,
96 const GPtrArray *requests_satisfied,
98 GHashTable *handler_info,
102 G_DEFINE_TYPE (EmpathyDispatcher, empathy_dispatcher, G_TYPE_OBJECT);
117 static guint signals[LAST_SIGNAL];
118 static EmpathyDispatcher *dispatcher = NULL;
120 static void dispatcher_init_connection_if_needed (
121 EmpathyDispatcher *dispatcher,
122 TpConnection *connection);
124 static GList * empathy_dispatcher_find_channel_classes
125 (EmpathyDispatcher *dispatcher, TpConnection *connection,
126 const gchar *channel_type, guint handle_type, GArray *fixed_properties);
131 EmpathyDispatcher *dispatcher;
132 EmpathyDispatchOperation *operation;
133 TpConnection *connection;
134 gboolean should_ensure;
138 EmpathyContact *contact;
139 TpProxyPendingCall *pending_call;
141 /* Properties to pass to the channel when requesting it */
144 EmpathyDispatcherRequestCb *cb;
146 gpointer *request_data;
148 TpChannelRequest *channel_request;
149 } DispatcherRequestData;
154 /* Channel type specific wrapper object */
155 GObject *channel_wrapper;
160 /* ObjectPath => DispatchData.. */
161 GHashTable *dispatched_channels;
162 /* ObjectPath -> EmpathyDispatchOperations */
163 GHashTable *dispatching_channels;
165 /* List of DispatcherRequestData */
166 GList *outstanding_requests;
167 /* List of requestable channel classes */
168 GPtrArray *requestable_channels;
173 EmpathyDispatcher *dispatcher;
174 TpConnection *connection;
178 EmpathyDispatcherFindChannelClassCb *callback;
180 } FindChannelRequest;
183 empathy_dispatcher_call_create_or_ensure_channel (
184 EmpathyDispatcher *dispatcher,
185 DispatcherRequestData *request_data);
188 dispatcher_request_failed (EmpathyDispatcher *dispatcher,
189 DispatcherRequestData *request_data,
190 const GError *error);
192 static DispatchData *
193 new_dispatch_data (TpChannel *channel,
194 GObject *channel_wrapper)
196 DispatchData *d = g_slice_new0 (DispatchData);
197 d->channel = g_object_ref (channel);
198 if (channel_wrapper != NULL)
199 d->channel_wrapper = g_object_ref (channel_wrapper);
205 free_dispatch_data (DispatchData *data)
207 g_object_unref (data->channel);
208 if (data->channel_wrapper != NULL)
209 g_object_unref (data->channel_wrapper);
211 g_slice_free (DispatchData, data);
214 static DispatcherRequestData *
215 new_dispatcher_request_data (EmpathyDispatcher *self,
216 TpConnection *connection,
217 const gchar *channel_type,
222 EmpathyContact *contact,
223 EmpathyDispatcherRequestCb *cb,
226 DispatcherRequestData *result = g_slice_new0 (DispatcherRequestData);
228 result->dispatcher = g_object_ref (self);
229 result->connection = connection;
231 result->should_ensure = FALSE;
233 result->channel_type = g_strdup (channel_type);
234 result->handle_type = handle_type;
235 result->handle = handle;
236 result->request = request;
237 result->timestamp = timestamp;
240 result->contact = g_object_ref (contact);
243 result->user_data = user_data;
249 free_dispatcher_request_data (DispatcherRequestData *r)
251 g_free (r->channel_type);
253 if (r->dispatcher != NULL)
254 g_object_unref (r->dispatcher);
256 if (r->contact != NULL)
257 g_object_unref (r->contact);
259 if (r->request != NULL)
260 g_hash_table_unref (r->request);
263 if (r->pending_call != NULL)
264 tp_proxy_pending_call_cancel (r->pending_call);
266 if (r->channel_request != NULL)
267 g_object_unref (r->channel_request);
269 g_slice_free (DispatcherRequestData, r);
272 static ConnectionData *
273 new_connection_data (void)
275 ConnectionData *cd = g_slice_new0 (ConnectionData);
277 cd->dispatched_channels = g_hash_table_new_full (g_str_hash, g_str_equal,
278 g_free, (GDestroyNotify) free_dispatch_data);
280 cd->dispatching_channels = g_hash_table_new_full (g_str_hash, g_str_equal,
281 g_free, g_object_unref);
287 free_connection_data (ConnectionData *cd)
292 g_hash_table_destroy (cd->dispatched_channels);
293 g_hash_table_destroy (cd->dispatching_channels);
295 for (l = cd->outstanding_requests ; l != NULL; l = g_list_delete_link (l,l))
297 free_dispatcher_request_data (l->data);
300 if (cd->requestable_channels != NULL)
302 for (i = 0 ; i < cd->requestable_channels->len ; i++)
304 g_ptr_array_index (cd->requestable_channels, i));
305 g_ptr_array_free (cd->requestable_channels, TRUE);
310 free_find_channel_request (FindChannelRequest *r)
315 g_object_unref (r->dispatcher);
316 g_free (r->channel_type);
318 if (r->properties != NULL)
320 for (idx = 0; idx < r->properties->len ; idx++)
322 str = g_array_index (r->properties, char *, idx);
326 g_array_free (r->properties, TRUE);
329 g_slice_free (FindChannelRequest, r);
333 dispatcher_connection_invalidated_cb (TpConnection *connection,
337 EmpathyDispatcher *self)
339 EmpathyDispatcherPriv *priv = GET_PRIV (self);
340 ConnectionData *connection_data;
342 DEBUG ("Error: %s", message);
344 /* Terminate pending requests, if any */
345 connection_data = g_hash_table_lookup (priv->connections, connection);
346 if (connection_data != NULL)
349 GError *error = NULL;
351 error = g_error_new_literal (domain, code, message);
353 for (l = connection_data->outstanding_requests; l != NULL;
356 DispatcherRequestData *request_data = l->data;
358 if (request_data->cb != NULL)
359 request_data->cb (NULL, error, request_data->user_data);
362 g_error_free (error);
365 g_hash_table_remove (priv->connections, connection);
369 dispatch_operation_flush_requests (EmpathyDispatcher *self,
370 EmpathyDispatchOperation *operation,
376 l = cd->outstanding_requests;
379 DispatcherRequestData *d = (DispatcherRequestData *) l->data;
384 if (d->operation == operation)
389 d->cb (NULL, error, d->user_data);
391 d->cb (operation, NULL, d->user_data);
394 cd->outstanding_requests = g_list_delete_link
395 (cd->outstanding_requests, lt);
397 free_dispatcher_request_data (d);
403 dispatcher_channel_invalidated_cb (TpProxy *proxy,
407 EmpathyDispatcher *self)
409 /* Channel went away... */
410 EmpathyDispatcherPriv *priv = GET_PRIV (self);
411 TpConnection *connection;
413 const gchar *object_path;
415 connection = tp_channel_borrow_connection (TP_CHANNEL (proxy));
417 cd = g_hash_table_lookup (priv->connections, connection);
418 /* Connection itself invalidated? */
422 object_path = tp_proxy_get_object_path (proxy);
424 DEBUG ("Channel %s invalidated", object_path);
426 g_hash_table_remove (cd->dispatched_channels, object_path);
427 g_hash_table_remove (cd->dispatching_channels, object_path);
429 priv->channels = g_list_remove (priv->channels, proxy);
433 dispatch_operation_claimed_cb (EmpathyDispatchOperation *operation,
434 EmpathyDispatcher *self)
436 /* Our job is done, remove the dispatch operation and mark the channel as
438 EmpathyDispatcherPriv *priv = GET_PRIV (self);
439 TpConnection *connection;
441 const gchar *object_path;
443 connection = empathy_dispatch_operation_get_tp_connection (operation);
444 cd = g_hash_table_lookup (priv->connections, connection);
445 g_assert (cd != NULL);
447 object_path = empathy_dispatch_operation_get_object_path (operation);
449 if (g_hash_table_lookup (cd->dispatched_channels, object_path) == NULL)
452 d = new_dispatch_data (
453 empathy_dispatch_operation_get_channel (operation),
454 empathy_dispatch_operation_get_channel_wrapper (operation));
455 g_hash_table_insert (cd->dispatched_channels,
456 g_strdup (object_path), d);
458 g_hash_table_remove (cd->dispatching_channels, object_path);
460 DEBUG ("Channel claimed: %s", object_path);
464 dispatch_operation_ready_cb (EmpathyDispatchOperation *operation,
465 EmpathyDispatcher *self)
467 EmpathyDispatcherPriv *priv = GET_PRIV (self);
468 TpConnection *connection;
470 EmpathyDispatchOperationState status;
472 g_signal_connect (operation, "claimed",
473 G_CALLBACK (dispatch_operation_claimed_cb), self);
475 /* Signal the observers */
476 DEBUG ("Send to observers: %s",
477 empathy_dispatch_operation_get_object_path (operation));
478 g_signal_emit (self, signals[OBSERVE], 0, operation);
480 empathy_dispatch_operation_start (operation);
482 /* Signal potential requestors */
483 connection = empathy_dispatch_operation_get_tp_connection (operation);
484 cd = g_hash_table_lookup (priv->connections, connection);
485 g_assert (cd != NULL);
487 g_object_ref (operation);
490 dispatch_operation_flush_requests (self, operation, NULL, cd);
491 status = empathy_dispatch_operation_get_status (operation);
492 g_object_unref (operation);
494 if (status == EMPATHY_DISPATCHER_OPERATION_STATE_CLAIMED)
497 g_assert (status == EMPATHY_DISPATCHER_OPERATION_STATE_DISPATCHING);
498 DEBUG ("Send of for dispatching: %s",
499 empathy_dispatch_operation_get_object_path (operation));
500 g_signal_emit (self, signals[DISPATCH], 0, operation);
502 g_object_unref (self);
506 dispatcher_start_dispatching (EmpathyDispatcher *self,
507 EmpathyDispatchOperation *operation,
510 const gchar *object_path =
511 empathy_dispatch_operation_get_object_path (operation);
513 DEBUG ("Dispatching process started for %s", object_path);
515 if (g_hash_table_lookup (cd->dispatching_channels, object_path) == NULL)
517 g_hash_table_insert (cd->dispatching_channels,
518 g_strdup (object_path), operation);
520 switch (empathy_dispatch_operation_get_status (operation))
522 case EMPATHY_DISPATCHER_OPERATION_STATE_PREPARING:
523 g_signal_connect (operation, "ready",
524 G_CALLBACK (dispatch_operation_ready_cb), self);
526 case EMPATHY_DISPATCHER_OPERATION_STATE_PENDING:
527 dispatch_operation_ready_cb (operation, self);
530 g_assert_not_reached ();
534 else if (empathy_dispatch_operation_get_status (operation) >=
535 EMPATHY_DISPATCHER_OPERATION_STATE_PENDING)
537 /* Already dispatching and the operation is pending, thus the observers
538 * have seen it (if applicable), so we can flush the request right away.
540 dispatch_operation_flush_requests (self, operation, NULL, cd);
545 dispatcher_connection_new_channel (EmpathyDispatcher *self,
546 TpConnection *connection,
547 const gchar *object_path,
548 const gchar *channel_type,
551 GHashTable *properties,
553 const GPtrArray *requests_satisfied,
556 EmpathyDispatcherPriv *priv = GET_PRIV (self);
559 EmpathyDispatchOperation *operation;
561 /* Channel types we never want to dispatch because they're either deprecated
562 * or can't sensibly be dispatch (e.g. channels that should always be
564 const char *blacklist[] = {
565 TP_IFACE_CHANNEL_TYPE_CONTACT_LIST,
566 TP_IFACE_CHANNEL_TYPE_TUBES,
567 TP_IFACE_CHANNEL_TYPE_ROOM_LIST,
571 dispatcher_init_connection_if_needed (self, connection);
573 cd = g_hash_table_lookup (priv->connections, connection);
575 for (i = 0 ; blacklist[i] != NULL; i++)
577 if (!tp_strdiff (channel_type, blacklist[i]))
579 DEBUG ("Ignoring blacklisted channel type %s on %s",
580 channel_type, object_path);
585 DEBUG ("%s channel of type %s on %s", incoming ? "incoming" : "outgoing",
586 channel_type, object_path);
588 if (properties == NULL)
589 channel = tp_channel_new (connection, object_path, channel_type,
590 handle_type, handle, NULL);
592 channel = tp_channel_new_from_properties (connection, object_path,
595 g_signal_connect (channel, "invalidated",
596 G_CALLBACK (dispatcher_channel_invalidated_cb),
599 priv->channels = g_list_prepend (priv->channels, channel);
601 operation = empathy_dispatch_operation_new (connection, channel, NULL,
602 incoming, timestamp);
604 g_object_unref (channel);
606 if (!incoming && requests_satisfied != NULL)
609 gboolean found = FALSE;
611 l = cd->outstanding_requests;
615 DispatcherRequestData *d = (DispatcherRequestData *) l->data;
620 if (d->request == NULL)
623 if (d->operation != NULL)
626 path = tp_proxy_get_object_path (d->channel_request);
627 for (n = 0; n < requests_satisfied->len ; n++)
629 const gchar *p = g_ptr_array_index (requests_satisfied, n);
630 if (!tp_strdiff (p, path))
632 DEBUG ("Channel satified request %s"
633 "(already dispatched: %d)", p, found);
636 d->operation = operation;
642 GError err = { TP_ERRORS, TP_ERROR_NOT_YOURS,
644 dispatcher_request_failed (dispatcher, d, &err);
651 dispatcher_start_dispatching (dispatcher, operation, cd);
655 dispatcher_connection_new_channel_with_properties (
656 EmpathyDispatcher *self,
657 TpConnection *connection,
658 const gchar *object_path,
659 GHashTable *properties,
660 const GPtrArray *requests_satisfied,
663 const gchar *channel_type;
669 channel_type = tp_asv_get_string (properties,
670 TP_IFACE_CHANNEL ".ChannelType");
671 if (channel_type == NULL)
673 g_message ("%s had an invalid ChannelType property", object_path);
677 handle_type = tp_asv_get_uint32 (properties,
678 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
681 g_message ("%s had an invalid TargetHandleType property", object_path);
685 handle = tp_asv_get_uint32 (properties,
686 TP_IFACE_CHANNEL ".TargetHandle", &valid);
689 g_message ("%s had an invalid TargetHandle property", object_path);
693 /* We assume there is no channel dispather, so we're the only one dispatching
694 * it. Which means that a requested channel it is outgoing one */
695 requested = tp_asv_get_boolean (properties,
696 TP_IFACE_CHANNEL ".Requested", &valid);
699 g_message ("%s had an invalid Requested property", object_path);
703 dispatcher_connection_new_channel (self, connection,
704 object_path, channel_type, handle_type, handle, properties, !requested,
705 requests_satisfied, timestamp);
709 dispatcher_connection_got_all (TpProxy *proxy,
710 GHashTable *properties,
715 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
716 EmpathyDispatcherPriv *priv = GET_PRIV (self);
717 GPtrArray *requestable_channels;
720 DEBUG ("Error: %s", error->message);
724 requestable_channels = tp_asv_get_boxed (properties,
725 "RequestableChannelClasses", TP_ARRAY_TYPE_REQUESTABLE_CHANNEL_CLASS_LIST);
727 if (requestable_channels == NULL)
728 DEBUG ("No RequestableChannelClasses property !?! on connection");
733 FindChannelRequest *request;
736 cd = g_hash_table_lookup (priv->connections, proxy);
737 g_assert (cd != NULL);
739 cd->requestable_channels = g_boxed_copy (
740 TP_ARRAY_TYPE_REQUESTABLE_CHANNEL_CLASS_LIST, requestable_channels);
742 requests = g_hash_table_lookup (priv->outstanding_classes_requests,
745 for (l = requests; l != NULL; l = l->next)
749 retval = empathy_dispatcher_find_channel_classes (self,
750 TP_CONNECTION (proxy), request->channel_type,
751 request->handle_type, request->properties);
752 request->callback (retval, request->user_data);
754 free_find_channel_request (request);
755 g_list_free (retval);
758 g_list_free (requests);
760 g_hash_table_remove (priv->outstanding_classes_requests, proxy);
765 dispatcher_connection_advertise_capabilities_cb (TpConnection *connection,
766 const GPtrArray *capabilities,
772 DEBUG ("Error: %s", error->message);
776 connection_ready_cb (TpConnection *connection,
780 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
781 GPtrArray *capabilities;
784 const gchar *remove_ = NULL;
788 DEBUG ("Error: %s", error->message);
792 tp_cli_dbus_properties_call_get_all (connection, -1,
793 TP_IFACE_CONNECTION_INTERFACE_REQUESTS, dispatcher_connection_got_all,
794 NULL, NULL, G_OBJECT (self));
796 /* Advertise VoIP capabilities */
797 capabilities = g_ptr_array_sized_new (1);
798 cap_type = dbus_g_type_get_struct ("GValueArray", G_TYPE_STRING,
799 G_TYPE_UINT, G_TYPE_INVALID);
800 g_value_init (&cap, cap_type);
801 g_value_take_boxed (&cap, dbus_g_type_specialized_construct (cap_type));
802 dbus_g_type_struct_set (&cap,
803 0, TP_IFACE_CHANNEL_TYPE_STREAMED_MEDIA,
804 1, TP_CHANNEL_MEDIA_CAPABILITY_AUDIO |
805 TP_CHANNEL_MEDIA_CAPABILITY_VIDEO |
806 TP_CHANNEL_MEDIA_CAPABILITY_NAT_TRAVERSAL_STUN |
807 TP_CHANNEL_MEDIA_CAPABILITY_NAT_TRAVERSAL_GTALK_P2P |
808 TP_CHANNEL_MEDIA_CAPABILITY_NAT_TRAVERSAL_ICE_UDP,
810 g_ptr_array_add (capabilities, g_value_get_boxed (&cap));
812 tp_cli_connection_interface_capabilities_call_advertise_capabilities (
813 connection, -1, capabilities, &remove_,
814 dispatcher_connection_advertise_capabilities_cb,
815 NULL, NULL, G_OBJECT (self));
817 g_value_unset (&cap);
818 g_ptr_array_free (capabilities, TRUE);
820 g_object_unref (self);
824 dispatcher_init_connection_if_needed (EmpathyDispatcher *self,
825 TpConnection *connection)
827 EmpathyDispatcherPriv *priv = GET_PRIV (self);
829 if (g_hash_table_lookup (priv->connections, connection) != NULL)
832 g_hash_table_insert (priv->connections, g_object_ref (connection),
833 new_connection_data ());
835 g_signal_connect (connection, "invalidated",
836 G_CALLBACK (dispatcher_connection_invalidated_cb), self);
838 /* Ensure to keep the self object alive while the call_when_ready is
841 tp_connection_call_when_ready (connection, connection_ready_cb, self);
845 dispatcher_status_changed_cb (TpAccount *account,
849 gchar *dbus_error_name,
851 EmpathyDispatcher *self)
853 TpConnection *conn = tp_account_get_connection (account);
856 dispatcher_init_connection_if_needed (self, conn);
860 remove_idle_handlers (gpointer key,
866 source_id = GPOINTER_TO_UINT (value);
867 g_source_remove (source_id);
871 dispatcher_constructor (GType type,
872 guint n_construct_params,
873 GObjectConstructParam *construct_params)
876 EmpathyDispatcherPriv *priv;
878 if (dispatcher != NULL)
879 return g_object_ref (dispatcher);
881 retval = G_OBJECT_CLASS (empathy_dispatcher_parent_class)->constructor
882 (type, n_construct_params, construct_params);
884 dispatcher = EMPATHY_DISPATCHER (retval);
885 g_object_add_weak_pointer (retval, (gpointer) &dispatcher);
887 priv = GET_PRIV (dispatcher);
889 if (priv->handler == NULL)
890 priv->handler = empathy_handler_new (NULL, NULL, NULL);
892 empathy_handler_set_handle_channels_func (priv->handler,
893 empathy_dispatcher_handle_channels,
896 empathy_handler_set_channels_func (priv->handler,
897 empathy_dispatcher_get_channels,
904 dispatcher_dispose (GObject *object)
906 EmpathyDispatcherPriv *priv = GET_PRIV (object);
911 if (priv->dispose_has_run)
914 priv->dispose_has_run = TRUE;
916 for (l = priv->handlers ; l != NULL; l = g_list_next (l))
917 g_object_unref (G_OBJECT (l->data));
919 g_list_free (priv->handlers);
920 priv->handlers = NULL;
922 if (priv->handler != NULL)
923 g_object_unref (priv->handler);
924 priv->handler = NULL;
926 g_hash_table_iter_init (&iter, priv->connections);
927 while (g_hash_table_iter_next (&iter, &connection, NULL))
929 g_signal_handlers_disconnect_by_func (connection,
930 dispatcher_connection_invalidated_cb, object);
933 g_hash_table_destroy (priv->connections);
934 priv->connections = NULL;
936 if (priv->channel_dispatcher != NULL)
937 g_object_unref (priv->channel_dispatcher);
938 priv->channel_dispatcher = NULL;
940 if (priv->dbus != NULL)
941 g_object_unref (priv->dbus);
944 G_OBJECT_CLASS (empathy_dispatcher_parent_class)->dispose (object);
948 dispatcher_finalize (GObject *object)
950 EmpathyDispatcherPriv *priv = GET_PRIV (object);
955 gpointer account, id;
957 if (priv->request_channel_class_async_ids != NULL)
959 g_hash_table_foreach (priv->request_channel_class_async_ids,
960 remove_idle_handlers, NULL);
961 g_hash_table_destroy (priv->request_channel_class_async_ids);
964 for (l = priv->channels; l; l = l->next)
966 g_signal_handlers_disconnect_by_func (l->data,
967 dispatcher_channel_invalidated_cb, object);
970 g_list_free (priv->channels);
972 g_hash_table_iter_init (&iter, priv->outstanding_classes_requests);
973 while (g_hash_table_iter_next (&iter, &connection, (gpointer *) &list))
975 g_list_foreach (list, (GFunc) free_find_channel_request, NULL);
979 g_hash_table_iter_init (&iter, priv->status_changed_handlers);
980 while (g_hash_table_iter_next (&iter, &account, &id))
982 g_signal_handler_disconnect (account, GPOINTER_TO_UINT (id));
984 g_hash_table_destroy (priv->status_changed_handlers);
986 g_object_unref (priv->account_manager);
988 g_hash_table_destroy (priv->outstanding_classes_requests);
992 dispatcher_set_property (GObject *object,
997 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
998 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1000 switch (property_id)
1003 priv->handler = g_value_dup_object (value);
1006 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
1012 dispatcher_get_property (GObject *object,
1017 EmpathyDispatcher *self = EMPATHY_DISPATCHER (object);
1018 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1020 switch (property_id)
1023 g_value_set_object (value, priv->handler);
1026 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
1032 empathy_dispatcher_class_init (EmpathyDispatcherClass *klass)
1034 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1035 GParamSpec *param_spec;
1037 object_class->dispose = dispatcher_dispose;
1038 object_class->finalize = dispatcher_finalize;
1039 object_class->constructor = dispatcher_constructor;
1041 object_class->get_property = dispatcher_get_property;
1042 object_class->set_property = dispatcher_set_property;
1044 param_spec = g_param_spec_object ("handler", "handler",
1045 "The main Telepathy Client Hander object",
1046 EMPATHY_TYPE_HANDLER,
1047 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY);
1048 g_object_class_install_property (object_class,
1049 PROP_HANDLER, param_spec);
1052 g_signal_new ("observe",
1053 G_TYPE_FROM_CLASS (klass),
1057 g_cclosure_marshal_VOID__OBJECT,
1059 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1062 g_signal_new ("dispatch",
1063 G_TYPE_FROM_CLASS (klass),
1067 g_cclosure_marshal_VOID__OBJECT,
1069 1, EMPATHY_TYPE_DISPATCH_OPERATION);
1072 g_type_class_add_private (object_class, sizeof (EmpathyDispatcherPriv));
1076 connect_account (EmpathyDispatcher *self,
1079 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1080 TpConnection *conn = tp_account_get_connection (account);
1083 id = GPOINTER_TO_UINT (g_hash_table_lookup (priv->status_changed_handlers,
1090 dispatcher_status_changed_cb (account, 0, 0, 0, NULL, NULL, self);
1092 id = g_signal_connect (account, "status-changed",
1093 G_CALLBACK (dispatcher_status_changed_cb), self);
1095 g_hash_table_insert (priv->status_changed_handlers, account,
1096 GUINT_TO_POINTER (id));
1100 account_manager_prepared_cb (GObject *source_object,
1101 GAsyncResult *result,
1104 GList *accounts, *l;
1105 EmpathyDispatcher *self = user_data;
1106 TpAccountManager *account_manager = TP_ACCOUNT_MANAGER (source_object);
1107 GError *error = NULL;
1109 if (!tp_account_manager_prepare_finish (account_manager, result, &error))
1111 DEBUG ("Failed to prepare account manager: %s", error->message);
1112 g_error_free (error);
1116 accounts = tp_account_manager_get_valid_accounts (account_manager);
1117 for (l = accounts; l; l = l->next)
1119 TpAccount *a = l->data;
1121 connect_account (self, a);
1123 g_list_free (accounts);
1127 account_prepare_cb (GObject *source_object,
1128 GAsyncResult *result,
1131 EmpathyDispatcher *self = user_data;
1132 TpAccount *account = TP_ACCOUNT (source_object);
1133 GError *error = NULL;
1135 if (!tp_account_prepare_finish (account, result, &error))
1137 DEBUG ("Failed to prepare account: %s", error->message);
1138 g_error_free (error);
1142 connect_account (self, account);
1146 account_validity_changed_cb (TpAccountManager *manager,
1154 tp_account_prepare_async (account, NULL, account_prepare_cb, user_data);
1158 empathy_dispatcher_init (EmpathyDispatcher *self)
1160 EmpathyDispatcherPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
1161 EMPATHY_TYPE_DISPATCHER, EmpathyDispatcherPriv);
1164 priv->account_manager = tp_account_manager_dup ();
1166 priv->connections = g_hash_table_new_full (g_direct_hash, g_direct_equal,
1167 g_object_unref, (GDestroyNotify) free_connection_data);
1169 priv->outstanding_classes_requests = g_hash_table_new_full (g_direct_hash,
1170 g_direct_equal, g_object_unref, NULL);
1172 priv->channels = NULL;
1174 tp_account_manager_prepare_async (priv->account_manager, NULL,
1175 account_manager_prepared_cb, self);
1177 tp_g_signal_connect_object (priv->account_manager,
1178 "account-validity-changed", G_CALLBACK (account_validity_changed_cb),
1181 priv->request_channel_class_async_ids = g_hash_table_new (g_direct_hash,
1183 priv->status_changed_handlers = g_hash_table_new (g_direct_hash,
1186 priv->dbus = tp_dbus_daemon_dup (NULL);
1187 priv->channel_dispatcher = tp_channel_dispatcher_new (priv->dbus);
1191 empathy_dispatcher_new (const gchar *name,
1195 EmpathyHandler *handler;
1196 EmpathyDispatcher *ret;
1198 g_assert (dispatcher == NULL);
1199 handler = empathy_handler_new (name, filters, capabilities);
1201 ret = EMPATHY_DISPATCHER (
1202 g_object_new (EMPATHY_TYPE_DISPATCHER,
1205 g_object_unref (handler);
1211 empathy_dispatcher_dup_singleton (void)
1213 return EMPATHY_DISPATCHER (g_object_new (EMPATHY_TYPE_DISPATCHER, NULL));
1217 dispatcher_request_failed (EmpathyDispatcher *self,
1218 DispatcherRequestData *request_data,
1219 const GError *error)
1221 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1222 ConnectionData *conn_data;
1224 conn_data = g_hash_table_lookup (priv->connections,
1225 request_data->connection);
1226 if (request_data->cb != NULL)
1227 request_data->cb (NULL, error, request_data->user_data);
1229 if (conn_data != NULL)
1231 conn_data->outstanding_requests =
1232 g_list_remove (conn_data->outstanding_requests, request_data);
1234 /* else Connection has been invalidated */
1236 free_dispatcher_request_data (request_data);
1240 dispatcher_request_channel (DispatcherRequestData *request_data)
1242 /* Extend the request_data to be a valid request */
1243 g_assert (request_data->request == NULL);
1244 request_data->request = tp_asv_new (
1245 TP_IFACE_CHANNEL ".ChannelType",
1246 G_TYPE_STRING, request_data->channel_type,
1247 TP_IFACE_CHANNEL ".TargetHandleType",
1248 G_TYPE_UINT, request_data->handle_type,
1251 if (request_data->handle_type != TP_HANDLE_TYPE_NONE)
1252 tp_asv_set_uint32 (request_data->request, TP_IFACE_CHANNEL ".TargetHandle",
1253 request_data->handle);
1255 empathy_dispatcher_call_create_or_ensure_channel (request_data->dispatcher,
1260 empathy_dispatcher_chat_with_contact (EmpathyContact *contact,
1262 EmpathyDispatcherRequestCb *callback,
1265 EmpathyDispatcher *self;
1266 EmpathyDispatcherPriv *priv;
1267 TpConnection *connection;
1268 ConnectionData *connection_data;
1269 DispatcherRequestData *request_data;
1271 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1273 self = empathy_dispatcher_dup_singleton ();
1274 priv = GET_PRIV (self);
1276 connection = empathy_contact_get_connection (contact);
1277 connection_data = g_hash_table_lookup (priv->connections, connection);
1278 if (connection_data == NULL)
1280 /* Connection has been invalidated */
1281 if (callback != NULL)
1283 GError error = { TP_DBUS_ERRORS, TP_DBUS_ERROR_PROXY_UNREFERENCED,
1284 "Connection has been invalidated" };
1285 callback (NULL, &error, user_data);
1290 /* The contact handle might not be known yet */
1291 request_data = new_dispatcher_request_data (self, connection,
1292 TP_IFACE_CHANNEL_TYPE_TEXT, TP_HANDLE_TYPE_CONTACT,
1293 empathy_contact_get_handle (contact), NULL, timestamp, contact,
1294 callback, user_data);
1295 request_data->should_ensure = TRUE;
1297 connection_data->outstanding_requests = g_list_prepend
1298 (connection_data->outstanding_requests, request_data);
1300 dispatcher_request_channel (request_data);
1303 g_object_unref (self);
1308 EmpathyDispatcher *dispatcher;
1309 EmpathyDispatcherRequestCb *callback;
1312 } ChatWithContactIdData;
1315 dispatcher_chat_with_contact_id_cb (TpConnection *connection,
1316 EmpathyContact *contact,
1317 const GError *error,
1319 GObject *weak_object)
1321 ChatWithContactIdData *data = user_data;
1325 DEBUG ("Error: %s", error->message);
1327 if (data->callback != NULL)
1329 data->callback (NULL, error, data->user_data);
1334 empathy_dispatcher_chat_with_contact (contact, data->timestamp,
1335 data->callback, data->user_data);
1338 g_object_unref (data->dispatcher);
1339 g_slice_free (ChatWithContactIdData, data);
1343 empathy_dispatcher_chat_with_contact_id (TpConnection *connection,
1344 const gchar *contact_id,
1346 EmpathyDispatcherRequestCb *callback,
1349 EmpathyDispatcher *self;
1350 ChatWithContactIdData *data;
1352 g_return_if_fail (TP_IS_CONNECTION (connection));
1353 g_return_if_fail (!EMP_STR_EMPTY (contact_id));
1355 self = empathy_dispatcher_dup_singleton ();
1356 data = g_slice_new0 (ChatWithContactIdData);
1357 data->dispatcher = self;
1358 data->callback = callback;
1359 data->user_data = user_data;
1360 data->timestamp = timestamp;
1361 empathy_tp_contact_factory_get_from_id (connection, contact_id,
1362 dispatcher_chat_with_contact_id_cb, data, NULL, NULL);
1366 dispatcher_request_handles_cb (TpConnection *connection,
1367 const GArray *handles,
1368 const GError *error,
1372 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1374 request_data->pending_call = NULL;
1378 EmpathyDispatcher *self = request_data->dispatcher;
1379 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1382 cd = g_hash_table_lookup (priv->connections, request_data->connection);
1384 if (request_data->cb)
1385 request_data->cb (NULL, error, request_data->user_data);
1387 cd->outstanding_requests = g_list_remove (cd->outstanding_requests,
1390 free_dispatcher_request_data (request_data);
1394 request_data->handle = g_array_index (handles, guint, 0);
1395 dispatcher_request_channel (request_data);
1399 empathy_dispatcher_join_muc (TpConnection *connection,
1400 const gchar *roomname,
1402 EmpathyDispatcherRequestCb *callback,
1405 EmpathyDispatcher *self;
1406 EmpathyDispatcherPriv *priv;
1407 DispatcherRequestData *request_data;
1408 ConnectionData *connection_data;
1409 const gchar *names[] = { roomname, NULL };
1410 TpProxyPendingCall *call;
1412 g_return_if_fail (TP_IS_CONNECTION (connection));
1413 g_return_if_fail (!EMP_STR_EMPTY (roomname));
1415 self = empathy_dispatcher_dup_singleton ();
1416 priv = GET_PRIV (self);
1418 connection_data = g_hash_table_lookup (priv->connections, connection);
1419 g_assert (connection_data != NULL);
1421 /* Don't know the room handle yet */
1422 request_data = new_dispatcher_request_data (self, connection,
1423 TP_IFACE_CHANNEL_TYPE_TEXT, TP_HANDLE_TYPE_ROOM, 0, NULL, timestamp,
1424 NULL, callback, user_data);
1425 request_data->should_ensure = TRUE;
1427 connection_data->outstanding_requests = g_list_prepend
1428 (connection_data->outstanding_requests, request_data);
1430 call = tp_cli_connection_call_request_handles (
1432 TP_HANDLE_TYPE_ROOM, names,
1433 dispatcher_request_handles_cb, request_data, NULL, NULL);
1436 request_data->pending_call = call;
1438 g_object_unref (self);
1442 dispatcher_channel_request_failed_cb (TpChannelRequest *request,
1444 const gchar *message,
1446 GObject *weak_object)
1448 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1449 EmpathyDispatcher *self =
1450 EMPATHY_DISPATCHER (request_data->dispatcher);
1453 request_data->pending_call = NULL;
1455 DEBUG ("Request failed: %s - %s %s",
1456 tp_proxy_get_object_path (request),
1459 tp_proxy_dbus_error_to_gerror (TP_PROXY (request),
1460 error, message, &err);
1462 dispatcher_request_failed (self, request_data, err);
1468 dispatcher_channel_request_succeeded_cb (TpChannelRequest *request,
1470 GObject *weak_object)
1472 EmpathyDispatcher *self = EMPATHY_DISPATCHER (weak_object);
1473 EmpathyDispatcherPriv *priv = GET_PRIV (dispatcher);
1474 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1475 ConnectionData *conn_data;
1477 conn_data = g_hash_table_lookup (priv->connections,
1478 request_data->connection);
1480 DEBUG ("Request succeeded: %s", tp_proxy_get_object_path (request));
1482 /* When success gets called the internal request should have been satisfied,
1483 * if it's still in outstanding_requests and doesn't have an operation
1484 * assigned to it, the channel got handled by someone else.. */
1486 if (g_list_find (conn_data->outstanding_requests, request_data) == NULL)
1489 if (request_data->operation == NULL)
1491 GError err = { TP_ERRORS, TP_ERROR_NOT_YOURS, "Not yours!" };
1492 dispatcher_request_failed (self, request_data, &err);
1497 dispatcher_channel_request_proceed_cb (TpChannelRequest *request,
1498 const GError *error,
1500 GObject *weak_object)
1502 EmpathyDispatcher *self = EMPATHY_DISPATCHER (weak_object);
1503 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1505 request_data->pending_call = NULL;
1508 dispatcher_request_failed (self, request_data, error);
1512 dispatcher_create_channel_cb (TpChannelDispatcher *proxy,
1513 const gchar *request_path,
1514 const GError *error,
1516 GObject *weak_object)
1518 DispatcherRequestData *request_data = (DispatcherRequestData *) user_data;
1519 EmpathyDispatcher *self = EMPATHY_DISPATCHER (request_data->dispatcher);
1520 EmpathyDispatcherPriv *priv = GET_PRIV (dispatcher);
1521 TpChannelRequest *request;
1523 TpProxyPendingCall *call;
1525 request_data->pending_call = NULL;
1529 dispatcher_request_failed (self, request_data, error);
1533 request = tp_channel_request_new (priv->dbus, request_path, NULL, NULL);
1534 request_data->channel_request = request;
1536 if (tp_cli_channel_request_connect_to_failed (request,
1537 dispatcher_channel_request_failed_cb, request_data,
1538 NULL, G_OBJECT (self), &err) == NULL)
1540 dispatcher_request_failed (self, request_data, err);
1545 if (tp_cli_channel_request_connect_to_succeeded (request,
1546 dispatcher_channel_request_succeeded_cb, request_data,
1547 NULL, G_OBJECT (self), &err) == NULL)
1549 dispatcher_request_failed (self, request_data, err);
1554 call = tp_cli_channel_request_call_proceed (request,
1555 -1, dispatcher_channel_request_proceed_cb,
1556 request_data, NULL, G_OBJECT (self));
1559 request_data->pending_call = call;
1563 empathy_dispatcher_call_create_or_ensure_channel (
1564 EmpathyDispatcher *self,
1565 DispatcherRequestData *request_data)
1567 EmpathyDispatcherPriv *priv = GET_PRIV (dispatcher);
1569 const gchar *handler = "";
1570 TpProxyPendingCall *call;
1572 account = empathy_get_account_for_connection (request_data->connection);
1574 g_assert (account != NULL);
1576 if (request_data->cb)
1577 handler = empathy_handler_get_busname (priv->handler);
1579 if (request_data->should_ensure)
1581 call = tp_cli_channel_dispatcher_call_ensure_channel (
1582 priv->channel_dispatcher,
1583 -1, tp_proxy_get_object_path (TP_PROXY (account)),
1584 request_data->request, request_data->timestamp, handler,
1585 dispatcher_create_channel_cb, request_data, NULL, NULL);
1589 call = tp_cli_channel_dispatcher_call_create_channel (
1590 priv->channel_dispatcher,
1591 -1, tp_proxy_get_object_path (TP_PROXY (account)),
1592 request_data->request, request_data->timestamp, handler,
1593 dispatcher_create_channel_cb, request_data, NULL,
1594 G_OBJECT (dispatcher));
1598 request_data->pending_call = call;
1602 * empathy_dispatcher_create_channel:
1603 * @self: the EmpathyDispatcher
1604 * @connection: the Connection to dispatch on
1605 * @request: an a{sv} map of properties for the request, i.e. using tp_asv_new()
1606 * @callback: a callback for when the channel arrives (or NULL)
1607 * @user_data: optional user data (or NULL)
1609 * When calling this function, #EmpathyDispatcher takes ownership of your
1610 * reference to @request. DO NOT unref or destroy @request. When the request is
1611 * done, @request will be unreferenced. Take another reference if you want to
1615 empathy_dispatcher_create_channel (EmpathyDispatcher *self,
1616 TpConnection *connection,
1617 GHashTable *request,
1619 EmpathyDispatcherRequestCb *callback,
1622 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1623 ConnectionData *connection_data;
1624 DispatcherRequestData *request_data;
1625 const gchar *channel_type;
1630 g_return_if_fail (EMPATHY_IS_DISPATCHER (self));
1631 g_return_if_fail (TP_IS_CONNECTION (connection));
1632 g_return_if_fail (request != NULL);
1634 connection_data = g_hash_table_lookup (priv->connections, connection);
1635 g_assert (connection_data != NULL);
1637 channel_type = tp_asv_get_string (request, TP_IFACE_CHANNEL ".ChannelType");
1639 handle_type = tp_asv_get_uint32 (request,
1640 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
1642 handle_type = TP_UNKNOWN_HANDLE_TYPE;
1644 handle = tp_asv_get_uint32 (request, TP_IFACE_CHANNEL ".TargetHandle", NULL);
1646 request_data = new_dispatcher_request_data (self, connection,
1647 channel_type, handle_type, handle, request, timestamp,
1648 NULL, callback, user_data);
1650 connection_data->outstanding_requests = g_list_prepend
1651 (connection_data->outstanding_requests, request_data);
1653 empathy_dispatcher_call_create_or_ensure_channel (self, request_data);
1657 channel_class_matches (GValueArray *class,
1658 const char *channel_type,
1660 GArray *fixed_properties)
1668 v = g_value_array_get_nth (class, 0);
1670 /* if the class doesn't match channel type discard it. */
1671 fprops = g_value_get_boxed (v);
1672 c_type = tp_asv_get_string (fprops, TP_IFACE_CHANNEL ".ChannelType");
1674 if (tp_strdiff (channel_type, c_type))
1677 /* we have the right channel type, see if the handle type matches */
1678 h_type = tp_asv_get_uint32 (fprops,
1679 TP_IFACE_CHANNEL ".TargetHandleType", &valid);
1681 if (!valid || (handle_type != h_type && handle_type != TP_UNKNOWN_HANDLE_TYPE))
1684 if (fixed_properties != NULL)
1686 gpointer h_key, h_val;
1688 GHashTableIter iter;
1691 g_hash_table_iter_init (&iter, fprops);
1693 while (g_hash_table_iter_next (&iter, &h_key, &h_val))
1695 /* discard ChannelType and TargetHandleType, as we already
1698 if (!tp_strdiff ((char *) h_key, TP_IFACE_CHANNEL ".ChannelType") ||
1700 ((char *) h_key, TP_IFACE_CHANNEL ".TargetHandleType"))
1705 for (idx = 0; idx < fixed_properties->len; idx++)
1707 /* if |key| doesn't exist in |fixed_properties|, discard
1712 g_array_index (fixed_properties, char *, idx)))
1715 /* exit the for() loop */
1726 /* if no fixed_properties are specified, discard the classes
1727 * with some fixed properties other than the two we already
1730 if (g_hash_table_size (fprops) > 2)
1738 empathy_dispatcher_find_channel_classes (EmpathyDispatcher *self,
1739 TpConnection *connection,
1740 const gchar *channel_type,
1742 GArray *fixed_properties)
1744 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1747 GList *matching_classes;
1751 g_return_val_if_fail (channel_type != NULL, NULL);
1753 cd = g_hash_table_lookup (priv->connections, connection);
1758 classes = cd->requestable_channels;
1759 if (classes == NULL)
1762 matching_classes = NULL;
1764 for (i = 0; i < classes->len; i++)
1766 class = g_ptr_array_index (classes, i);
1768 if (!channel_class_matches
1769 (class, channel_type, handle_type, fixed_properties))
1772 matching_classes = g_list_prepend (matching_classes, class);
1775 return matching_classes;
1779 find_channel_class_idle_cb (gpointer user_data)
1783 FindChannelRequest *request = user_data;
1785 gboolean is_ready = TRUE;
1786 EmpathyDispatcherPriv *priv = GET_PRIV (request->dispatcher);
1788 g_hash_table_remove (priv->request_channel_class_async_ids, request);
1790 cd = g_hash_table_lookup (priv->connections, request->connection);
1794 else if (cd->requestable_channels == NULL)
1799 retval = empathy_dispatcher_find_channel_classes (request->dispatcher,
1800 request->connection, request->channel_type, request->handle_type,
1801 request->properties);
1803 request->callback (retval, request->user_data);
1804 free_find_channel_request (request);
1805 g_list_free (retval);
1810 requests = g_hash_table_lookup (priv->outstanding_classes_requests,
1811 request->connection);
1812 requests = g_list_prepend (requests, request);
1814 g_hash_table_insert (priv->outstanding_classes_requests,
1815 request->connection, requests);
1821 setup_varargs (va_list var_args,
1822 const char *channel_namespace,
1823 const char *first_property_name)
1829 if (first_property_name == NULL)
1832 name = first_property_name;
1833 properties = g_array_new (TRUE, TRUE, sizeof (char *));
1835 while (name != NULL)
1837 name_full = g_strdup (name);
1838 properties = g_array_append_val (properties, name_full);
1839 name = va_arg (var_args, char *);
1846 * empathy_dispatcher_find_requestable_channel_classes:
1847 * @dispatcher: an #EmpathyDispatcher
1848 * @connection: a #TpConnection
1849 * @channel_type: a string identifying the type of the channel to lookup
1850 * @handle_type: the handle type for the channel, or %TP_UNKNOWN_HANDLE_TYPE
1851 * if you don't care about the channel's target handle type
1852 * @first_property_name: %NULL, or the name of the first fixed property,
1853 * followed optionally by more names, followed by %NULL.
1855 * Returns all the channel classes that a client can request for the connection
1856 * @connection, of the type identified by @channel_type, @handle_type and the
1857 * fixed properties list.
1858 * The classes which are compatible with a fixed properties list (i.e. those
1859 * that will be returned by this function) are intended as those that do not
1860 * contain any fixed property other than those in the list; note that this
1861 * doesn't guarantee that all the classes compatible with the list will contain
1862 * all the requested fixed properties, so the clients will have to filter
1863 * the returned list themselves.
1864 * If @first_property_name is %NULL, only the classes with no other fixed
1865 * properties than ChannelType and TargetHandleType will be returned.
1866 * Note that this function may return %NULL without performing any lookup if
1867 * @connection is not ready. To ensure that @connection is always ready,
1868 * use the empathy_dispatcher_find_requestable_channel_classes_async() variant.
1870 * Return value: a #GList of #GValueArray objects, where the first element in
1871 * the array is a #GHashTable of the fixed properties, and the second is
1872 * a #GStrv of the allowed properties for the class. The list should be free'd
1873 * with g_list_free() when done, but the objects inside the list are owned
1874 * by the #EmpathyDispatcher and must not be modified.
1877 empathy_dispatcher_find_requestable_channel_classes
1878 (EmpathyDispatcher *self,
1879 TpConnection *connection,
1880 const gchar *channel_type,
1882 const char *first_property_name,
1887 EmpathyDispatcherPriv *priv;
1892 g_return_val_if_fail (EMPATHY_IS_DISPATCHER (self), NULL);
1893 g_return_val_if_fail (TP_IS_CONNECTION (connection), NULL);
1894 g_return_val_if_fail (channel_type != NULL, NULL);
1896 priv = GET_PRIV (self);
1898 va_start (var_args, first_property_name);
1900 properties = setup_varargs (var_args, channel_type, first_property_name);
1904 retval = empathy_dispatcher_find_channel_classes (self, connection,
1905 channel_type, handle_type, properties);
1907 if (properties != NULL)
1909 /* free the properties array */
1910 for (idx = 0; idx < properties->len ; idx++)
1912 str = g_array_index (properties, char *, idx);
1916 g_array_free (properties, TRUE);
1923 * empathy_dispatcher_find_requestable_channel_classes_async:
1924 * @dispatcher: an #EmpathyDispatcher
1925 * @connection: a #TpConnection
1926 * @channel_type: a string identifying the type of the channel to lookup
1927 * @handle_type: the handle type for the channel
1928 * @callback: the callback to call when @connection is ready
1929 * @user_data: the user data to pass to @callback
1930 * @first_property_name: %NULL, or the name of the first fixed property,
1931 * followed optionally by more names, followed by %NULL.
1933 * Please see the documentation of
1934 * empathy_dispatcher_find_requestable_channel_classes() for a detailed
1935 * description of this function.
1938 empathy_dispatcher_find_requestable_channel_classes_async
1939 (EmpathyDispatcher *self,
1940 TpConnection *connection,
1941 const gchar *channel_type,
1943 EmpathyDispatcherFindChannelClassCb callback,
1945 const char *first_property_name,
1950 FindChannelRequest *request;
1951 EmpathyDispatcherPriv *priv;
1954 g_return_if_fail (EMPATHY_IS_DISPATCHER (self));
1955 g_return_if_fail (TP_IS_CONNECTION (connection));
1956 g_return_if_fail (channel_type != NULL);
1957 g_return_if_fail (handle_type != 0);
1959 priv = GET_PRIV (self);
1961 va_start (var_args, first_property_name);
1963 properties = setup_varargs (var_args, channel_type, first_property_name);
1967 /* append another request for this connection */
1968 request = g_slice_new0 (FindChannelRequest);
1969 request->dispatcher = g_object_ref (self);
1970 request->channel_type = g_strdup (channel_type);
1971 request->handle_type = handle_type;
1972 request->connection = connection;
1973 request->callback = callback;
1974 request->user_data = user_data;
1975 request->properties = properties;
1977 source_id = g_idle_add (find_channel_class_idle_cb, request);
1979 g_hash_table_insert (priv->request_channel_class_async_ids,
1980 request, GUINT_TO_POINTER (source_id));
1984 empathy_dispatcher_get_channels (EmpathyHandler *handler,
1987 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
1988 EmpathyDispatcherPriv *priv = GET_PRIV (self);
1990 return priv->channels;
1994 empathy_dispatcher_handle_channels (EmpathyHandler *handler,
1995 const gchar *account_path,
1996 const gchar *connection_path,
1997 const GPtrArray *channels,
1998 const GPtrArray *requests_satisfied,
2000 GHashTable *handler_info,
2004 EmpathyDispatcher *self = EMPATHY_DISPATCHER (user_data);
2005 EmpathyDispatcherPriv *priv = GET_PRIV (self);
2008 TpConnection *connection;
2010 /* FIXME: should probably find out whether the account manager is prepared
2011 * before ensuring. See bug #600111. */
2012 account = tp_account_manager_ensure_account (priv->account_manager,
2014 g_assert (account != NULL);
2016 connection = tp_account_ensure_connection (account, connection_path);
2017 if (connection == NULL)
2019 g_set_error_literal (error, TP_ERRORS, TP_ERROR_INVALID_ARGUMENT,
2020 "Invalid connection argument");
2024 for (i = 0; i < channels->len ; i++)
2026 GValueArray *arr = g_ptr_array_index (channels, i);
2027 const gchar *object_path;
2028 GHashTable *properties;
2030 object_path = g_value_get_boxed (g_value_array_get_nth (arr, 0));
2031 properties = g_value_get_boxed (g_value_array_get_nth (arr, 1));
2033 dispatcher_connection_new_channel_with_properties (self,
2034 connection, object_path, properties, requests_satisfied, timestamp);
2042 empathy_dispatcher_add_handler (EmpathyDispatcher *self,
2047 EmpathyDispatcherPriv *priv = GET_PRIV (self);
2048 EmpathyHandler *handler;
2050 handler = empathy_handler_new (name, filters, capabilities);
2051 priv->handlers = g_list_prepend (priv->handlers, handler);
2053 /* Only set the handle_channels function, the Channel property on the main
2054 * handler will always report all dispatched channels even if they came from
2055 * a different Handler */
2056 empathy_handler_set_handle_channels_func (handler,
2057 empathy_dispatcher_handle_channels, self);
2063 empathy_dispatcher_remove_handler (EmpathyDispatcher *self,
2064 EmpathyHandler *handler)
2066 EmpathyDispatcherPriv *priv = GET_PRIV (self);
2069 h = g_list_find (priv->handlers, handler);
2070 g_return_if_fail (h != NULL);
2072 priv->handlers = g_list_delete_link (priv->handlers, h);
2074 g_object_unref (handler);