test.unittests
Class H5CompoundDSTest

java.lang.Object
  TestCase
      test.unittests.H5CompoundDSTest

public class H5CompoundDSTest
extends TestCase

TestCase for H5CompoundDS.

This class tests all the public methods in H5CompoundDS class.

The test file contains the following objects.

 
        /dataset_byte            Dataset {50, 10}
        /dataset_comp            Dataset {50, 10}
        /dataset_enum            Dataset {50, 10}
        /dataset_float           Dataset {50, 10}
        /dataset_image           Dataset {50, 10}
        /dataset_int             Dataset {50, 10}
        /dataset_str             Dataset {50, 10}
        /g0                      Group
        /g0/dataset_comp         Dataset {50, 10}
        /g0/dataset_int          Dataset {50, 10}
        /g0/datatype_float       Type
        /g0/datatype_int         Type
        /g0/datatype_str         Type
        /g0/g00                  Group
        /g0/g00/dataset_float    Dataset {50, 10}
        /g0_attr                 Group

 

We use the following template to test all the methods:

What to test:

• Test for boundary conditions
• Test for failure
• Test for success on general functionality

Constructor Summary

H5CompoundDSTest(java.lang.String arg0)

Method Summary

protected void	setUp()
protected void	tearDown()
void	testClear() Test method for H5CompoundDS.clear().
void	testClose() Test method for H5CompoundDS.close(int).
void	testCreateStringGroupLongArrayLongArrayLongArrayIntStringArrayDatatypeArrayIntArrayIntArrayArrayObject() Test method for H5CompoundDS.create(java.lang.String, ncsa.hdf.object.Group, long[], long[], long[], int, java.lang.String[], ncsa.hdf.object.Datatype[], int[], int[][], java.lang.Object).
void	testCreateStringGroupLongArrayStringArrayDatatypeArrayIntArrayIntArrayArrayObject() Test method for H5CompoundDS.create(java.lang.String, ncsa.hdf.object.Group, long[], java.lang.String[], ncsa.hdf.object.Datatype[], int[], int[][], java.lang.Object).
void	testCreateStringGroupLongArrayStringArrayDatatypeArrayIntArrayObject() Test method for H5CompoundDS.create(java.lang.String, ncsa.hdf.object.Group, long[], java.lang.String[], ncsa.hdf.object.Datatype[], int[], java.lang.Object).
void	testGetDatatype() Test method for H5CompoundDS.getDatatype().
void	testGetMetadata() Test method for H5CompoundDS.getMetadata().
void	testGetSize() Test method for H5CompoundDS.getSize(int).
void	testH5CompoundDSFileFormatStringString() Test method for H5CompoundDS.H5CompoundDS(ncsa.hdf.object.FileFormat, java.lang.String, java.lang.String).
void	testH5CompoundDSFileFormatStringStringLongArray() Test method for H5CompoundDS.H5CompoundDS(ncsa.hdf.object.FileFormat, java.lang.String, java.lang.String, long[]).
void	testInit() Test method for H5CompoundDS.init().
void	testIsString() Test method for H5CompoundDS.isString(int).
void	testOpen() Test method for H5CompoundDS.open().
void	testRead() Test method for H5CompoundDS.read().
void	testReadByField() Test method for H5CompoundDS.read().
void	testReadByRow() Test method for H5CompoundDS.read().
void	testReadBytes() Test method for H5CompoundDS.readBytes().
void	testRemoveMetadata() Test method for H5CompoundDS.removeMetadata(java.lang.Object).
void	testSetName() Test method for H5CompoundDS.setName(java.lang.String).
void	testWriteByField() Test method for H5CompoundDS.write(java.lang.Object).
void	testWriteByRow() Test method for H5CompoundDS.write(java.lang.Object).
void	testWriteMetadata() Test method for H5CompoundDS.writeMetadata(java.lang.Object).
void	testWriteObject() Test method for H5CompoundDS.write(java.lang.Object).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

H5CompoundDSTest

