org.youscope.common.table

Class Table

java.lang.Object

org.youscope.common.table.Table

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<RowView>

public class Table
extends java.lang.Object
implements java.lang.Cloneable, java.io.Serializable, java.lang.Iterable<RowView>

A table, containing entries of specific TableEntry types. Tables are used in YouScope to e.g. communicate between jobs, or to log states of jobs.

Author:

Moritz Lang

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
	Table(java.lang.String tableName, java.lang.String tableDescription, ColumnDefinition<?>... columnDefinitions) Constructor using information on the column names and types.
	Table(java.lang.String tableName, java.lang.String tableDescription, long creationTime, ColumnDefinition<?>... columnDefinitions) Constructor using information on the column names and types.
	Table(java.lang.String tableName, java.lang.String tableDescription, long creationTime, PositionInformation positionInformation, ExecutionInformation executionInformation, ColumnDefinition<?>... columnDefinitions) Constructor using information on the column names and types.
	Table(java.lang.String tableName, java.lang.String tableDescription, PositionInformation positionInformation, ExecutionInformation executionInformation, ColumnDefinition<?>... columnDefinitions) Constructor using information on the column names and types.
protected	Table(Table other) Protected Copy constructor.
	Table(TableDefinition tableDefinition) Constructor using an already available TableDefinition.
	Table(TableDefinition tableDefinition, long creationTime) Constructor using an already available TableDefinition.
	Table(TableDefinition tableDefinition, long creationTime, PositionInformation positionInformation, ExecutionInformation executionInformation) Constructor using an already available TableDefinition.
	Table(TableDefinition tableDefinition, PositionInformation positionInformation, ExecutionInformation executionInformation) Constructor using an already available TableDefinition.

Method Summary

Modifier and Type	Method and Description
void	addRow(java.io.Serializable... values) Adds a row to the table.
void	addRow(TemporaryRow temporaryRow) Adds a temporary row to this table.
void	addRows(Table table) Adds all rows of the table at the end of the rows of this table.
Table	clone()
TemporaryRow	createTemporaryRow() Creates a temporary row.
boolean	equals(java.lang.Object obj)
java.lang.String	getColumnName(int column) Returns the name (title) of the column with the given index.
java.lang.String[]	getColumnNames() Returns the names (titles) of all columns.
<T extends java.io.Serializable> ColumnView<T>	getColumnView(ColumnDefinition<T> columnDefinition) Returns a view on the column which equals (only name and value type) a given, already known, column definition.
ColumnView<?>	getColumnView(int column) Returns a view on the column with the given index.
<T extends java.io.Serializable> ColumnView<? extends T>	getColumnView(int column, java.lang.Class<T> valueType) Returns a view on the column with the given index, having the given value type.
ColumnView<?>	getColumnView(java.lang.String columnName) Returns a view on the column with the given name.
<T extends java.io.Serializable> ColumnView<? extends T>	getColumnView(java.lang.String columnName, java.lang.Class<T> valueType) Returns a view on the column with the given name, having the given value type.
long	getCreationTime() Returns the time in milliseconds after January 1, 1970 00:00:00 GMT, when the content of this table was created.
<T extends java.io.Serializable> TableEntry<T>	getEntry(int row, ColumnDefinition<T> columnDefinition) Returns the entry at the given row corresponding to the given columnDefinition.
TableEntry<?>	getEntry(int row, int column) Returns the entry at the given row and column.
<T extends java.io.Serializable> TableEntry<? extends T>	getEntry(int row, int column, java.lang.Class<T> valueType) Returns the entry at the given row and column, having the given value type.
TableEntry<?>	getEntry(int row, java.lang.String columnName) Returns the entry at the given row and column.
<T extends java.io.Serializable> TableEntry<? extends T>	getEntry(int row, java.lang.String columnName, java.lang.Class<T> valueType) Returns the entry at the given row and column, having the given value type.
ExecutionInformation	getExecutionInformation() Returns logical information of when during the measurement execution the table was created.
int	getNumColumns() Returns the number of columns in this table.
int	getNumRows() Returns the number of rows in this table.
PositionInformation	getPositionInformation() Returns the logical position information in the measurement where this table was created.
RowView	getRowView(int row) Returns a row view for the given row index.
TableDefinition	getTableDefinition() Returns the definition (number, type and names of columns) of this table.
<T extends java.io.Serializable> T	getValue(int row, ColumnDefinition<T> columnDefinition) Returns the value of the entry at the given row corresponding to the given columnDefinition.
java.io.Serializable	getValue(int row, int column) Returns the table entry's value at the given row and column.
<T extends java.io.Serializable> T	getValue(int row, int column, java.lang.Class<T> valueType) Returns the entry's value at the given row and column, having the given value type.
java.io.Serializable	getValue(int row, java.lang.String columnName) Returns the entry's value at the given row and column.
<T extends java.io.Serializable> T	getValue(int row, java.lang.String columnName, java.lang.Class<T> valueType) Returns the entry's value at the given row and column, having the given value type.
int	hashCode()
void	insertRow(int row, java.io.Serializable... values) Inserts a row to the table at the given row.
void	insertRow(int row, TemporaryRow temporaryRow) Inserts a temporary row at the given row index to this table.
java.util.Iterator<RowView>	iterator()
void	removeRow(int row) Removes the row at the given index.
void	setCreationTime(long creationTime) Sets the time in milliseconds after January 1, 1970 00:00:00 GMT, when the content of this table was created.
void	setExecutionInformation(ExecutionInformation executionInformation) Sets logical information of when during the measurement execution the table was created.
void	setPositionInformation(PositionInformation positionInformation) Sets the logical position information in the measurement where this table was created.
Table	toTable(TableDefinition tableDefinition) Creates a table containing conforming to the provided table definition.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Table

