[ Previous section | Next section | Table of Contents ]

Installation


This section describes the contents of the EXTPKG package and how to install it for use by Java and any of the available IDEs.

Contents of EXTPKG.ZIP

The extension package is contained in the file called EXTPKG.ZIP and is made up of the following files.

File Description
EXTEND.TXT A short description file used for the IBM Software Reuse web site.
DOCS.ZIP The set of HTML and image files which document the EXTPKG package.
EXTEND.ZIP The compiled class files. This is the "runtime" code. It is the only file the Java compiler and virtual machine really care about.
EXTSRC.ZIP The source code for the extension classes.
SAMPLES.ZIP The source code for all my test drivers. They are included as working examples of how to use the classes.


Contents of Package Files

This section lists the contents of the various included ZIP files. If you are going to unzip any of the included files, you may need to use the -d option on your unzip tool to make sure that the proper subdirectories are created.

DOCS.ZIP

This section lists all the files which make up this documentation. The file extend.htm is the "root" file.

extend/docs/
extend/docs/adate.htm
extend/docs/awt.htm
extend/docs/calendar.htm
extend/docs/caov.htm
extend/docs/changes.htm
extend/docs/ciov.htm
extend/docs/classref.htm
extend/docs/containe.htm
extend/docs/datacont.htm
extend/docs/dcov.htm
extend/docs/einstall.htm
extend/docs/extend.htm
extend/docs/gbov.htm
extend/docs/groupbox.htm
extend/docs/hotspot.htm
extend/docs/itemproc.htm
extend/docs/managedc.htm
extend/docs/mcov.htm
extend/docs/nbov.htm
extend/docs/notebook.htm
extend/docs/overview.htm
extend/docs/pageveri.htm
extend/docs/util.htm
extend/docs/images/
extend/docs/images/bball.gif
extend/docs/images/Calendar.gif
extend/docs/images/constrct.gif
extend/docs/images/Details.gif
extend/docs/images/SpiralNB.gif
extend/docs/images/fields.gif
extend/docs/images/gball.gif
extend/docs/images/Icon.gif
extend/docs/images/List.gif
extend/docs/images/methods.gif
extend/docs/images/SimpleNB.gif
extend/docs/images/rball.gif
extend/docs/images/Tree.gif
extend/docs/images/yball.gif

EXTEND.ZIP

This section lists all the files which make up the EXTPKG package runtime.

extend/awt/
extend/awt/Calendar.class
extend/awt/ContainerItem.class
extend/awt/DataContainer.class
extend/awt/DetailsCanvas.class
extend/awt/GroupBox.class
extend/awt/HotSpot.class
extend/awt/IconCanvas.class
extend/awt/ItemProcessor.class
extend/awt/ListCanvas.class
extend/awt/ManagedContainer.class
extend/awt/NBRenderer.class
extend/awt/NBSimpleLook.class
extend/awt/NBSpiralLook.class
extend/awt/Notebook.class
extend/awt/PageVerifier.class
extend/awt/TreeCanvas.class
extend/awt/Utilities.class
extend/util/
extend/util/ADate.class

EXTSRC.ZIP

This section lists all the source files for the EXTPKG package.

extend/awt/
extend/awt/Calendar.java
extend/awt/ContainerItem.java
extend/awt/DataContainer.java
extend/awt/DetailsCanvas.java
extend/awt/GroupBox.java
extend/awt/HotSpot.java
extend/awt/IconCanvas.java
extend/awt/ItemProcessor.java
extend/awt/ListCanvas.java
extend/awt/ManagedContainer.java
extend/awt/NBRenderer.java
extend/awt/NBSimpleLook.java
extend/awt/NBSpiralLook.java
extend/awt/Notebook.java
extend/awt/PageVerifier.java
extend/awt/TreeCanvas.java
extend/awt/Utilities.java
extend/util/
extend/util/ADate.java

SAMPLES.ZIP

This section lists all the files which comprise the example and test code for the EXTPKG package.

Notebook/
Notebook/TestBed.java
Noteboot/TestBed.class
Notebook/StringPanel.java
Notebook/StringPanel.class
Notebook/printer.gif
DataConcainer/TestBed.java
DataContainer/TestBed.class
DataContainer/Cust.gif
DataContainer/Ball2.gif
DataContainer/printer.gif
GroupBox/TestBed.java
GroupBox/TestBed.class
Calendar/TestBed.java
Calendar/TestBed.class

Accessing the Classes

To use the classes contained in the EXTPKG package, you must make them known to Java. There are two ways to accomplish this.

  1. The easiest way is to place the EXTEND.ZIP file in any convenient subdirectory (such as C:\JAVA\LIB). All that is required is to place the fully qualified name of the file (C:\JAVA\LIB\EXTEND.ZIP for example) in the CLASSPATH environment variable. Ifthe fully qualified name is not correct, Java will be unable to locate the extension classes.

  2. The second way is to unzip the EXTEND.ZIP file into a subdirectory listed in the CLASSPATH environment variable. If your unzip tool does not automatically create subdirectories when unzipping a file, you mush specify the -d switch on the unzip commandto tell it to do so.

Once either of these steps has been accomplished, the classes will be accessible by Java. Do not forget to reboot your machine if you changed the CLASSPATH variable in your AUTOEXEC.BAT (or whatever).


Java IDE Setup

Below are steps to make the extension classes available to some Java IDEs.

Symantec Cafe

If you are using Symantec Caf‚, select "Settings" from the Project menu and enter the fully qualified name of the EXTEND.ZIP file in the Directories section of the notebook under "Class path".

Microsoft Visual J++

If you are using Microsoft Visual J++, select "Settings" from the Build menu and enter the fully qualified name of the EXTEND.ZIP file in the General section of the notebook under "Class path directories".


[ Previous section | Next section | Table of Contents ]