Introduction


The PersonalJava emulation environment (PJEE) is a standalone software test tool. It allows developers to test their Java software against a desktop-based implementation of the PersonalJava application environment (PJAE). The PJEE is delivered in binary form as a software application for Microsoft Windows 95/NT and Solaris.

Note: The PJEE serves a different purpose than the Java Runtime Environment (JRE). The JRE is a reference implementation of the Java application environment for desktop platforms like Microsoft Windows 95/NT and Solaris. The PJEE is not a target application environment for running Java software; it is a developer tool for testing Java software.

This user guide describes how to install and use the PJEE for testing Java software.

PJEE and the PersonalJava Application Environment Specification

The PersonalJava Application Environment Specification states that different parts of the PJAE API are required, optional or modified. For example, since file system support for the PJAE is optional, the part of java.io related to file I/O is also optional. Therefore, an implementation of the PJAE may omit this part of java.io and still conform to the PersonalJava Application Environment Specification.

Every optional feature of the PersonalJava Application Environment Specification has been omitted from the PJEE except for the optional parts of java.io and java.util.zip. In addition, the PJEE provides support for only a single locale: en_US.

Because it is a software test tool, the PJEE has not been fully optimized for performance. This allows the PJEE to be used with Java debugging tools like jdb.

Look & Feel

The PJEE is available in two versions of look & feel: the test platform's native look & feel (Solaris/Motif or Microsoft Windows 95/NT) or the new Touchable look & feel.

What's New

Here is a list of new features in this version of the PJEE:

Software Contents

The PJEE installation program contains the software necessary to run the PJEE on either Microsoft Windows 95/NT or Solaris. Note: The PJEE does not include a web browser.

The table below describes the software contents of the PJEE directory after installation. Because it can be located anywhere on a given file system, this directory is referred to as PJEE-dir in this document.

ComponentDescription
COPYRIGHT Copyright notice for the PJEE.
LICENSE License agreement for the PJEE.
bin/pjava Optimized version. The PersonalJava application launcher loads and executes Java applications.
bin/pjava_g Debug version.
bin/pjavaw Optimized version. (Microsoft Windows 95/NT only). A special version of the PersonalJava application launcher that does not create a console window.
bin/pjavaw_g Debug version.
bin/pappletviewer Optimized version. The PersonalJava applet viewer loads HTML pages that contain Java applets.
bin/pappletviewer_g Debug version.
bin/*.dll (Microsoft Windows 95/NT only). Dynamic link libraries (DLLs) for the virtual machine and native methods of the PersonalJava class library.
bin/sparc (Solaris only). Binary executables for the invocation tools called by the a front-end shell scripts in bin.
doc/* This user guide.
lib/appletviewer.properties Status message strings and security policy for sun.applet.AppletViewer. Java property files for the PJEE.

See System Properties for a description of Java system properties that are available through the -D command line option for pjava.

lib/awt.properties Key and modifier name strings used by java.awt.event.KeyEvent.
lib/content-types.properties MIME content type description file used by sun.net.www. Each entry maps a MIME content type to a native application that can handle it. Files are associated with a MIME content type by either the MIME content type returned by an HTTP header or their file name extension.
lib/font.properties Platform-dependent font description file. See Adding Fonts to the Java Runtime for more information.
lib/jvm.hprof.txt Header text for reports generated by the Java heap profiler. See Profiling Java Programs and pjava.
lib/touchable.palettes Database containing RGB values for named color palettes for the Touchable look & feel design.
lib/classes.zip Optimized version. Zip archive containing the PersonalJava class library.
lib/classes_g.zip Debug version.
lib/sparc (Solaris only). Shared libraries for the virtual machine and native methods of the PersonalJava class library.