2 * AT-SPI - Assistive Technology Service Provider Interface
3 * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
5 * Copyright 2001 Sun Microsystems Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
23 /* registry.c: the main accessibility service registry implementation */
31 * We'd like to replace the dependance on X-isms with a wrapper layer,
32 * to the extent that it can't be done with pure GDK.
33 * Anyone want to help?
39 #include <libspi/registry.h>
41 /* Our parent GObject type */
42 #define PARENT_TYPE SPI_LISTENER_TYPE
44 /* A pointer to our parent object class */
45 static SpiListenerClass *spi_registry_parent_class;
60 EventTypeCategory type_cat;
68 Accessibility_EventListener listener;
69 guint event_type_hash;
70 EventTypeCategory event_type_cat;
73 /* static function prototypes */
74 static void _registry_notify_listeners (GList *listeners,
75 const Accessibility_Event *e,
76 CORBA_Environment *ev);
78 static long _get_unique_id();
80 static gboolean _device_event_controller_hook (gpointer source);
83 spi_listener_struct_new (Accessibility_EventListener listener, CORBA_Environment *ev)
85 SpiListenerStruct *retval = g_malloc (sizeof (SpiListenerStruct));
86 retval->listener = bonobo_object_dup_ref (listener, ev);
91 spi_listener_struct_free (SpiListenerStruct *ls, CORBA_Environment *ev)
93 /* TODO: sanity check for ls */
94 Accessibility_EventListener_unref (ls->listener, ev);
98 /* GObject::finalize */
100 spi_registry_object_finalize (GObject *object)
102 SpiRegistry *registry = SPI_REGISTRY (object);
104 printf("spi_registry_object_finalize called\n");
105 /* TODO: unref deviceeventcontroller, which disconnects key listener */
106 G_OBJECT_CLASS (spi_registry_parent_class)->finalize (object);
110 * registerApplication:
111 * @application: a reference to the requesting @Application
112 * return values: void
114 * Register a new application with the accessibility broker.
118 impl_accessibility_registry_register_application (PortableServer_Servant servant,
119 const Accessibility_Application application,
120 CORBA_Environment * ev)
122 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
125 fprintf (stderr, "registering app %p\n", application);
127 registry->desktop->applications = g_list_append (registry->desktop->applications,
128 bonobo_object_dup_ref (application, ev));
130 /* TODO: create unique string here (with libuuid call ?) and hash ? */
131 Accessibility_Application__set_id (application, _get_unique_id(), ev);
134 * TODO: change the implementation below to a WM-aware one;
135 * e.g. don't add all apps to the SpiDesktop
140 compare_corba_objects (gconstpointer p1, gconstpointer p2)
142 CORBA_Environment ev;
146 fprintf (stderr, "comparing %p to %p\n",
150 retval = !CORBA_Object_is_equivalent ((CORBA_Object) p1, (CORBA_Object) p2, &ev);
155 register_with_toolkits (SpiRegistry *spi_registry_bonobo_object, EventTypeStruct *etype, CORBA_Environment *ev)
160 Accessibility_Desktop desktop;
161 Accessibility_Application app;
162 Accessibility_Registry registry;
163 registry = BONOBO_OBJREF (spi_registry_bonobo_object);
165 /* for each app in each desktop, call ...Application_registerToolkitEventListener */
167 n_desktops = Accessibility_Registry_getDesktopCount (registry, ev);
169 for (i=0; i<n_desktops; ++i)
171 desktop = Accessibility_Registry_getDesktop (registry, i, ev);
172 n_apps = Accessibility_Desktop__get_childCount (desktop, ev);
173 for (j=0; j<n_apps; ++j)
175 app = (Accessibility_Application) Accessibility_Desktop_getChildAtIndex (desktop,
178 Accessibility_Application_registerToolkitEventListener (app,
180 CORBA_string_dup (etype->event_name),
188 compare_listener_hash (gconstpointer p1, gconstpointer p2)
190 return (((SpiListenerStruct *)p2)->event_type_hash - ((SpiListenerStruct *)p1)->event_type_hash);
194 compare_listener_corbaref (gconstpointer p1, gconstpointer p2)
196 return compare_corba_objects (((SpiListenerStruct *)p2)->listener,
197 ((SpiListenerStruct *)p1)->listener);
201 parse_event_type (EventTypeStruct *etype, char *event_name)
203 gchar **split_string;
206 split_string = g_strsplit(event_name, ":", 4);
207 etype->event_name = g_strndup(event_name, 255);
209 if (!g_ascii_strncasecmp (event_name, "focus:", 6))
211 etype->type_cat = ETYPE_FOCUS;
213 else if (!g_ascii_strncasecmp (event_name, "object:", 7))
215 etype->type_cat = ETYPE_OBJECT;
217 else if (!g_ascii_strncasecmp (event_name, "window:", 7))
219 etype->type_cat = ETYPE_WINDOW;
223 etype->type_cat = ETYPE_TOOLKIT;
228 etype->major = g_strdup (split_string[1]);
231 etype->minor = g_strdup (split_string[2]);
234 etype->detail = g_strdup (split_string[3]);
235 s = g_strconcat (split_string[1], split_string[2], split_string[3], NULL);
236 etype->hash = g_str_hash (s);
241 etype->detail = g_strdup ("");
242 s = g_strconcat (split_string[1], split_string[2], NULL);
243 etype->hash = g_str_hash (s);
249 etype->minor = g_strdup ("");
250 etype->hash = g_str_hash ( split_string[1]);
255 etype->major = g_strdup ("");
256 etype->minor = g_strdup ("");
257 etype->detail = g_strdup ("");
258 etype->hash = g_str_hash ("");
261 g_strfreev (split_string);
265 * deregisterApplication:
266 * @application: a reference to the @Application
267 * to be deregistered.
268 * return values: void
270 * De-register an application previously registered with the broker.
274 impl_accessibility_registry_deregister_application (PortableServer_Servant servant,
275 const Accessibility_Application application,
276 CORBA_Environment * ev)
278 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
279 GList *list = g_list_find_custom (registry->desktop->applications, application, compare_corba_objects);
288 fprintf (stderr, "deregistering application %p\n", application);
290 registry->desktop->applications = g_list_delete_link (registry->desktop->applications, list);
292 fprintf (stderr, "there are now %d apps registered.\n", g_list_length (registry->desktop->applications));
293 for (i = 0; i < g_list_length (registry->desktop->applications); ++i)
295 fprintf (stderr, "getting application %d\n", i);
296 fprintf (stderr, "object address %p\n",
297 g_list_nth_data (registry->desktop->applications, i));
303 fprintf (stderr, "could not deregister application %p\n", application);
308 * CORBA Accessibility::Registry::registerGlobalEventListener method implementation
311 impl_accessibility_registry_register_global_event_listener (
312 PortableServer_Servant servant,
313 Accessibility_EventListener listener,
314 const CORBA_char *event_name,
315 CORBA_Environment *ev)
317 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
318 SpiListenerStruct *ls = spi_listener_struct_new (listener, ev);
319 EventTypeStruct etype;
321 fprintf(stderr, "registering for events of type %s\n", event_name);
323 /* parse, check major event type and add listener accordingly */
324 parse_event_type (&etype, (char*) event_name);
325 ls->event_type_hash = etype.hash;
326 ls->event_type_cat = etype.type_cat;
328 switch (etype.type_cat)
331 case (ETYPE_OBJECT) :
332 case (ETYPE_PROPERTY) :
333 registry->object_listeners =
334 g_list_append (registry->object_listeners, ls);
336 case (ETYPE_WINDOW) :
337 /* Support for Window Manager Events is not yet implemented */
338 spi_listener_struct_free (ls, ev);
340 case (ETYPE_TOOLKIT) :
341 registry->toolkit_listeners =
342 g_list_append (registry->toolkit_listeners, ls);
343 register_with_toolkits (registry, &etype, ev);
346 spi_listener_struct_free (ls, ev);
352 * CORBA Accessibility::Registry::deregisterGlobalEventListenerAll method implementation
355 impl_accessibility_registry_deregister_global_event_listener_all (
356 PortableServer_Servant servant,
357 Accessibility_EventListener listener,
358 CORBA_Environment *ev)
360 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
361 SpiListenerStruct *spi_listener_struct, *ls = spi_listener_struct_new (listener, ev);
363 list = g_list_find_custom (registry->object_listeners, ls,
364 compare_listener_corbaref);
367 * TODO : de-register with toolkit if the last instance of a listener
368 * to a particular toolkit event type has been deregistered.
373 spi_listener_struct_free ((SpiListenerStruct *) list->data, ev);
374 registry->object_listeners = g_list_delete_link (registry->object_listeners, list);
375 list = g_list_find_custom (registry->object_listeners, ls, compare_listener_corbaref);
377 list = g_list_find_custom (registry->toolkit_listeners, ls, compare_listener_corbaref);
380 spi_listener_struct_free ((SpiListenerStruct *) list->data, ev);
381 registry->toolkit_listeners = g_list_delete_link (registry->toolkit_listeners, list);
382 list = g_list_find_custom (registry->toolkit_listeners, ls, compare_listener_corbaref);
384 spi_listener_struct_free (ls, ev);
388 * CORBA Accessibility::Registry::deregisterGlobalEventListener method implementation
391 impl_accessibility_registry_deregister_global_event_listener (
392 PortableServer_Servant servant,
393 Accessibility_EventListener listener,
394 const CORBA_char * event_name,
395 CORBA_Environment *ev)
397 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
398 SpiListenerStruct ls, *spi_listener_struct;
399 EventTypeStruct etype;
403 parse_event_type (&etype, (char *) event_name);
404 switch (etype.type_cat)
406 case (ETYPE_OBJECT) :
407 case (ETYPE_PROPERTY) :
409 listeners = ®istry->object_listeners;
411 case (ETYPE_WINDOW) :
412 /* Support for Window Manager Events is not yet implemented */
414 case (ETYPE_TOOLKIT) :
415 listeners = ®istry->toolkit_listeners;
425 ls.event_type_hash = etype.hash;
426 list = g_list_find_custom (*listeners, &ls, compare_listener_hash);
430 spi_listener_struct_free ((SpiListenerStruct *) list->data, ev);
431 *listeners = g_list_delete_link (*listeners, list);
432 list = g_list_find_custom (*listeners, &ls, compare_listener_hash);
439 * return values: a short integer indicating the current number of
442 * Get the current number of desktops.
446 impl_accessibility_registry_get_desktop_count (PortableServer_Servant servant,
447 CORBA_Environment * ev)
449 /* TODO: implement support for multiple virtual desktops */
450 CORBA_short n_desktops;
451 n_desktops = (CORBA_short) 1;
457 * @n: the index of the requested @Desktop.
458 * return values: a reference to the requested @Desktop.
460 * Get the nth accessible desktop.
463 static Accessibility_Desktop
464 impl_accessibility_registry_get_desktop (PortableServer_Servant servant,
466 CORBA_Environment * ev)
468 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
470 /* TODO: implement support for multiple virtual desktops */
473 return (Accessibility_Desktop)
474 bonobo_object_dup_ref (BONOBO_OBJREF (registry->desktop), ev);
478 return (Accessibility_Desktop) CORBA_OBJECT_NIL;
484 * return values: a sequence containing references to
487 * Get a list of accessible desktops.
490 static Accessibility_DesktopSeq *
491 impl_accessibility_registry_get_desktop_list (PortableServer_Servant servant,
492 CORBA_Environment * ev)
494 /* TODO: implement support for multiple virtual desktops */
495 return (Accessibility_DesktopSeq *) NULL;
498 static Accessibility_DeviceEventController
499 impl_accessibility_registry_get_device_event_controller (PortableServer_Servant servant,
500 CORBA_Environment * ev)
502 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
503 if (!registry->device_event_controller)
504 registry->device_event_controller = spi_device_event_controller_new (registry);
506 return bonobo_object_dup_ref (BONOBO_OBJREF (registry->device_event_controller), ev);
510 impl_registry_notify_event (PortableServer_Servant servant,
511 const Accessibility_Event *e,
512 CORBA_Environment *ev)
514 SpiRegistry *registry = SPI_REGISTRY (bonobo_object_from_servant (servant));
515 EventTypeStruct etype;
517 parse_event_type (&etype, e->type);
519 switch (etype.type_cat)
521 case (ETYPE_OBJECT) :
522 case (ETYPE_PROPERTY) :
524 _registry_notify_listeners (registry->object_listeners, e, ev);
526 case (ETYPE_WINDOW) :
527 _registry_notify_listeners (registry->window_listeners, e, ev);
529 case (ETYPE_TOOLKIT) :
530 _registry_notify_listeners (registry->toolkit_listeners, e, ev);
532 case (ETYPE_KEYBOARD) :
536 /* Accessibility_Accessible_unref (e->source, ev);*/ /* This should be here! */
549 _registry_notify_listeners (GList *listeners,
550 const Accessibility_Event *e_in,
551 CORBA_Environment *ev)
554 SpiListenerStruct *ls;
556 EventTypeStruct etype;
557 Accessibility_Event *e_out;
560 parse_event_type (&etype, e_in->type);
561 s = g_strconcat (etype.major, etype.minor, NULL);
562 minor_hash = g_str_hash (s);
565 for (list = listeners; list; list = list->next)
567 ls = (SpiListenerStruct *) list->data;
568 #ifdef SPI_SPI_LISTENER_DEBUG
569 fprintf(stderr, "event hashes: %lx %lx %lx\n", ls->event_type_hash, etype.hash, minor_hash);
570 fprintf(stderr, "event name: %s\n", etype.event_name);
572 if ((ls->event_type_hash == etype.hash) || (ls->event_type_hash == minor_hash))
575 fprintf(stderr, "notifying listener #%d\n", n++);
576 s = Accessibility_Accessible__get_name(e_in->source, ev);
577 fprintf(stderr, "event source name %s\n", s);
580 e_out = ORBit_copy_value (e_in, TC_Accessibility_Event);
581 e_out->source = bonobo_object_dup_ref (e_in->source, ev);
582 Accessibility_EventListener_notifyEvent ((Accessibility_EventListener) ls->listener,
585 /* is it safe to free e_out now ? notifyEvent is a oneway... */
587 if (ev->_major != CORBA_NO_EXCEPTION) {
589 ("Accessibility app error: exception during event notification: %s\n"),
590 CORBA_exception_id(ev));
598 _device_event_controller_hook (gpointer p)
600 SpiRegistry *registry = (SpiRegistry *)p;
601 SpiDeviceEventController *controller = registry->device_event_controller;
603 spi_device_event_controller_check_key_event (controller);
608 spi_registry_class_init (SpiRegistryClass *klass)
610 GObjectClass * object_class = (GObjectClass *) klass;
611 POA_Accessibility_Registry__epv *epv = &klass->epv;
613 spi_registry_parent_class = g_type_class_ref (SPI_LISTENER_TYPE);
615 object_class->finalize = spi_registry_object_finalize;
617 epv->registerApplication = impl_accessibility_registry_register_application;
618 epv->deregisterApplication = impl_accessibility_registry_deregister_application;
619 epv->registerGlobalEventListener = impl_accessibility_registry_register_global_event_listener;
620 epv->deregisterGlobalEventListener = impl_accessibility_registry_deregister_global_event_listener;
621 epv->deregisterGlobalEventListenerAll = impl_accessibility_registry_deregister_global_event_listener_all;
622 epv->getDeviceEventController = impl_accessibility_registry_get_device_event_controller;
623 epv->getDesktopCount = impl_accessibility_registry_get_desktop_count;
624 epv->getDesktop = impl_accessibility_registry_get_desktop;
625 epv->getDesktopList = impl_accessibility_registry_get_desktop_list;
627 ((SpiListenerClass *) klass)->epv.notifyEvent = impl_registry_notify_event;
631 spi_registry_init (SpiRegistry *registry)
633 registry->object_listeners = NULL;
634 registry->window_listeners = NULL;
635 registry->toolkit_listeners = NULL;
636 registry->applications = NULL;
637 registry->desktop = spi_desktop_new();
638 registry->device_event_controller = NULL;
639 registry->kbd_event_hook = _device_event_controller_hook;
642 BONOBO_TYPE_FUNC_FULL (SpiRegistry,
643 Accessibility_Registry,
648 spi_registry_new (void)
650 SpiRegistry *retval = g_object_new (SPI_REGISTRY_TYPE, NULL);