protected Table(Table other)

Protected Copy constructor. Use clone() from outside, and copy constructor from sub-classes.

Parameters:

other - object to copy.

Table

public Table(TableDefinition tableDefinition,
             long creationTime,
             PositionInformation positionInformation,
             ExecutionInformation executionInformation)
      throws java.lang.NullPointerException

Constructor using an already available TableDefinition.

Parameters:

tableDefinition - The table definition, defining the number, names and types of the columns.

executionInformation - The execution of the measurement where this table was created.

positionInformation - The logical position in the measurement where this table was created.

creationTime - The time (in milliseconds since January 1, 1970, 00:00:00 GMT) when the content of this table was created (see Date.getTime()).

Throws:

java.lang.NullPointerException - Thrown if the table definition is null.

Table

public Table(TableDefinition tableDefinition)
      throws java.lang.NullPointerException

Constructor using an already available TableDefinition. The creation time of the table is set to the current time, the position and execution information to null.

Parameters:

tableDefinition - The table definition, defining the number, names and types of the columns.

Throws:

java.lang.NullPointerException - Thrown if the table definition is null.

Table

public Table(TableDefinition tableDefinition,
             long creationTime)
      throws java.lang.NullPointerException

Constructor using an already available TableDefinition. The position and execution information is set to null.

Parameters:

tableDefinition - The table definition, defining the number, names and types of the columns.

creationTime - The time (in milliseconds since January 1, 1970, 00:00:00 GMT) when the content of this table was created (see Date.getTime()).

Throws:

java.lang.NullPointerException - Thrown if the table definition is null.

Table

public Table(TableDefinition tableDefinition,
             PositionInformation positionInformation,
             ExecutionInformation executionInformation)
      throws java.lang.NullPointerException

Constructor using an already available TableDefinition. The creation time of the table is set to the current time.

Parameters:

tableDefinition - The table definition, defining the number, names and types of the columns.

executionInformation - The execution of the measurement where this table was created.

positionInformation - The logical position in the measurement where this table was created.

Throws:

java.lang.NullPointerException - Thrown if the table definition is null.

Table

public Table(java.lang.String tableName,
             java.lang.String tableDescription,
             ColumnDefinition<?>... columnDefinitions)
      throws TableException,
             java.lang.NullPointerException

Constructor using information on the column names and types. Currently, YouScope only supports a limited set of value types for tables. Thus, this function throws a TableException if given value type is currently not supported by YouScope. See TableHelper for supported column types. The creation time of the table is set to the current time, the position and execution information to null.

Parameters:

tableName - The name (title) of the table. Should be a single short line.

tableDescription - Description of the meaning and intended usage of the table. Might contain multiple lines (separated by line breaks).

columnDefinitions - The columns of the table.

Throws:

TableException - Thrown if given column definitions are currently not supported by YouScope.

java.lang.NullPointerException - Thrown if one of the columns is null, or the title is null.

Table

public Table(java.lang.String tableName,
             java.lang.String tableDescription,
             long creationTime,
             PositionInformation positionInformation,
             ExecutionInformation executionInformation,
             ColumnDefinition<?>... columnDefinitions)
      throws TableException,
             java.lang.NullPointerException

