gov.nasa.pds.label.object

Class TableObject

java.lang.Object

gov.nasa.pds.label.object.DataObject

gov.nasa.pds.label.object.TableObject

public class TableObject
extends DataObject

Implements an object that represents a table in a PDS product. The table may be binary, character, or delimited.

Field Summary

Fields inherited from class gov.nasa.pds.label.object.DataObject

channel, dataObjectLocation, fileObject, localIdentifier, name, offset, parentDir

Constructor Summary

Constructors

Constructor and Description
TableObject(java.io.File parentDir, File fileObject, java.lang.Object tableObject, long offset, long size) Deprecated.
TableObject(java.io.File parentDir, File fileObject, java.lang.Object tableObject, long offset, long size, DataObjectLocation location) Creates a new instance of the table object.
TableObject(java.net.URL parentDir, File fileObject, java.lang.Object tableObject, long offset, long size) Deprecated.
TableObject(java.net.URL parentDir, File fileObject, java.lang.Object tableObject, long offset, long size, DataObjectLocation location) Creates a new instance of the table object.

Method Summary

Modifier and Type	Method and Description
FieldDescription[]	getFields() Gets the field descriptions for fields in the table.
RawTableReader	getRawTableReader() Returns a raw table reader for this table.
TableRecord	getRecord(int index, boolean keepQuotationsFlag) Gets access to the table record given the index.
java.lang.Object	getTableObject()
TableReader	getTableReader() Returns a table reader for this table.
TableRecord	readNext() Reads the next record from the data file.
void	setTableObject(java.lang.Object tableObject)

Methods inherited from class gov.nasa.pds.label.object.DataObject

closeChannel, getChannel, getDataFile, getDataObjectLocation, getInputStream, getLocalIdentifier, getName, getOffset, getSize, setDataObjectLocation, setLocalIdentifier, setName, setSize

Methods inherited from class java.lang.Object

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

Constructor Detail

TableObject

public TableObject(java.io.File parentDir,
                   File fileObject,
                   java.lang.Object tableObject,
                   long offset,
                   long size,
                   DataObjectLocation location)
            throws java.lang.Exception

Creates a new instance of the table object.

Parameters:

parentDir - the parent directory for the table object

fileObject - the file object describing the data file

tableObject - the table object describing the table

offset - the offset of the table object within the data file

size - the size of the table object, in bytes

Throws:

java.lang.Exception - if there is any error accessing the table

TableObject

public TableObject(java.net.URL parentDir,
                   File fileObject,
                   java.lang.Object tableObject,
                   long offset,
                   long size,
                   DataObjectLocation location)
            throws java.lang.Exception

Creates a new instance of the table object.

Parameters:

parentDir - the parent directory for the table object

fileObject - the file object describing the data file

tableObject - the table object describing the table

offset - the offset of the table object within the data file

size - the size of the table object, in bytes

Throws:

java.lang.Exception - if there is any error accessing the table

TableObject

@Deprecated
public TableObject(java.io.File parentDir,
                               File fileObject,
                               java.lang.Object tableObject,
                               long offset,
                               long size)
                        throws java.lang.Exception

Deprecated.

Deprecated initializer. Missing DataObjectLocation

Throws:

java.lang.Exception

TableObject

@Deprecated
public TableObject(java.net.URL parentDir,
                               File fileObject,
                               java.lang.Object tableObject,
                               long offset,
                               long size)
                        throws java.lang.Exception

Deprecated.

Deprecated initializer. Missing DataObjectLocation

Throws:

java.lang.Exception

Method Detail

getTableReader

public TableReader getTableReader()
                           throws java.lang.Exception

Returns a table reader for this table.

Returns:

a table reader

Throws:

java.lang.Exception - if there is an error creating the table reader

getRawTableReader

public RawTableReader getRawTableReader()
                                 throws java.lang.Exception

Returns a raw table reader for this table.

Returns:

a table reader

Throws:

java.lang.Exception - if there is an error creating the table reader

getFields

public FieldDescription[] getFields()
                             throws java.lang.Exception

Gets the field descriptions for fields in the table.

Returns:

an array of field descriptions

Throws:

java.lang.Exception

readNext

public TableRecord readNext()
                     throws java.io.IOException,
                            com.opencsv.exceptions.CsvValidationException,
                            java.lang.Exception

Reads the next record from the data file.

Returns:

the next record, or null if no further records.

Throws:

java.io.IOException - if there is an error reading from the data file

com.opencsv.exceptions.CsvValidationException

java.lang.Exception

getRecord

public TableRecord getRecord(int index,
                             boolean keepQuotationsFlag)
                      throws java.lang.Exception

Gets access to the table record given the index. The current row is set to this index, thus, subsequent call to readNext() gets the next record from this position.

Parameters:

index - the record index (1-relative)

Returns:

an instance of TableRecord

Throws:

java.lang.Exception

getTableObject

public java.lang.Object getTableObject()

setTableObject

public void setTableObject(java.lang.Object tableObject)