public H5CompoundDSTest(java.lang.String arg0)

Parameters:

arg0 -

Method Detail

setUp

protected void setUp()
              throws java.lang.Exception

Throws:

java.lang.Exception

tearDown

protected void tearDown()
                 throws java.lang.Exception

Throws:

java.lang.Exception

testSetName

public final void testSetName()

Test method for H5CompoundDS.setName(java.lang.String).

What to test:

• Test for boundary conditions
  • Set name to null
• Test for failure
  • Set a name that already exists in file.
• Test for general functionality
  • change the dataset name
  • close/re-open the file
  • get the dataset with the new name
  • failure test: get the dataset with the original name
  • set the name back to the original name

testOpen

public final void testOpen()

Test method for H5CompoundDS.open().

What to test:

• open a dataset identifier
• get datatype and dataspace identifier for the dataset
• Repeat all above

testClose

public final void testClose()

Test method for H5CompoundDS.close(int).

What to test:

• open a dataset identifier
• get datatype and dataspace identifier for the dataset
• close dataset
• failure test for the closed did
• Repeat all above

testClear

public final void testClear()

Test method for H5CompoundDS.clear().

What to test:

• Read data/attributes from file
• clear the dataet
• make sure that the data is empty
• make sure that the attribute list is empty

testInit

public final void testInit()

Test method for H5CompoundDS.init().

What to test:

• call init()
• make that the dataspace is correct
• make sure that member selection is correct
• Repeat all above

testRead

public final void testRead()

Test method for H5CompoundDS.read().

What to test:

• Read the whole dataset
• Repeat all above

testReadByRow

public final void testReadByRow()

Test method for H5CompoundDS.read().

What to test:

• Read data row by row
• Repeat all above

testReadByField

public final void testReadByField()

Test method for H5CompoundDS.read().

What to test:

• Read data field bu field
• Repeat all above

testReadBytes

public final void testReadBytes()

Test method for H5CompoundDS.readBytes().

What to test:

• Read the whole dataset in a byte buffer
• check the data size

testWriteObject

public final void testWriteObject()

Test method for H5CompoundDS.write(java.lang.Object).

What to test:

• Read/write the whole dataset
• Repeat all above
• write the original data back to file

testWriteByRow

public final void testWriteByRow()

Test method for H5CompoundDS.write(java.lang.Object).

What to test:

• Read/write data row by row
• Repeat all above
• write the original data back to file

testWriteByField

public final void testWriteByField()

Test method for H5CompoundDS.write(java.lang.Object).

What to test:

• Read/write data field by field
• Repeat all above
• write the original data back to file

testGetDatatype

public final void testGetDatatype()

Test method for H5CompoundDS.getDatatype().

What to test:

• Get the datatype object of the dataset

testIsString

public final void testIsString()

Test method for H5CompoundDS.isString(int).

What to test:

• Test a string datatype with isString(int tid)
• Test a non-string datatype with isString(int tid)

testGetSize

public final void testGetSize()

Test method for H5CompoundDS.getSize(int).

What to test:

• Test a sizes of different defined data types

testH5CompoundDSFileFormatStringString

public final void testH5CompoundDSFileFormatStringString()

Test method for H5CompoundDS.H5CompoundDS(ncsa.hdf.object.FileFormat, java.lang.String, java.lang.String).

What to test:

• Construct an H5CompoundDS object that exits in file
  • new H5CompoundDS (file, null, fullpath)
  • new H5CompoundDS (file, fullname, null)
  • new H5CompoundDS (file, name, path)
• Construct an H5CompoundDS object that does not exist in file

testH5CompoundDSFileFormatStringStringLongArray

public final void testH5CompoundDSFileFormatStringStringLongArray()

Test method for H5CompoundDS.H5CompoundDS(ncsa.hdf.object.FileFormat, java.lang.String, java.lang.String, long[]).

What to test:

• Construct an H5CompoundDS object that exits in file
  • new H5CompoundDS (file, null, fullpath, oid)
  • new H5CompoundDS (file, fullname, null, oid)
  • new H5CompoundDS (file, name, path, oid)
