Java Java TM Access Bridge
for the Microsoft Windows Operating System

Version 2.0.1


Setup Information
Contents

Setting Up the Java Access Bridge

The Java Access Bridge should only be installed by hand as a last resort. The recommended way to install the Java Access Bridge is to use the Java Access Bridge installer, which will locate the Java VMs installed on your system that support the Java Access Bridge, and then install the Java Access Bridge into those Java VMs that you identify. The Java Access Bridge installer is a self-extracting executable file called AccessBridge-2_0_1.exe.

The instructions below describe what the Java Access Bridge installer does, allowing you to make those modifications by hand if necessary.  Please note: the Java Access Bridge package includes three editions of the Java Accessibility Utilities file ' jaccess.jar', which differs for Java 2 SDK 1.2, Java 2 SDK 1.3, and Java 2 SDK 1.4. These files are named jaccess-1_2.jar, jaccess-1_3.jar, and jaccess-1_4.jar. Please use the jaccess-1_4.jar for Java 2 SDK 5.x and 6.x.
 

Using JDK 1.1 Environments
Version 1.0.2 of the Java Access Bridge is required for JDK 1.1 environments. See the compatibility table for complete information.

Using Java Environments (Including SDK v1.2.2, v1.3.x, v1.4.x, 5.0, and 6.0)

To begin the installation, locate your Java platform extensions directory, which is the jre\lib\ext subdirectory under the directory in which your JDK is installed. Typical locations are:

  c:\Program Files\Java\jdk1.5.0\jre\lib\ext
  c:\Program Files\Java\jre1.5.0_05\lib\ext

Copy the following files into that directory:
  jaccess-1_2.jar for Java 2 platform edition 1.2.x,  or
  jaccess-1_3.jar for Java 2 platform edition 1.3.x,  or
  jaccess-1_4.jar for Java 2 platform edition 1.4.x,  or
    jaccess-1_4.jar for Java platform edition 1.5.x or 1.6.x;   and
  access-bridge.jar
Copy the JavaAccessBridge.DLL, JAWTAccessBridge.DLL,, and WindowsAccessBridge.DLL files into the Windows/system 32 directory.

The Java Virtual Machine consults a number of property files as it starts up.  You will need to copy the  c:\Program Files\Java\jre1.5.0_05\jre\lib\ accessibility.properties file in order to enable accessibility.  The Java Accessibility Utilities examples documentation explains how this all works. Add the following line to the accessibility.properties file:

  assistive_technologies=com.sun.java.accessibility.AccessBridge

This line tells the Java VM to load the AccessBridge assistive technology, which it finds in the standard extensions directory. In addition, if you are using screen magnification technologies such as ZoomText from Ai Squared, you must also indicate the presence of screen magnification by adding the following line to the accessibility.properties file:

  screen_magnifier_present=true
 

When using a 64-bit Windows system, the installation process for the Java Access Bridge for Windows is:
  1. Download and install a 32-bit version of the Java runtime. This will work in 64-bit Windows, as do most 32-bit applications. Note that it will be installed not into your Program Files directory, but into 64-bit Vista's Program Files (x86) directory.
  2. Download the Access Bridge 2.0.1 Manual Install (.zip) - one of the two options you get after following the link Download Java Access Bridge 2.0.1 here
  3. Follow the By hand instructions here
  4. Copy the three DLL files JavaAccessBridge.DLL, JAWTAccessBridge.DLL, and WindowsAccessBridge.DLL from the Access Bridge installerFiles directory into your new for 64-bit Vista Windows\SysWOW64 directory. This is where 64-bit Vista needs to have 32-bit DLLs (for most people the full path will be C:\Windows\SysWOW65).
  5. Modify your PATH so that it ends with the Windows\SysWOW64 directory (Start Menu-> Computer -> Properties -> Advanced system settings -> Environment Variables -> System Variables -> PATH to add the string ;%SystemRoot%\sysWow64 to the end of the existing PATH (or at a minimum, that it appears after the entry for "%SystemRoot%\system32 in your path).
Compatibility Information
In the Java Foundation Classes 1.1 with Swing 1.1, the name of the packages containing both the Swing classes and the Java Accessibility API classes changed (from com.sun.java.swing and com.sun.java.accessibility to javax.swing and javax.accessibility respectively).  Java applications and applets built with earlier versions of Swing and/or the Java Accessibility API will not work with the Java Accessibility Utilities version 1.1 and later, nor will they work with the Java Access Bridge.  The compatibility table details the versions of the Java platform, Java Foundation Classes, Java Accessibility Utilities, Java Plugin, and Java Access Bridge that work with each other.
 
Working From a Browser
The Java Plugin, found here, provides a browser plug-in that contains the Sun Java VM.  This VM includes the ability to replace the EventQueue in order to load assistive technologies (or, in the case of the JDK 1.2 version  of the Java Plugin; load assistive technologies directly). The Java Plugin (version 1.2.2 and later) includes the Java Foundation Classes (and thereby Swing and the Java Accessibility API).  The Java Plugin is typically installed on your c:\ drive within your Program Files directory.  It may be a separate, or second Java VM.  The Java platform extensions directory is typically at:

  c:\Program Files\Java\jre1.5.0_05\lib\ext

which is where you must put the accessbridge.jar and jaccess.jar files.  The parent lib directory is where the accessibility.properties file is located, which must be likewise modified as above.
 


Copyright © 2006 Sun Microsystems, Inc. All Rights Reserved.

Please send comments to: access@sun.com
Sun
Left Curve
Java SDKs and Tools
Right Curve
Left Curve
Java Resources
Right Curve


Duke's Choice RHS Banner

JavaOne 2014 Replay banner