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
hdf-java 2.6.1 release (March 5, 2010)
This release was built with HDF 4.2.5 and HDF5 1.8.4 Patch 1 with
the 1.6 API Compatibility Macros, using jdk 1.6.x.
HDF5 1.8.4 Patch 1
fixes a corruption problem that existed from HDF5 1.8.0 through HDF5 1.8.4. For
more information, see
the Known Problems page.
No major change in hdf-java since hdf-java 2.6. Some minor changes include:
Use better memory allocation in HDF4 JNI to avoid crash on OutOfMemory error on large dataset.
Show some HDF-EOS attributes stored in HDF4 vdata.
Fix a problem of displaying information for HDF4 vdata without name.
Add HDF-Java logging levels to HDF5 JNI and set default level to "SEVERE".
To obtain hdf-java products (HDFView installers, Pre-built binaries, and Source code),
go to http://www.hdfgroup.org/ftp/HDF5/hdf-java/.
For more information on the current release, please read About This Release.
The current version of hdf-java 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 teh current version of hdf-java 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:
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 library (binary) and JHI5 requires the HDF5
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.
