Knowledge Base Article - Q37
Topic: Java Access Bridge
Last updated on:
Applies to: ScreenReader, SuperNova Magnifier, SuperNova Magnifier & Screen Reader, SuperNova Magnifier & Speech
NB: Please note that product names in this article may have changed since the time of writing.
What is Java Access Bridge and how do I install it?
Java Access Bridge is a technology that exposes the Java Accessibility API to Microsoft Windows, enabling Assistive Technologies like SuperNova to successfully interact with Java based programs. The Java Accessibility API is part of the Java Accessibility Utilities toolkit.
In order for SuperNova to provide access to Java applications, SuperNova needs some way to communicate with Java Accessibility Utilities. Java Access Bridge supports this communication, providing the pathway between the Java program and SuperNova.
To learn more about Java Access Bridge and to find instructions on downloading and installing this utility, please select the following link:
Once Java Access Bridge is installed, you then need to tell SuperNova to use the Java Accessibility Map file with your Java application, for example, Matlab.
To do this:
- Run the Java application and ensure it has the current focus.
- Press LEFT CONTROL + SPACEBAR. The SuperNova Control Panel opens.
- Press ALT + F. The "File" menu opens with the "New" menu item selected.
- RIGHT ARROW to open the sub-menu, then DOWN ARROW to "Map" and press ENTER. The "Select Map File" dialog box opens.
- Use the Arrow Keys to select the "Use an existing map file" option, then TAB into the list of map files and select "Java Accessibility".
- TAB to the "OK" button and press SPACEBAR. SuperNova associates the map file with the Java application. You need to only do this process once.
Now you are ready to use the Java application.
To test Java application compatability with SuperNova, please try the following:
- Open the Java application in the background.
- In the Java Access Bridge folder, you will find an application called JavaMonkey. Open this. You can explore this by selecting "File", then "Refresh Tree". If the app has compatability, it should populate the tree with the various elements. If it does not, the Java application has not been written with accessibility in mind, and accessibility programs cannot read the Java application.
- In the Java Access Bridge folder, you will find an application called JavaFerret. Open this. In the "JavaEvents" dropdown menu, select "Track Focus Events" and "Track Caret Events" to ensure there is a tick by each of them. In the "AccessibilityEvents", select all items to ensure there is a tick by each of them. Return to the Java application, and the JavaFerret program should update. If it does not, the Java application has not been written with accessibility in mind, and accessibility programs cannot read the Java application.
Note: At the point of this article's creation, the version of Java Access Bridge is v2.02 and the SuperNova Java Accessibility Map file is v1.06.
Information for programmers on the Java Accessibility API is available from the following web page: Java Accessibility API Guide from Oracle.
The information provided in this knowledge base article has been reviewed and is believed to be accurate and is provided "as is" without any warranties expressed or implied. In no event shall Dolphin Computer Access Ltd. nor its affiliates assume any responsibility for inaccuracies, errors, incidental or consequential damages resulting from any defect or omission in this document, even if advised of the possibility of such damages.
Keep in Touch
Do you have any comments on this article? Send us a message quoting the article reference number: Q37.
Did you find this article useful?