The HDF Java Products include a visual tool for browsing and editing HDF
files, a Java package providing an object-oriented interface to HDF data objects,
and Java Native Interfaces to the standard HDF libraries. The HDF Java Products
work with both HDF4 and HDF5 files.
A Java package that implements HDF4 and HDF5 data objects in
an object-oriented form.
The Java HDF Object Package provides a common Java API
for accessing HDF4 and HDF5 files.
The Java Native Interface to the standard HDF5 library.
Java HDF5 Interface (JHI5) is used to access the HDF5 library.
Current Release (February, 2009)
hdf-java 2.5 patch 01
Patch 01 was released on April 13, 2009. The major fix is a correction of image values.
For details, see release notes at
http://www.hdfgroup.org/ftp/HDF5/hdf-java/v25p1/README.
To obtain the patch, go to
http://www.hdfgroup.org/ftp/HDF5/hdf-java/v25p1Version 2.5 of the HDF Java Products was released February 11, 2009. This version
was built with HDF4.2r4 and HDF5 Release 1.8.2 with the 1.6 API Compatibility
Macros, using jdk 1.6.x.
Version 2.5 takes advantage of many of the improvements introduced in HDF5 Release 1.8.0.
However, since it relies on the 1.6 APIs, this version of hdf-java does not include the
200+ APIs introduced with HDF5 1.8.0, and cannot use features that are only accessible via those APIs.
HDF5 files created with HDF5 1.8.x APIs can be opened, but objects that use new file
format features will not be accessible with the hdf-java products. All files and objects
written by version 2.5 of the hdf-java products will be readable by applications linked
with 1.6.x or 1.8.x versions of the HDF5 library.
Please refer to the related HDF5 documentation for details:
The HDFView User's Guide section About This Release,
provides more information on Version 2.5 of HDFView, the visual browser.
Full support for HDF 1.8 will be provided in the next version of the HDF Java Products.
That version will:
(1) Implement HDF5 Java Native (JNI5) with new HDF5 1.8 APIs.
(2) Use new APIs in the hdf-java object package.
(3) Add features supported by the new APIs.
The source distribution is available from
http://www.hdfgroup.org/ftp/HDF5/hdf-java/src.
The source distribution includes the Java code to build
HDFView, the
Java HDF
Object Package, and related HDF4 and HDF5 Object Packages.
The source distribution also includes Java classes that declare the native
methods for
Java HDF
Interface (JHI) and
Java HDF5
Interface (JHI5), and C code that implements the native methods.
JHI requires the HDF4 4.2r4 library (binary) and JHI5 requires the HDF5 1.8.2
library (binary), which are not included in the HDF Java Products source
distribution. The HDF libraries can be obtained from the HDF Downloads page.
Building the HDF Java Products from the source distribution is not an easy
endeavor. Refer to the following the instructions for more details:
The pre-built binaries are available from
http://www.hdfgroup.org/ftp/HDF5/hdf-java/bin.
The pre-built binaries include all of the HDF Java Products listed in the
table above, as well as the HDF4 and HDF5 libraries required by JHI and JHI5.
Binaries are provided for linux, macosx, solaris, and windows
in the corresponding platform subdirectories of the ftp site.
