Preface
This porting guide describes how to port
the PersonalJava application environment (PJAE) to a target RTOS.
Some readers may want to rush right into the porting process
and go straight to the source code.
But the careful reader will get
enough useful information to make it worthwhile
to spend time reading this porting guide.
In any event, we've organized it in such a way
to make it easy to find information in a hurry.
This porting guide takes a high-level,
top-down approach to the porting process.
The goal is to provide enough coverage
of the different porting tasks to help with planning
and enough overview and reference material
to present a good perspective of the porting layers.
The primary reader is a software engineer responsible for performing
the initial port of the PJAE to a target RTOS.
Since the PJAE is based on Java technology
developed for the desktop-oriented Java Development Kit (JDK),
it helps to have experience with JDK 1.1.x.
The reader should also be familiar with the following topics:
-
operating systems
-
object-oriented programming
-
design patterns
-
Java programming
-
C programming
-
assembly language programming
-
Solaris & GNU software development tools
-
Microsoft Windows NT development tools
The following documentation provides important background information:
This porting guide is loosely organized around the process
of porting the PJAE to a target RTOS:
-
Introduction
provides an introduction to the PJAE
and its place in the Java world.
-
Build Environment
describes the PJES build environment.
This section concentrates on the hardware and software requirements
for the PJES build environment and its setup procedures.
-
Build Environment Procedures
describes the procedures
for using the PJES build environment
to configure and build a PJAE executable image for a target RTOS.
-
Build Environment Implementation
describes the structure of the PJES build environment.
It provides background information for licensees
who need to integrate the PJES build environment into
their own build environments.
-
Source Code Organization
describes the organization of the PJES source code.
This includes the build environment
and the platform-independent and platform-dependent source code.
-
Porting the Virtual Machine
describes how to port the PersonalJava virtual machine to a target RTOS.
This includes an architectural overview,
step-by-step procedures and reference documentation
for the host programming interface (HPI) functions.
-
Porting Truffle
describes how to port Truffle to a target RTOS.
-
Porting the Java Networking Classes
describes how to port the Java network classes to a target RTOS
based on a socket interface.
-
Porting the Java Audio Classes
describes how to port the Java audio classes to a target RTOS.
While these classes are used by java.applet,
they do not have an external API.
For technical comments or questions, please send e-mail to:
javaoem-pjava@sun.com
or visit the
Java Technology Licensee Engineering
web site.