Constructor using information on the column names and types. Currently, YouScope only supports a limited set of value types for tables. Thus, this function throws a TableException if given value type is currently not supported by YouScope. See TableHelper for supported column types.

Parameters:

tableName - The name (title) of the table. Should be a single short line.

tableDescription - Description of the meaning and intended usage of the table. Might contain multiple lines (separated by line breaks).

creationTime - The time (in milliseconds since January 1, 1970, 00:00:00 GMT) when the content of this table was created (see Date.getTime()).

executionInformation - The execution of the measurement where this table was created.

positionInformation - The logical position in the measurement where this table was created.

columnDefinitions - The columns of the table.

Throws:

TableException - Thrown if given column definitions are currently not supported by YouScope.

java.lang.NullPointerException - Thrown if one of the columns is null, or the title is null.

Table

public Table(java.lang.String tableName,
             java.lang.String tableDescription,
             long creationTime,
             ColumnDefinition<?>... columnDefinitions)
      throws TableException,
             java.lang.NullPointerException

Constructor using information on the column names and types. Currently, YouScope only supports a limited set of value types for tables. Thus, this function throws a TableException if given value type is currently not supported by YouScope. See TableHelper for supported column types. The position and execution information is set to null.

Parameters:

tableName - The name (title) of the table. Should be a single short line.

tableDescription - Description of the meaning and intended usage of the table. Might contain multiple lines (separated by line breaks).

creationTime - The time (in milliseconds since January 1, 1970, 00:00:00 GMT) when the content of this table was created (see Date.getTime()).

columnDefinitions - The columns of the table.

Throws:

TableException - Thrown if given column definitions are currently not supported by YouScope.

java.lang.NullPointerException - Thrown if one of the columns is null, or the title is null.

Table

public Table(java.lang.String tableName,
             java.lang.String tableDescription,
             PositionInformation positionInformation,
             ExecutionInformation executionInformation,
             ColumnDefinition<?>... columnDefinitions)
      throws TableException,
             java.lang.NullPointerException

Constructor using information on the column names and types. Currently, YouScope only supports a limited set of value types for tables. Thus, this function throws a TableException if given value type is currently not supported by YouScope. See TableHelper for supported column types. The creation time of the table is set to the current time.

Parameters:

tableName - The name (title) of the table. Should be a single short line.

tableDescription - Description of the meaning and intended usage of the table. Might contain multiple lines (separated by line breaks).

executionInformation - The execution of the measurement where this table was created.

positionInformation - The logical position in the measurement where this table was created.

columnDefinitions - The columns of the table.

Throws:

TableException - Thrown if given column definitions are currently not supported by YouScope.

java.lang.NullPointerException - Thrown if one of the columns is null, or the title is null.

Method Detail

toTable

public Table toTable(TableDefinition tableDefinition)
              throws TableException,
                     java.lang.NullPointerException

Creates a table containing conforming to the provided table definition. For every column (identified by column name) contained in both tables, the new table contains the entries of the current table. If a column with a given name does only exist in the new table, its entries are set to null if this is allowed, or a TableExcecption is thrown. Columns only existing in current table but not in new table are ignored. If columns exist in both tables, but their value types are different, a TableException is thrown. If a column in the new table does not allow for null values, but the corresponding column in the old table does contain null entries, a TableException is thrown.

Parameters:

tableDefinition - The table definition of the new table.

Returns:

The newly created table conforming to the given table definition.

Throws:

TableException - Thrown if the new table could not be constructed due to the reasons stated in the text.

java.lang.NullPointerException - Thrown if tableDefinition is null.

addRow

public void addRow(java.io.Serializable... values)
            throws TableException

Adds a row to the table. The number of values must be equal to the number of columns in this table. Each value either has to be null, or of the value type or a sub-class of the value type of the respective column.

Parameters:

values - The values of the row.

Throws:

TableException - Thrown if number or types of values is wrong, or if a value corresponding to a column not allowing null entries is null.

createTemporaryRow

public TemporaryRow createTemporaryRow()
                                throws TableException

Creates a temporary row. The entries of a temporary row do not (yet) belong to the table. Different to table rows, all entries of a temporary row can be null. Thus, a temporary row can be used to set the row values one by one. Afterwards, a temporary row can be added to the table using addRow(TemporaryRow) or insertRow(int, TemporaryRow).

Returns:

a temporary row.

Throws:

TableException - Thrown if temporary row could not be constructed.

addRow

