ncsa.hdf.object
Interface DataFormat

All Known Implementing Classes:

CompoundDS, Dataset, Datatype, Group, H4Datatype, H4GRImage, H4Group, H4SDS, H4Vdata, H5CompoundDS, H5Datatype, H5Group, H5ScalarDS, HObject, ScalarDS

public interface DataFormat

An interface that provides general I/O operations for read/write object data. For example, reading data content or data attribute from file into memory or writing data content or data attribute from memory into file.

See Also:

HObject

Method Summary

java.lang.String	getFile() Returns the full path of the file that contains this data object.
java.util.List	getMetadata() Retrieves the metadata such as attributes from file.
void	removeMetadata(java.lang.Object info) Deletes an existing metadata from this data object.
void	writeMetadata(java.lang.Object info) Writes a specific metadata (such as attribute) into file.

Method Detail

getFile

java.lang.String getFile()

Returns the full path of the file that contains this data object.

The file name is necessary because data objects are uniquely identified by object reference and file name when mutilple files are opened at the same time.

getMetadata

java.util.List getMetadata()
                           throws java.lang.Exception

Retrieves the metadata such as attributes from file.

Metadata such as attributes are stored in a List.

Returns:

the list of metadata objects.

Throws:

java.lang.Exception

writeMetadata

void writeMetadata(java.lang.Object info)
                   throws java.lang.Exception

Writes a specific metadata (such as attribute) into file.

If metadata exists, the method updates its value. If the metadata does not exists in file, it creates the metadata in file and attaches it to the object.

Parameters:

info - the metadata to write.

Throws:

java.lang.Exception

removeMetadata

void removeMetadata(java.lang.Object info)
                    throws java.lang.Exception

Deletes an existing metadata from this data object.

Parameters:

info - the metadata to delete.

Throws:

java.lang.Exception