NCSA HDF Java Source


The HDF 4.1r2 source distribution contains the full source for the Java HDF Interface (JHI) and the Java HDF Viewer (JHV). The JHI and JHV are automatically built as a single package, although applications developers may wish to use the JHI without the JHV.

The compressed version of the HDF Java source code is available at:

Code Dependencies

  1. The JHV requires the JHI.
  2. The JHI does not depend on the JHV, and may be used separately.
  3. The JHI requires the HDF 4.1r2 library binary.
  4. The source for the HDF library is not required to compile the JHI.

System Requirements

The Java and C source should compile on any system that has:

  1. The HDF 4.1r2 library binary
  2. Java JDK 1.1 or above
  3. An ANSI C compiler

Note: The Java runtime system links to native methods using dynamic libraries. Consequently, the JHI must be compiled as a dynamically loaded library. The details of compiling dynamic libraries vary considerably from platform to platform. The NCSA Java products are completely portable to all platforms, but the build process is different for different platforms.


The NCSA Java source distribution is a single package that contains two complete products.

    1. The Java HDF Interface (JHI)

    The Java HDF Inteface has Java classes and C libraries which are loaded by the Java classes. The C libraries contain the implementations of native methods, including calls to the HDF library itself.

    The same Java and C source is used on all platforms, only the compilation and linking are machine specific.

    The source distribution include configuration and Makefiles for four Unix platforms:

    1. Solaris
    2. Solaris X86
    3. SGI Irix 5.3
    4. Linux

    The source code also works on Windows95/NT.

    The source code should work on most other Unix platforms but compilation configurations are not provided in this release.

    2. The Java HDF Viewer (JHV)

    The Java HDF Viewer contains Java classes and a C library. The C library contains code that manipulates images. The JHV accesses HDF files using the JHI classes.

    In the standard distribution, the JHV is automatically compiled with the JHI.

Javadoc documentation

The javadoc documentation for the JHV and JHI is available on line.

It is also included as separate part of the binary distribution, or can be generated from the source with the command `make javadocs'.

Compiling with the HDF library source

The JHI and JHV compile and link to the HDF 4.1r2 library. The Java source is distributed as part of the HDF library source. To compile both HDF and the Java HDF products, build the HDF library first, and then configure the Java Makefiles to use the HDF library just built. (See the README and INSTALL files.)


NCSA
HDF Group

hdfhelp@ncsa.uiuc.edu
HDF Group, NCSA

Modified Date: 15 March 1998