public void addRow(TemporaryRow temporaryRow)
            throws TableException,
                   java.lang.NullPointerException

Adds a temporary row to this table. The row is checked if it contains the right amount of entries with the right value types. Furthermore, for all columns which must not contain null values, it is checked if the corresponding entry in the temporary row is non-null.

Parameters:

temporaryRow - The temporary row containing the values to add.

Throws:

TableException - thrown if any of the conditions is violated.

java.lang.NullPointerException - Thrown if temporaryRow is null.

addRows

public void addRows(Table table)
             throws TableException,
                    java.lang.NullPointerException

Adds all rows of the table at the end of the rows of this table. Table definitions have to match.

Parameters:

table - Table whose rows should be copied.

Throws:

TableException - Thrown if table definitions do not match.

java.lang.NullPointerException - Thrown if table is null.

insertRow

public void insertRow(int row,
                      TemporaryRow temporaryRow)
               throws TableException,
                      java.lang.NullPointerException,
                      java.lang.IndexOutOfBoundsException

Inserts a temporary row at the given row index to this table. The index of the row currently having the given index, and of all subsequent rows, are increased by one. The row is checked if it contains the right amount of entries with the right value types. Furthermore, for all columns which must not contain null values, it is checked if the corresponding entry in the temporary row is non-null.

Parameters:

row - The index where to add this row. Must be bigger or equal to 0, and smaller than getNumRows().

temporaryRow - The temporary row containing the values to insert.

Throws:

TableException - thrown if any of the conditions is violated.

java.lang.NullPointerException - Thrown if temporaryRow is null.

java.lang.IndexOutOfBoundsException - thrown if row index is invalid.

insertRow

public void insertRow(int row,
                      java.io.Serializable... values)
               throws TableException,
                      java.lang.IndexOutOfBoundsException

Inserts a row to the table at the given row. The index of the row currently having the given index, and of all subsequent rows, are increased by one. The number of values must be equal to the number of columns in this table. Each value either has to be null, or of the value type or a sub-class of the value type of the respective column.

Parameters:

row - The index where to add this row. Must be bigger or equal to 0, and smaller than getNumRows().

values - The values of the row.

Throws:

TableException - Thrown if number or types of values is wrong, or if a value corresponding to a column not allowing null entries is null.

java.lang.IndexOutOfBoundsException - thrown if row index is invalid.

removeRow

public void removeRow(int row)
               throws java.lang.IndexOutOfBoundsException

Removes the row at the given index.

Parameters:

row - The index of the row to remove. Must be bigger or equal to 0, and smaller than getNumRows().

Throws:

java.lang.IndexOutOfBoundsException

getTableDefinition

public TableDefinition getTableDefinition()

Returns the definition (number, type and names of columns) of this table.

Returns:

Table definition.

getNumColumns

public int getNumColumns()

Returns the number of columns in this table. This number can not change.

Returns:

Number of columns.

getNumRows

public int getNumRows()

Returns the number of rows in this table. This number might change when adding or removing rows.

Returns:

Number of rows.

getRowView

public RowView getRowView(int row)
                   throws java.lang.IndexOutOfBoundsException

Returns a row view for the given row index.

Parameters:

row - row index.

Returns:

Row at given index.

Throws:

java.lang.IndexOutOfBoundsException - Thrown if row index is invalid.

getEntry

public TableEntry<?> getEntry(int row,
                              int column)
                       throws java.lang.IndexOutOfBoundsException

Returns the entry at the given row and column.

Parameters:

row - Row of the entry.

column - Column of the entry.

Returns:

Table entry at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row or column index is invalid.

getValue

public java.io.Serializable getValue(int row,
                                     int column)
                              throws java.lang.IndexOutOfBoundsException

Returns the table entry's value at the given row and column.

Parameters:

row - Row of the entry.

column - Column of the entry.

Returns:

Table entry's value at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row or column index is invalid.

getEntry

public TableEntry<?> getEntry(int row,
                              java.lang.String columnName)
                       throws TableException,
                              java.lang.NullPointerException,
                              java.lang.IndexOutOfBoundsException

Returns the entry at the given row and column.

Parameters:

row - Row of the entry.

columnName - Name of the column.

Returns:

Table entry at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row index is invalid.

TableException - Thrown if table does not contain column with given name.

java.lang.NullPointerException - Thrown if columnName is null.

getValue

public java.io.Serializable getValue(int row,
                                     java.lang.String columnName)
                              throws TableException,
                                     java.lang.NullPointerException,
                                     java.lang.IndexOutOfBoundsException