• Construct an H5CompoundDS object that does not exist in file

testGetMetadata

public final void testGetMetadata()

Test method for H5CompoundDS.getMetadata().

What to test:

• Get all the attributes
• Check the content of the attributes

testWriteMetadata

public final void testWriteMetadata()

Test method for H5CompoundDS.writeMetadata(java.lang.Object).

What to test:

• Update the value of an existing attribute
• Attach a new attribute
• Close and re-open file to check if the change is made in file
• Restore to the orginal state

testRemoveMetadata

public final void testRemoveMetadata()

Test method for H5CompoundDS.removeMetadata(java.lang.Object).

What to test:

• Remove all existing attributes
• Close and reopen file to check if all attribute are removed from file
• Restore to the orginal state

testCreateStringGroupLongArrayStringArrayDatatypeArrayIntArrayObject

public final void testCreateStringGroupLongArrayStringArrayDatatypeArrayIntArrayObject()

Test method for H5CompoundDS.create(java.lang.String, ncsa.hdf.object.Group, long[], java.lang.String[], ncsa.hdf.object.Datatype[], int[], java.lang.Object).

Create a simple compound dataset, i.e. compound members can be either a scalar data or 1D array.

        public static Dataset create(
            String name,
            Group pgroup,
            long[] dims,
            String[] memberNames,
            Datatype[] memberDatatypes,
            int[] memberSizes,
            Object data) throws Exception
 

What to test:

• Create new compound datasets
  • Compound dataset with one field -- an 1D integer array: {int[]}
  • Compound dataset with one field -- an 1D float array: {float[]}
  • Compound dataset with one field -- a string: {string}
  • Compound dataset with three fields {int[], float[], string}
• Close and reopen the file
• Check the content of the new datasets
• Restore to the orginal file (remove the new datasets)

testCreateStringGroupLongArrayStringArrayDatatypeArrayIntArrayIntArrayArrayObject

public final void testCreateStringGroupLongArrayStringArrayDatatypeArrayIntArrayIntArrayArrayObject()

Test method for H5CompoundDS.create(java.lang.String, ncsa.hdf.object.Group, long[], java.lang.String[], ncsa.hdf.object.Datatype[], int[], int[][], java.lang.Object).

Create a simple compound dataset, i.e. compound members can be multiple-dimensional array.

        public static Dataset create(
            String name,
            Group pgroup,
            long[] dims,
            String[] memberNames,
            Datatype[] memberDatatypes,
            int[] memberRanks,
            int[][] memberDims,
            Object data) throws Exception
 

What to test:

• Create new compound datasets
• Compound dataset with two fields -- {int[][], float[][]}
• Close and reopen the file
• Check the content of the new datasets
• Restore to the orginal file (remove the new dataset)

testCreateStringGroupLongArrayLongArrayLongArrayIntStringArrayDatatypeArrayIntArrayIntArrayArrayObject

public final void testCreateStringGroupLongArrayLongArrayLongArrayIntStringArrayDatatypeArrayIntArrayIntArrayArrayObject()

Test method for H5CompoundDS.create(java.lang.String, ncsa.hdf.object.Group, long[], long[], long[], int, java.lang.String[], ncsa.hdf.object.Datatype[], int[], int[][], java.lang.Object).

Create a simple compound dataset with compression options, i.e. compound members can be multiple-dimensional array.

        public static Dataset create(
            String name,
            Group pgroup,
            long[] dims,
            long[] maxdims,
            long[] chunks,
            int gzip,
            String[] memberNames,
            Datatype[] memberDatatypes,
            int[] memberRanks,
            int[][] memberDims,
            Object data) throws Exception
 

What to test:

• Create new compound datasets with level-9 gzip compression
• Compound dataset with three fields -- {int, float, string}
• Close and reopen the file
• Check the content of the new datasets
• Restore to the orginal file (remove the new dataset)