From bc99092@sac.sfbay.sun.com Thu Jul 30 13:37:51 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n6UKbowq029030 for ; Thu, 30 Jul 2009 13:37:51 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n6UKblA3012768; Thu, 30 Jul 2009 21:37:49 +0100 (BST) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KNM00D093Z0AI00@brm-avmta-1.central.sun.com>; Thu, 30 Jul 2009 14:37:48 -0600 (MDT) Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KNM00KVK3YZ2OB0@brm-avmta-1.central.sun.com>; Thu, 30 Jul 2009 14:37:47 -0600 (MDT) Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n6UKbkm8041982; Thu, 30 Jul 2009 13:37:46 -0700 (PDT) Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n6UKbi9Z029025; Thu, 30 Jul 2009 13:37:44 -0700 (PDT) Received: (from bc99092@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id n6UKbiii029021; Thu, 30 Jul 2009 13:37:44 -0700 (PDT) Date: Thu, 30 Jul 2009 13:37:44 -0700 (PDT) From: Brian Cameron Subject: Java ATK Wrapper [LSARC/2009/420 FastTrack timeout 08/12/2009] To: LSARC-ext@sun.com Cc: Ke.Wang@sun.com, desktop-discuss@opensolaris.org Message-id: <200907302037.n6UKbiii029021@sac.sfbay.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 5904 Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI This information is Copyright 2009 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: Java ATK Wrapper 1.2. Name of Document Author/Supplier: Author: Ke Wang 1.3 Date of This Document: 30 July, 2009 4. Technical Description 1. Introduction 1.1. Project/Component Working Name: Java ATK Wrapper 1.2. Name of Document Author/Supplier: Author: Ke Wang Sponser: Jeff Cai 1.3. Date of This Document: 07/14/2009 1.4. Name of Major Document Customer(s)/Consumer(s): 1.4.1. The PAC or CPT you expect to review your project: Solaris PAC 1.4.2. The ARC(s) you expect to review your project: LSARC 1.4.3. The Director/VP who is "Sponsoring" this project: Robert O'Dea 1.4.4. The name of your business unit: OpenSolaris Desktop 1.5. Email Aliases: 1.5.1. Responsible Manager: harry.lu@sun.com 1.5.2. Responsible Engineer: ke.wang@sun.com 1.5.3. Marketing Manager: glynn.foster@sun.com 1.5.4. Interest List: 2. Project Summary 2.1. Project Description: Java ATK Wrapper is an implementation of ATK that uses JNI. 3. Technical Description: 3.1. Details: JAW is part of the GNOME Bonobo deprecation project. It is going to take the place of Java Access Bridge, so the Java Access Bridge is being made obsolete by this case. Java Access Bridge is a private interface which does not expose any user- facing interfaces. So, no end users or applications should be affected by the change from using Java Access Bridge to Java ATK Wrapper. Like Java Access Bridge, JAW is included in the package of SUNWgnome-a11y-libs. For detailed information about GNOME Accessibility, refer to the GNOME Accessibility Developers Guide. By talking to ATK-Bridge, JAW creates an abstraction layer which hides changes of the underlying communication mechanisms (CORBA or D-Bus). When ATK Bridge starts to use D-Bus, JAW will need little or no changes. ------------------- | Java AWT | ------------------- | JAAPI | ------------------- | | wrapper|--> Adaptor between JAAPI and ATK interfaces | JAW |--------| | |atk-impl|--> ATK implementation ------------------- | ATK Bridge | ------------------- JAW consists of two parts: a wrapper implemented in Java that converts JAAPI into ATK interface calls, and atk-impl implemented in C that provides the actual ATK implementation. The wrapper is loaded with AWT. It listens to AWT window events, adds listeners to Java accessibility properties, and notifies atk-impl about these events. The atk-impl is loaded and initialized by the wrapper. It implements all interfaces specified by ATK. While initializing, atk-impl loads the ATK-Bridge, which will get various information from atk-impl through ATK interfaces and register the host Java application to registryd. When there is an accessibility related event, the wrapper notifies atk-impl by JNI. atk-impl will get detailed information about this event from wrapper via JNI callback, then encapsulates these information into signal that can be understood by the ATK-Bridge. 3.2. Interfaces: Exported Interfaces Interface Classification Comments --------------- -------------- ----------------------- /usr/java/jre/lib/ Project Jar file for Java ATK ext/java-atk-wrapper.jar Private Wrapper /usr/lib/ Project Library that implements libatk-wrapper.so.0 Private ATK /usr/java/jre/lib/ Uncommitted Properties file for JVM to accessibility.properties get information about a11y bridge /usr/java/jre/lib/ Obsolete Jar file for previous Java ext/gnome-java-bridge.jar Project Access Bridge Private Imported Interfaces Interface Classification Comments --------------- -------------- ----------------------- glib Committed LSARC/2008/510 ATK Committed LSARC/2001/650 J2SE 1.5 Committed PSARC/2003/696 3.3. Dependencies: Java ATK Wrapper depends on glib, ATK and J2SE 1.5+ 3.4. Security Impact: There is no security impact. 4. Resources and Schedule: 4.1. Product Approval Committee requested information: 4.1.1. Consolidation Name: Desktop Cteam/GNOME 4.1.2. Contributing OpCo/BU/Division Name: Desktop 4.1.3. Type of PAC Review and Approval expected: FastTrack 5. References Wiki page of Bonobo Deprecation project: http://live.gnome.org/Accessibility/BonoboDeprecation Project git repository: http://git.gnome.org/cgit/java-atk-wrapper/ GNOME Accessibility Developers Guide: http://library.gnome.org/devel/accessibility-devel-guide/nightly/accessibility-devel-guide.html 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: Desktop 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From Brian.Cameron@sun.com Thu Jul 30 13:40:20 2009 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n6UKeKxQ029143 for ; Thu, 30 Jul 2009 13:40:20 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n6UKeJPa008035 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Thu, 30 Jul 2009 13:40:20 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KNM0050B437UQ00@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Thu, 30 Jul 2009 13:40:19 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KNM002PO436LF10@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Thu, 30 Jul 2009 13:40:18 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n6UKeISK007503 for ; Thu, 30 Jul 2009 20:40:18 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KNM00L003PADC00@mail-amer.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Thu, 30 Jul 2009 14:40:18 -0600 (MDT) Received: from [129.153.250.170] ([unknown] [129.153.250.170]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KNM00LU0431RPA0@mail-amer.sun.com>; Thu, 30 Jul 2009 14:40:13 -0600 (MDT) Date: Thu, 30 Jul 2009 15:40:25 -0500 From: Brian Cameron Subject: Re: Java ATK Wrapper [LSARC/2009/420 FastTrack timeout 08/12/2009] In-reply-to: <200907302037.n6UKbiii029021@sac.sfbay.sun.com> Sender: Brian.Cameron@sun.com To: Brian Cameron Cc: LSARC-ext@sun.com, Ke.Wang@sun.com, desktop-discuss@opensolaris.org Message-id: <4A720539.9050908@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200907302037.n6UKbiii029021@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.21 (X11/20090622) Status: RO Content-Length: 6344 This module is only integrating into Nevada, so a minor release binding. Brian Brian Cameron wrote: > Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI > This information is Copyright 2009 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > Java ATK Wrapper > 1.2. Name of Document Author/Supplier: > Author: Ke Wang > 1.3 Date of This Document: > 30 July, 2009 > 4. Technical Description > 1. Introduction > 1.1. Project/Component Working Name: > > Java ATK Wrapper > > 1.2. Name of Document Author/Supplier: > > Author: Ke Wang > Sponser: Jeff Cai > > 1.3. Date of This Document: > > 07/14/2009 > > 1.4. Name of Major Document Customer(s)/Consumer(s): > > 1.4.1. The PAC or CPT you expect to review your project: > > Solaris PAC > > 1.4.2. The ARC(s) you expect to review your project: > > LSARC > > 1.4.3. The Director/VP who is "Sponsoring" this project: > > Robert O'Dea > > 1.4.4. The name of your business unit: > > OpenSolaris Desktop > > 1.5. Email Aliases: > 1.5.1. Responsible Manager: harry.lu@sun.com > 1.5.2. Responsible Engineer: ke.wang@sun.com > 1.5.3. Marketing Manager: glynn.foster@sun.com > 1.5.4. Interest List: > > 2. Project Summary > 2.1. Project Description: > > Java ATK Wrapper is an implementation of ATK that uses JNI. > > 3. Technical Description: > 3.1. Details: > JAW is part of the GNOME Bonobo deprecation project. It is going to take > the place of Java Access Bridge, so the Java Access Bridge is being made > obsolete by this case. > > Java Access Bridge is a private interface which does not expose any user- > facing interfaces. So, no end users or applications should be affected by > the change from using Java Access Bridge to Java ATK Wrapper. > > Like Java Access Bridge, JAW is included in the package of > SUNWgnome-a11y-libs. For detailed information about GNOME Accessibility, > refer to the GNOME Accessibility Developers Guide. > > By talking to ATK-Bridge, JAW creates an abstraction layer which hides > changes of the underlying communication mechanisms (CORBA or D-Bus). > When ATK Bridge starts to use D-Bus, JAW will need little or no changes. > > ------------------- > | Java AWT | > ------------------- > | JAAPI | > ------------------- > | | wrapper|--> Adaptor between JAAPI and ATK interfaces > | JAW |--------| > | |atk-impl|--> ATK implementation > ------------------- > | ATK Bridge | > ------------------- > > JAW consists of two parts: a wrapper implemented in Java that converts > JAAPI into ATK interface calls, and atk-impl implemented in C that > provides the actual ATK implementation. > > The wrapper is loaded with AWT. It listens to AWT window events, adds > listeners to Java accessibility properties, and notifies atk-impl about > these events. > > The atk-impl is loaded and initialized by the wrapper. It implements all > interfaces specified by ATK. While initializing, atk-impl loads the > ATK-Bridge, which will get various information from atk-impl through ATK > interfaces and register the host Java application to registryd. > > When there is an accessibility related event, the wrapper notifies > atk-impl by JNI. atk-impl will get detailed information about this event > from wrapper via JNI callback, then encapsulates these information into > signal that can be understood by the ATK-Bridge. > > 3.2. Interfaces: > > Exported Interfaces > > Interface Classification Comments > --------------- -------------- ----------------------- > /usr/java/jre/lib/ Project Jar file for Java ATK > ext/java-atk-wrapper.jar Private Wrapper > > /usr/lib/ Project Library that implements > libatk-wrapper.so.0 Private ATK > > /usr/java/jre/lib/ Uncommitted Properties file for JVM to > accessibility.properties get information about a11y > bridge > > /usr/java/jre/lib/ Obsolete Jar file for previous Java > ext/gnome-java-bridge.jar Project Access Bridge > Private > > Imported Interfaces > > Interface Classification Comments > --------------- -------------- ----------------------- > glib Committed LSARC/2008/510 > > ATK Committed LSARC/2001/650 > > J2SE 1.5 Committed PSARC/2003/696 > > 3.3. Dependencies: > Java ATK Wrapper depends on glib, ATK and J2SE 1.5+ > > 3.4. Security Impact: > There is no security impact. > > 4. Resources and Schedule: > > 4.1. Product Approval Committee requested information: > 4.1.1. Consolidation Name: > > Desktop Cteam/GNOME > > 4.1.2. Contributing OpCo/BU/Division Name: > > Desktop > > 4.1.3. Type of PAC Review and Approval expected: > > FastTrack > > 5. References > Wiki page of Bonobo Deprecation project: > http://live.gnome.org/Accessibility/BonoboDeprecation > Project git repository: > http://git.gnome.org/cgit/java-atk-wrapper/ > GNOME Accessibility Developers Guide: > http://library.gnome.org/devel/accessibility-devel-guide/nightly/accessibility-devel-guide.html > > > 6. Resources and Schedule > 6.4. Steering Committee requested information > 6.4.1. Consolidation C-team Name: > Desktop > 6.5. ARC review type: FastTrack > 6.6. ARC Exposure: open > From storycrafter@gmail.com Mon Aug 3 10:42:57 2009 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n73HguVI018344 for ; Mon, 3 Aug 2009 10:42:57 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n73Hgj7L029727; Mon, 3 Aug 2009 18:42:52 +0100 (BST) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KNT00A0ZAJCTQ00@brm-avmta-1.central.sun.com>; Mon, 03 Aug 2009 11:42:48 -0600 (MDT) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KNT006PIAJBED20@brm-avmta-1.central.sun.com>; Mon, 03 Aug 2009 11:42:47 -0600 (MDT) Received: from relay13i.sun.com (ip123.net129179-4.block1.us.syntegra.com [129.179.4.123]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n73HLCI6006089; Mon, 03 Aug 2009 17:42:47 +0000 (GMT) Received: from mmp11es.mmp.us.syntegra.com ([160.41.208.11] [160.41.208.11]) by relay13i.sun.com with ESMTP id BT-MMP-743195; Mon, 03 Aug 2009 17:42:47 +0000 (Z) Received: from relay13i.sun.com (relay13i.sun.com [129.179.4.123]) by mmp11es.mmp.us.syntegra.com with ESMTP id BT-MMP-25509811; Mon, 03 Aug 2009 17:42:45 +0000 (Z) Received: from mail-ew0-f212.google.com ([209.85.219.212] [209.85.219.212]) by relay1i.sun.com with ESMTP id BT-MMP-663528; Mon, 03 Aug 2009 17:35:00 +0000 (Z) Received: by mail-ew0-f212.google.com with SMTP id 8so2106280ewy.8 for ; Mon, 03 Aug 2009 10:33:57 -0700 (PDT) Received: by 10.210.136.15 with SMTP id j15mr5379546ebd.21.1249320836894; Mon, 03 Aug 2009 10:33:56 -0700 (PDT) Received: from ?172.16.202.89? (68-252-106-20.ded.ameritech.net [68.252.106.20]) by mx.google.com with ESMTPS id 5sm258822eyh.26.2009.08.03.10.33.53 (version=TLSv1/SSLv3 cipher=RC4-MD5) ; Mon, 03 Aug 2009 10:33:55 -0700 (PDT) Date: Mon, 03 Aug 2009 12:33:52 -0500 From: Mark Martin Subject: Re: Java ATK Wrapper [LSARC/2009/420 FastTrack timeout 08/12/2009] In-reply-to: <4A720539.9050908@sun.com> To: Brian Cameron Cc: Brian Cameron , desktop-discuss@opensolaris.org, LSARC-ext@sun.com, Ke.Wang@sun.com Message-id: <4A771F80.2060101@gmail.com> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7BIT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=qyEamKNsXa8h3i1mhPSFCan4gyK9DVhMvvleh8jmiA0=; b=wnnQhydjdinwT0rWsYtjHy8Qwoe8GUIp4J+i3nDXNQCelcweVI1VDzEFBhw2e6Y7Ki uYlL9O/LX/OIpqmp6u1bEMKdjJJdAUCSNs1sc1+fweqmaulPx9uHjrqh9pBZhb+0DiRI YvtX8o18bwUmz8X7Pq3dlDrp/1zusQhJAy14w= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=iYDJ1yAwdNxkU2C6PI0EVPdOHxikCnNlYRGZr79TWKX0j8pG8GgQX2vZLP+YjOWO2J A1x1MaYCVHuDKLOpVEqRJ9eVTOwCLxRzTnG+iHjvx1NyTs+tKChlI3A4X5ODVDa2XlTP wZNHgRWbLv1PtuwuDSDXVvq3X8p1CDvVaQj2A= X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Antispam: No, score=0.0/5.0, scanned in 0.050sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <200907302037.n6UKbiii029021@sac.sfbay.sun.com> <4A720539.9050908@sun.com> User-Agent: Thunderbird 2.0.0.22 (Windows/20090605) Status: RO Content-Length: 646 Brian Cameron wrote: > > This module is only integrating into Nevada, so a minor release binding. > > Brian > > > Brian Cameron wrote: >> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI >> This information is Copyright 2009 Sun Microsystems >> 1. Introduction >> 1.1. Project/Component Working Name: >> Java ATK Wrapper >> 1.2. Name of Document Author/Supplier: >> Author: Ke Wang >> 1.3 Date of This Document: >> 30 July, 2009 >> 4. Technical Description >> 1. Introduction >> 1.1. Project/Component Working Name: Looks good to me (for as much as I can only publicly see 1 of the 3 imported interfaces :) ) From Brian.Cameron@sun.com Tue Aug 4 12:10:36 2009 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n74JAaqU006381 for ; Tue, 4 Aug 2009 12:10:36 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n74JAa6S045993 for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Tue, 4 Aug 2009 13:10:36 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0KNV00H0599OD500@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 04 Aug 2009 12:10:36 -0700 (PDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0KNV007N599NELA0@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 04 Aug 2009 12:10:35 -0700 (PDT) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n74JAZw8025624 for ; Tue, 04 Aug 2009 19:10:35 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) id <0KNV00A0096VME00@mail-amer.sun.com> for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue, 04 Aug 2009 13:10:35 -0600 (MDT) Received: from [129.153.250.126] ([unknown] [129.153.250.126]) by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009)) with ESMTPSA id <0KNV00HXH99DF140@mail-amer.sun.com>; Tue, 04 Aug 2009 13:10:26 -0600 (MDT) Date: Tue, 04 Aug 2009 14:10:42 -0500 From: Brian Cameron Subject: Re: Java ATK Wrapper [LSARC/2009/420 FastTrack timeout 08/12/2009] In-reply-to: <200907302037.n6UKbiii029021@sac.sfbay.sun.com> Sender: Brian.Cameron@sun.com To: Brian Cameron Cc: LSARC-ext@sun.com, Ke.Wang@sun.com, desktop-discuss@opensolaris.org Message-id: <4A7887B2.3020104@sun.com> MIME-version: 1.0 Content-type: text/plain; CHARSET=US-ASCII; format=flowed Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <200907302037.n6UKbiii029021@sac.sfbay.sun.com> User-Agent: Thunderbird 2.0.0.21 (X11/20090622) Status: RO Content-Length: 6330 Note that this case was approved at today's LSARC meeting. Brian Brian Cameron wrote: > Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI > This information is Copyright 2009 Sun Microsystems > 1. Introduction > 1.1. Project/Component Working Name: > Java ATK Wrapper > 1.2. Name of Document Author/Supplier: > Author: Ke Wang > 1.3 Date of This Document: > 30 July, 2009 > 4. Technical Description > 1. Introduction > 1.1. Project/Component Working Name: > > Java ATK Wrapper > > 1.2. Name of Document Author/Supplier: > > Author: Ke Wang > Sponser: Jeff Cai > > 1.3. Date of This Document: > > 07/14/2009 > > 1.4. Name of Major Document Customer(s)/Consumer(s): > > 1.4.1. The PAC or CPT you expect to review your project: > > Solaris PAC > > 1.4.2. The ARC(s) you expect to review your project: > > LSARC > > 1.4.3. The Director/VP who is "Sponsoring" this project: > > Robert O'Dea > > 1.4.4. The name of your business unit: > > OpenSolaris Desktop > > 1.5. Email Aliases: > 1.5.1. Responsible Manager: harry.lu@sun.com > 1.5.2. Responsible Engineer: ke.wang@sun.com > 1.5.3. Marketing Manager: glynn.foster@sun.com > 1.5.4. Interest List: > > 2. Project Summary > 2.1. Project Description: > > Java ATK Wrapper is an implementation of ATK that uses JNI. > > 3. Technical Description: > 3.1. Details: > JAW is part of the GNOME Bonobo deprecation project. It is going to take > the place of Java Access Bridge, so the Java Access Bridge is being made > obsolete by this case. > > Java Access Bridge is a private interface which does not expose any user- > facing interfaces. So, no end users or applications should be affected by > the change from using Java Access Bridge to Java ATK Wrapper. > > Like Java Access Bridge, JAW is included in the package of > SUNWgnome-a11y-libs. For detailed information about GNOME Accessibility, > refer to the GNOME Accessibility Developers Guide. > > By talking to ATK-Bridge, JAW creates an abstraction layer which hides > changes of the underlying communication mechanisms (CORBA or D-Bus). > When ATK Bridge starts to use D-Bus, JAW will need little or no changes. > > ------------------- > | Java AWT | > ------------------- > | JAAPI | > ------------------- > | | wrapper|--> Adaptor between JAAPI and ATK interfaces > | JAW |--------| > | |atk-impl|--> ATK implementation > ------------------- > | ATK Bridge | > ------------------- > > JAW consists of two parts: a wrapper implemented in Java that converts > JAAPI into ATK interface calls, and atk-impl implemented in C that > provides the actual ATK implementation. > > The wrapper is loaded with AWT. It listens to AWT window events, adds > listeners to Java accessibility properties, and notifies atk-impl about > these events. > > The atk-impl is loaded and initialized by the wrapper. It implements all > interfaces specified by ATK. While initializing, atk-impl loads the > ATK-Bridge, which will get various information from atk-impl through ATK > interfaces and register the host Java application to registryd. > > When there is an accessibility related event, the wrapper notifies > atk-impl by JNI. atk-impl will get detailed information about this event > from wrapper via JNI callback, then encapsulates these information into > signal that can be understood by the ATK-Bridge. > > 3.2. Interfaces: > > Exported Interfaces > > Interface Classification Comments > --------------- -------------- ----------------------- > /usr/java/jre/lib/ Project Jar file for Java ATK > ext/java-atk-wrapper.jar Private Wrapper > > /usr/lib/ Project Library that implements > libatk-wrapper.so.0 Private ATK > > /usr/java/jre/lib/ Uncommitted Properties file for JVM to > accessibility.properties get information about a11y > bridge > > /usr/java/jre/lib/ Obsolete Jar file for previous Java > ext/gnome-java-bridge.jar Project Access Bridge > Private > > Imported Interfaces > > Interface Classification Comments > --------------- -------------- ----------------------- > glib Committed LSARC/2008/510 > > ATK Committed LSARC/2001/650 > > J2SE 1.5 Committed PSARC/2003/696 > > 3.3. Dependencies: > Java ATK Wrapper depends on glib, ATK and J2SE 1.5+ > > 3.4. Security Impact: > There is no security impact. > > 4. Resources and Schedule: > > 4.1. Product Approval Committee requested information: > 4.1.1. Consolidation Name: > > Desktop Cteam/GNOME > > 4.1.2. Contributing OpCo/BU/Division Name: > > Desktop > > 4.1.3. Type of PAC Review and Approval expected: > > FastTrack > > 5. References > Wiki page of Bonobo Deprecation project: > http://live.gnome.org/Accessibility/BonoboDeprecation > Project git repository: > http://git.gnome.org/cgit/java-atk-wrapper/ > GNOME Accessibility Developers Guide: > http://library.gnome.org/devel/accessibility-devel-guide/nightly/accessibility-devel-guide.html > > > 6. Resources and Schedule > 6.4. Steering Committee requested information > 6.4.1. Consolidation C-team Name: > Desktop > 6.5. ARC review type: FastTrack > 6.6. ARC Exposure: open >