Returns the entry's value at the given row and column.

Parameters:

row - Row of the entry.

columnName - Name of the column.

Returns:

Table entry's value at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row index is invalid.

TableException - Thrown if table does not contain column with given name.

java.lang.NullPointerException - Thrown if columnName is null.

getEntry

public <T extends java.io.Serializable> TableEntry<? extends T> getEntry(int row,
                                                                         java.lang.String columnName,
                                                                         java.lang.Class<T> valueType)
                                                                  throws TableException,
                                                                         java.lang.NullPointerException,
                                                                         java.lang.IndexOutOfBoundsException

Returns the entry at the given row and column, having the given value type.

Parameters:

row - Row of the entry.

columnName - Name of the column.

valueType - value type of entry. Must be a super-class of the actual value type.

Returns:

Table entry at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row index is invalid.

TableException - Thrown if table does not contain column with given name.

java.lang.NullPointerException - Thrown if columnName or valueType is null.

getEntry

public <T extends java.io.Serializable> TableEntry<T> getEntry(int row,
                                                               ColumnDefinition<T> columnDefinition)
                                                        throws TableException,
                                                               java.lang.NullPointerException,
                                                               java.lang.IndexOutOfBoundsException

Returns the entry at the given row corresponding to the given columnDefinition.

Parameters:

row - Row of the entry.

columnDefinition - Definition of the column whose entry at the given row should be returned.

Returns:

Table entry at given row and column.

Throws:

TableException - Thrown if table does not contain column corresponding to the given definition, or if column has different value types.

java.lang.NullPointerException - Thrown if columnDefinition is null.

java.lang.IndexOutOfBoundsException - Thrown if row is invalid.

getValue

public <T extends java.io.Serializable> T getValue(int row,
                                                   ColumnDefinition<T> columnDefinition)
                                            throws TableException,
                                                   java.lang.NullPointerException,
                                                   java.lang.IndexOutOfBoundsException

Returns the value of the entry at the given row corresponding to the given columnDefinition.

Parameters:

row - Row of the entry.

columnDefinition - Definition of the column whose entry's value at the given row should be returned.

Returns:

Table entry's value at given row and column.

Throws:

TableException - Thrown if table does not contain column corresponding to the given definition, or if column has different value types.

java.lang.NullPointerException - Thrown if columnDefinition is null.

java.lang.IndexOutOfBoundsException - thrown if row is invalid.

getValue

public <T extends java.io.Serializable> T getValue(int row,
                                                   java.lang.String columnName,
                                                   java.lang.Class<T> valueType)
                                            throws TableException,
                                                   java.lang.NullPointerException,
                                                   java.lang.IndexOutOfBoundsException

Returns the entry's value at the given row and column, having the given value type.

Parameters:

row - Row of the entry.

columnName - Name of the column.

valueType - value type of entry. Must be a super-class of the actual value type.

Returns:

Table entry's value at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row index is invalid.

TableException - Thrown if table does not contain column with given name.

java.lang.NullPointerException - Thrown if columnName or valueType is null.

getEntry

public <T extends java.io.Serializable> TableEntry<? extends T> getEntry(int row,
                                                                         int column,
                                                                         java.lang.Class<T> valueType)
                                                                  throws java.lang.IndexOutOfBoundsException,
                                                                         TableException,
                                                                         java.lang.NullPointerException

Returns the entry at the given row and column, having the given value type.

Parameters:

row - Row of the entry.

column - Column of the entry.

valueType - value type of entry. Must be a super-class of the actual value type.

Returns:

Table entry at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row or column index is invalid.

TableException - Thrown if the entry's value type is incompatible with given valueType.

java.lang.NullPointerException - Thrown if valueType is null.

getValue

public <T extends java.io.Serializable> T getValue(int row,
                                                   int column,
                                                   java.lang.Class<T> valueType)
                                            throws java.lang.IndexOutOfBoundsException,
                                                   TableException,
                                                   java.lang.NullPointerException

Returns the entry's value at the given row and column, having the given value type.

Parameters:

row - Row of the entry.

column - Column of the entry.

valueType - value type of entry. Must be a super-class of the actual value type.

Returns:

Table entry's value at given row and column.

Throws:

java.lang.IndexOutOfBoundsException - thrown, if row or column index is invalid.

TableException - Thrown if the entry's value type is incompatible with given valueType.

java.lang.NullPointerException - Thrown if valueType is null.

getColumnView

