README
Java 2 SDK, Standard Edition
v 1.2.2
Introduction
Thank you for downloading this release of the
Java 2 SDK, Standard Edition.
The Java 2 SDK is a development environment for building applications,
applets, and components that can be deployed on the Java platform.
Click here to see a
Japanese version of this README.
The Java 2 SDK software includes tools useful for developing and
testing programs written in the Java programming language and running on
the Java platform. These tools are designed to be used from the command
line. Except for appletviewer, these tools do not provide a graphical user
interface.
The Win32 version of the Java 2 SDK includes the Java Plug-in. You
can use the Java Plug-in to enable the Internet Explorer and Netscape
Navigator browsers to run applets based on the Java 2 platform.
The Linux version of the Java 2 SDK v 1.2.2 does not include Java Plug-in.
Future plans call for a Linux port of Java Plug-in and inclusion of it as part of the Linux JRE.
For more information about the Java Plug-in, including how to obtain a version
for the Solaris Operating Environment,
see the section Java 2 Runtime Environment
and Java Plug-in below.
Features
The Java 2 SDK offers significant improvements in functionality,
performance, security and global support over previous versions of
the Java platform.
Installation
The complete SDK is composed of the SDK Software plus the SDK
Documentation, each of which is separately downloadable.
Refer to the installation instructions for each operating system:
Java 2 SDK Documentation
The Java 2 SDK Documentation
contains API specifications, developer guides, tool reference pages,
demos, and links to related information.
It is available in a download bundle which you can install locally with your
Java 2 SDK software. See the
Java 2 SDK download page.
System Requirements
The Java 2 SDK software is available on four platforms:
- Microsoft Windows Version for Microsoft Windows 95, 98,
NT 4.0, and 2000 on Intel hardware.
A 486/DX or faster processor. 32 megabytes RAM
minimum, 48 megabytes RAM recommended.
- Solaris/SPARC Version. Only Solaris versions 2.5.1,
2.6 and 7 (also known as 2.7) are supported. 32 megabytes RAM minimum,
48 megabytes RAM recommended.
- Solaris/Intel Version. Only Solaris versions 2.5.1, 2.6
and 7 (also known as 2.7) are supported. A 486/DX or faster processor.
32 megabytes RAM minimum, 48 megabytes RAM recommended.
- Linux/Intel Version
This version of the Java 2 SDK is supported on Intel Pentium platform
running the Linux kernel v 2.2.5 and glibc v 2.1, 32 megabytes RAM
minimum. Recommended 48 megabytes of RAM, 16-bit color mode,
KDE and KWM window managers. Sun Microsystems, Inc. has tested
this release using Red Hat Linux 6.0.
On all systems you should have 65 megabytes of free disk space before
attempting to install the Java 2 SDK software. If you also install the
separate documentation download bundle, you need an additional 90 megabytes
of free disk space.
Solaris users will want to insure that they have
installed the full set of required patches needed for support of this release.
To obtain patches, see the
SunSolve support website. You will find a patch cluster
for each Solaris Operating Environment platform. Each patch cluster
applies to all supported versions of the Java 2 Standard Edition (J2SE)
on the given platform.
It is strongly recommended that Solaris 2.6 users load the SUNWi1of
package for optional Latin-1 fonts. This package is in the "Entire
Distribution" Cluster, available on the Solaris software installation
CD-ROM. SUNWi1of contains English Monotype TrueType fonts specified in
the font properties files. Without this package, fonts will default to
the LucidaSans font for off-screen text and to Type1 font for text in
components.
Note for Linux users:
Linux users should check their version of glibc using the following command:
ls /lib/libc-*
The output of this command should show libc-2.1.so or higher.
We do not support or recommend running the Java 2 SDK on SMP kernels. Also the only thread model supported is green threads.
Release Notes
See the Release Notes for a summary of
changes to the Java 2 SDK from version to version.
Compatibility
See Compatibility with Previous Releases
for a list of known compatibility issues. Every effort has been made to
support programs written for the 1.0 or 1.1 platform. Although some
incompatible changes were necessary, most software should migrate to
current version with no reprogramming. Any failure to do so is
considered a bug, except for a small number of cases where compatibility
was deliberately broken, as described on our compatibility page. Some
compatibility-breaking changes were required to close potential
security holes or to fix implementation or design bugs.
Demos
A demo directory is included in the software bundle with a
variety of applets and Swing applications for you to try out. The
demos come with complete source code.
Bug Reports and Feedback
The
Bug Parade
Web Page on the Java Developer Connection website lets you search
for and examine existing bug reports,
submit your own bug reports, and tell us which bug fixes matter most
to you.
Note - You should not seek technical support from Bug Parade or our
development teams. For support options, see
Support and Services on the
Java Software web site.
Contents of the Java 2 SDK
This section contains a general summary of the files and directories in
the Java 2 SDK. For details on the files and directories,
refer to the downloadable documentation bundle.
- Development Tools
- (In the
bin subdirectory.) Programs that will
help you develop, execute, debug, and document programs written
in the Java programming language.
Note: Linux users may refer to the Solaris SDK tools documentation,
since the SDK tools available on Linux are identical to those available for
the Solaris Operating Environment.
- Java Runtime Environment
- (In the
jre subdirectory.)
An implementation of the Java runtime environment for use by
the SDK. The runtime environment includes a Java
virtual machine*, class libraries, and other files that support
the execution of programs written in the
Java programming language.
- Additional libraries
- (In the
lib subdirectory.) Additional class
libraries and support files required by the development tools.
- Demo Applets and Applications
- (In the
demo subdirectory.) Examples, with
source code, of programming for the Java platform. These
include examples that use Swing and other Java Foundation
Classes.
- C header Files
- (In the
include subdirectory.) Header
files that support native-code programming using the
Java Native Interface and the Java Virtual Machine Debugger Interface.
- Old Native Interface Headers
- (In the
include-old subdirectory.) Header
files that support native-code programming using older
interfaces. The header files in include-old
are provided only for
backward-compatibility. These interfaces are deprecated,
unsupported and
not available on all Java virtual machines.
- Source Code
- (In
src.jar archive file.) Java programming
language source files for all classes that make up the Java 2
core API
(that is, source files for the java.*, javax.* and org.omg.*
packages, but not for com.sun.* packages).
This source code is provided for informational purposes
only, to help developers learn and use the Java programming
language. These files do not include platform-specific
implementation code and cannot be used to rebuild the
class libraries. To extract these file, use this command:
jar xvf src.jar
Do not modify core API source files. To extend the behavior of
the core API, write subclasses of the core API classes.
For API documentation, refer to the following sources:
- The Java Platform API Specification in the documentation
download bundle. This provides brief descriptions of the API with
an emphasis on specifications, not on examples.
- The
Java Class Libraries, Second Edition, published by
Addison-Wesley Longman as part of
The Java Series.
These volumes include much more elaborate descriptions,
with definitions of terminology and examples for practically
every class, interface and member.
- Documentation
- (In the
docs subdirectory.) This directory is
created when the Java 2 SDK documentation is installed. It contains
release documentation, Java API specifications, developer guides,
tool documentation, demos, and links to related documentation.
The Java 2 Runtime Environment and Java Plug-in
The download bundle for the Win32 version of the Java 2 SDK
includes a redistributable copy of the Java 2 Runtime Environment
and Java Plug-in,
which you may optionally choose to install.
The Java 2 Runtime Environment allows you to run applications
written in the Java programming language. It consists of the
Java virtual machine, classes comprising the Java API, and supporting
files, but contains no development tools such as compilers and
debuggers. You may freely redistribute the Java 2 Runtime Environment
with your application, according to the terms of the Runtime
Environment's license. Once you've developed your application using the
Java 2 SDK, you can ship it with the Runtime Environment so
your end-users will have a Java platform on which to run your
software.
Note that the Java 2 SDK has an internal implementation of
a Java runtime environment for its own use. This internal runtime
environment is contained in the SDK software's jre directory.
Don't confuse the SDK's internal runtime environment with the
Java 2 Runtime Environment, which is a separately installable
product.
The Java 2 Runtime Environment requires additional
software -- the Java Plug-in -- to enable it to run applets in
a browser.
The Java Plug-in software allows Java applets and JavaBeans
components to run in a browser using Sun's Java 2 Runtime
Environment instead of the browser's default Java environment.
The Java Plug-in works with Netscape Navigator and Microsoft
Internet Explorer. For general information on the Java Plug-in, see
the
Java
Plug-in Overview.
For documentation and an FAQ on the Java Plug-in, see
Java Plug-in.
After you've installed the plug-in,
you will see that the "Java Plug-in control panel" has been
added to your Microsoft Windows "Start" menu under "Programs". The
plug-in will automatically load the Java runtime
environment when the browser loads an HTML page with a special
<OBJECT> HTML tag. The browser can then load applets from this
page to make full use of 1.2 features, such as JFC (including
Swing) and IDL. For details on how to configure your HTML pages
to invoke the Java 2 runtime environment, see "Documentation" at Sun's
Java Plug-in website.
Solaris versions of the Java 2 Runtime Environment and
Java Plug-in are also available. Unlike the Win32 versions of
these products, they are not included as optional parts of
the Solaris Java 2 SDK installation. You can, however, download
Solaris versions of the Java 2 Runtime Environment and Java Plug-in
from the Java Software website.
You may redistribute the Java 2 Runtime Environment and Java Plug-in
with your application, applet or JavaBean components, subject to the
terms and conditions of its software license (found in the /Plug-in
README and LICENSE files).
As mentioned earlier in this document,
the Linux version of the Java 2 SDK v 1.2.2 does not include Java Plug-in. Future plans call for a Linux port of Java Plug-in and
inclusion of it as part of the Linux JRE.
Redistribution
The term "vendors" used here refers to licensees, developers, and
independent software vendors (ISVs) who license and distribute the
Java 2 Runtime Environment with their programs.
Vendors must follow the terms of the Java 2 SDK, Standard Edition,
Binary Code License agreement.
Required vs. Optional Files
The files that make up the Java 2 SDK, Standard Edition, are divided into
two categories: required and optional. Optional files may be excluded
from redistributions of the Java 2 SDK at the
vendor's discretion.
The following section contains a list of the files and directories that
may optionally be omitted from redistributions of the Java 2 SDK. All
files not in these lists of optional files must be
included in redistributions of the Java 2 SDK.
Win32 Optional Files and Directories
All font properties files in the lib directory other than the default
jre\lib\font.properties file are optional, and vendors may
choose not to include them in redistributions of the Java 2 Runtime
Environment. In addition, the following may be optionally excluded from
redistributions:
- jre\bin\beans.ocx
- Plugin ActiveX control
- lib\jaws.jar
- Plugin classes
- lib\i18n.jar
- Character conversion classes and all other locale support
- lib\ext\
- Directory containing extension jar files
- bin\symcjit.dll
- JIT compiler
- bin\rmid.exe and jre\bin\rmid.exe
- Java RMI Activation System Daemon
- bin\rmiregistry.exe and jre\bin\rmiregistry.exe
- Java Remote Object Registry
- bin\tnameserv.exe and jre\bin\tnameserve.exe
- Java IDL Name Server
- bin\keytool.exe and jre\bin\keytool.exe
- Key and Certificate Management Tool
- bin\policytool.exe and jre\bin\policytool.exe
- Policy File Creation and Management Tool
- src.jar
- Archive of source files
Optional Files and Directories for Solaris Operating Environment and Linux
The directory referred to as <sys> in the list below varies depending
on the hardware architecture implementation. It will be either
sparc or i386.
All font properties files in the lib directory other than the default
jre/lib/font.properties file for Solaris 2.6 and the default
jre/lib/font.properties.5.5.1 file for Solaris 2.5.1 are optional,
and vendors may choose not to include them in redistributions of the
Java 2 Runtime Environment. In addition, the following may be
optionally excluded from redistributions:
- jre/lib/i18n.jar
- Character conversion classes and all other locale support
- jre/lib/<sys>/libsunwjit.so (Solaris only)
- JIT compiler
- jre/lib/ext/
- Directory containing extension jar files
- src.jar
- Archive of source files
Sun Java Web Pages
For additional information, refer to these Sun Microsystems pages on the
World Wide Web:
- http://java.sun.com/
- The Java Software web site, with the latest information on
Java technology, product information, news, and features.
- http://java.sun.com/docs
- Java Platform Documentation provides access to white papers, the
Java Tutorial and other documents.
- http://developer.java.sun.com/
- The Java Developer Connection web site. (Free registration
required.) Additional technical information, news, and
features; user forums; support information, and much more.
- http://java.sun.com/products/
- Java Technology Products & API
- http://www.sun.com/solaris/java/
- Java Development Kit for Solaris - Production Release
Credits
The Java 2 Platform, Standard Edition port to Linux was made possible by the
efforts of several volunteers of the Blackdown porting team. Sun is
grateful to the Blackdown porting team members and their support of the Java on
Linux community. Special gratitude goes to the following
Blackdown porting team members:
- Juergen Kreileder
- Kevin B. Hendricks
- Steve Byrne
- Johan Vos
- Eddie Dost
- Scott Hutinger
- Karl Asha
- Kars de Jong
- Nigel Gamble
- Michael Sinz
- Brad Crochet
*As used on this web site, the terms "Java virtual machine" or "JVM"
mean a virtual machine for the Java platform.
|
Print-friendly Version