public ColumnView<?> getColumnView(int column)
                            throws java.lang.IndexOutOfBoundsException

Returns a view on the column with the given index.

Parameters:

column - index of column.

Returns:

The column at the index.

Throws:

java.lang.IndexOutOfBoundsException - Thrown if index is invalid.

getColumnName

public java.lang.String getColumnName(int column)
                               throws java.lang.IndexOutOfBoundsException

Returns the name (title) of the column with the given index.

Parameters:

column - index of column.

Returns:

Name of column.

Throws:

java.lang.IndexOutOfBoundsException - Thrown if index is invalid.

getColumnNames

public java.lang.String[] getColumnNames()

Returns the names (titles) of all columns.

Returns:

Names of all columns in same order as columns are in table.

getColumnView

public ColumnView<?> getColumnView(java.lang.String columnName)
                            throws java.lang.NullPointerException,
                                   TableException

Returns a view on the column with the given name.

Parameters:

columnName - Name of the column (case sensitive).

Returns:

The column with the given name.

Throws:

java.lang.NullPointerException - Thrown if columnName is null.

TableException - Thrown if table does not contain column with given name.

getColumnView

public <T extends java.io.Serializable> ColumnView<? extends T> getColumnView(int column,
                                                                              java.lang.Class<T> valueType)
                                                                       throws java.lang.IndexOutOfBoundsException,
                                                                              TableException,
                                                                              java.lang.NullPointerException

Returns a view on the column with the given index, having the given value type.

Parameters:

column - index of column.

valueType - value type of column. Must be a super-class of the actual value type.

Returns:

The column at the index.

Throws:

java.lang.IndexOutOfBoundsException - Thrown if index is invalid.

TableException - Thrown if column at given index does not contain entries with value type valueType.

java.lang.NullPointerException - Thrown if valueType is null.

getColumnView

public <T extends java.io.Serializable> ColumnView<? extends T> getColumnView(java.lang.String columnName,
                                                                              java.lang.Class<T> valueType)
                                                                       throws TableException,
                                                                              java.lang.NullPointerException

Returns a view on the column with the given name, having the given value type.

Parameters:

columnName - Name of the column (case sensitive).

valueType - value type of column.

Returns:

The column with the given name.

Throws:

TableException - Thrown if table does not contain a column with given name, or if column with the given name does not contain entries with value type valueType.

java.lang.NullPointerException - Thrown if columnName or valueType is null.

getColumnView

public <T extends java.io.Serializable> ColumnView<T> getColumnView(ColumnDefinition<T> columnDefinition)
                                                             throws TableException,
                                                                    java.lang.NullPointerException

Returns a view on the column which equals (only name and value type) a given, already known, column definition.

Parameters:

columnDefinition - The definition of the column.

Returns:

The column corresponding to the given column definition.

Throws:

TableException - Thrown if table does not contain corresponding column, or if corresponding column has different valueType.

java.lang.NullPointerException - Thrown if columnDefinition is null.

clone

public Table clone()

Overrides:

clone in class java.lang.Object

getPositionInformation

public PositionInformation getPositionInformation()

Returns the logical position information in the measurement where this table was created. Returns null if unknown, or if not created as part of a measurement.

Returns:

position information where this table was created.

setPositionInformation

public void setPositionInformation(PositionInformation positionInformation)

Sets the logical position information in the measurement where this table was created. Set to null if unknown, or if not created as part of a measurement.

Parameters:

positionInformation - position information where this table was created.

getExecutionInformation

public ExecutionInformation getExecutionInformation()

Returns logical information of when during the measurement execution the table was created. Returns null if unknown, or if not created as part of a measurement.

Returns:

logical execution information when the table was created.

setExecutionInformation

public void setExecutionInformation(ExecutionInformation executionInformation)

Sets logical information of when during the measurement execution the table was created. Set to null if unknown, or if not created as part of a measurement.

Parameters:

executionInformation - logical execution information when the table was created.

getCreationTime

public long getCreationTime()

Returns the time in milliseconds after January 1, 1970 00:00:00 GMT, when the content of this table was created. See Date.Date(long).

Returns:

Time in ms when content was created.

setCreationTime

public void setCreationTime(long creationTime)

Sets the time in milliseconds after January 1, 1970 00:00:00 GMT, when the content of this table was created. See Date.getTime().

Parameters:

creationTime - Time in ms when content was created.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

iterator

public java.util.Iterator<RowView> iterator()

Specified by:

iterator in interface java.lang.Iterable<RowView>