Package nl.cwi.monetdb.embedded.tables

Class MonetDBTable

java.lang.Object

nl.cwi.monetdb.embedded.env.AbstractConnectionResult

nl.cwi.monetdb.embedded.tables.MonetDBTable

All Implemented Interfaces:

Closeable, AutoCloseable

public final class MonetDBTable
extends AbstractConnectionResult

Java representation of a MonetDB table. It's possible to perform several CRUD operations using the respective provided interfaces.

Author:

Pedro Ferreira

Method Summary

Modifier and Type	Method	Description
int	appendColumns(Object[] input)	Appends new rows to the table column-wise.
protected void	closeResultImplementation()	Close the result set internally.
MonetDBTableColumn[]	getAllColumnsMetadata()	Gets all columns metadata.
void	getColumnDefaultValues(String[] input)	Gets the columns default values in an array.
protected void	getColumnDefaultValuesInternal(String[] input)
void	getColumnDigits(int[] input)	Gets the column digits as an integer array.
protected void	getColumnDigitsInternal(int[] input)
MonetDBTableColumn	getColumnMetadataByIndex(int index)	Gets a column metadata by index.
MonetDBTableColumn	getColumnMetadataByName(String name)	Gets a column metadata by name.
void	getColumnNames(String[] input)	Gets the columns names as a string array.
protected void	getColumnNamesInternal(String[] input)
void	getColumnNullableIndexes(boolean[] input)	Gets the columns nullable indexes as an array.
protected void	getColumnNullableIndexesInternal(boolean[] input)
void	getColumnScales(int[] input)	Gets the column scales as an integer array.
protected void	getColumnScalesInternal(int[] input)
void	getColumnTypes(String[] input)	Gets the columns types as a string array.
protected void	getColumnTypesInternal(String[] input)
void	getMappings(MonetDBToJavaMapping[] input)	Gets the Java mappings as a MonetDBToJavaMapping array.
protected void	getMappingsInternal(MonetDBToJavaMapping[] input)
int	getNumberOfColumns()	Returns the number of columns in the result set.
int	getNumberOfRows()	Gets the current number of rows in the table, or -1 if an error in the database has occurred.
int	getRoundingMode()	Gets the current rounding mode for decimals in this table.
String	getTableName()	Gets the table name.
String	getTableSchema()	Gets the table schema name.
int	iterateTable(IMonetDBTableCursor cursor)	Iterate over the table using a IMonetDBTableCursor instance.
void	setRoundingMode(int roundingMode)	Sets the current rounding mode for decimals in this table, from the rounding modes in the BigDecimal class.

Methods inherited from class nl.cwi.monetdb.embedded.env.AbstractConnectionResult

checkMetadataArrayLength, close, getConnection, getRandomIdentifier

Methods inherited from class java.lang.Object

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

Method Details

getNumberOfColumns

public int getNumberOfColumns() throws MonetDBEmbeddedException

Description copied from class: AbstractConnectionResult

Returns the number of columns in the result set.

Specified by:

getNumberOfColumns in class AbstractConnectionResult

Returns:

Number of columns

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getNumberOfRows

public int getNumberOfRows()

Gets the current number of rows in the table, or -1 if an error in the database has occurred.

Specified by:

getNumberOfRows in class AbstractConnectionResult

Returns:

The number of rows in the table.

getColumnNamesInternal

protected void getColumnNamesInternal(String[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getColumnTypesInternal

protected void getColumnTypesInternal(String[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getMappingsInternal

protected void getMappingsInternal(MonetDBToJavaMapping[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getColumnDigitsInternal

protected void getColumnDigitsInternal(int[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getColumnScalesInternal

protected void getColumnScalesInternal(int[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getColumnNullableIndexesInternal

protected void getColumnNullableIndexesInternal(boolean[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getColumnDefaultValuesInternal

protected void getColumnDefaultValuesInternal(String[] input) throws MonetDBEmbeddedException

Throws:

MonetDBEmbeddedException

getTableSchema

public String getTableSchema()

Gets the table schema name.

Returns:

The table schema name

getTableName

public String getTableName()

Gets the table name.

Returns:

The table name

getRoundingMode

public int getRoundingMode()

Gets the current rounding mode for decimals in this table.

Returns:

The current rounding mode for decimals in this table.

setRoundingMode

public void setRoundingMode(int roundingMode)

Sets the current rounding mode for decimals in this table, from the rounding modes in the BigDecimal class. It has to be value between BigDecimal.ROUND_HALF_UP and BigDecimal.ROUND_HALF_EVEN.

Parameters:

roundingMode - The roundingMode mode value to set, between BigDecimal.ROUND_HALF_UP and BigDecimal.ROUND_HALF_EVEN

getColumnNames

public void getColumnNames(String[] input) throws MonetDBEmbeddedException

Description copied from class: AbstractConnectionResult

Gets the columns names as a string array.

Specified by:

getColumnNames in class AbstractConnectionResult

Parameters:

input - The columns names array to fill.

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getColumnTypes

public void getColumnTypes(String[] input) throws MonetDBEmbeddedException

Description copied from class: AbstractConnectionResult

Gets the columns types as a string array.

Specified by:

getColumnTypes in class AbstractConnectionResult

Parameters:

input - The columns types array to fill.

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getMappings

public void getMappings(MonetDBToJavaMapping[] input) throws MonetDBEmbeddedException

Description copied from class: AbstractConnectionResult

Gets the Java mappings as a MonetDBToJavaMapping array.

Specified by:

getMappings in class AbstractConnectionResult

Parameters:

input - The columns mappings array to fill.

Throws:

MonetDBEmbeddedException - If an error in the database occurred..

getColumnDigits

public void getColumnDigits(int[] input) throws MonetDBEmbeddedException

Description copied from class: AbstractConnectionResult

Gets the column digits as an integer array.

Specified by:

getColumnDigits in class AbstractConnectionResult

Parameters:

input - The columns digits array to fill.

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getColumnScales

public void getColumnScales(int[] input) throws MonetDBEmbeddedException

Description copied from class: AbstractConnectionResult

Gets the column scales as an integer array.

Specified by:

getColumnScales in class AbstractConnectionResult

Parameters:

input - The columns scales array to fill.

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getColumnNullableIndexes

public void getColumnNullableIndexes(boolean[] input) throws MonetDBEmbeddedException

Gets the columns nullable indexes as an array.

Parameters:

input - The columns nullable indexes array to fill

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getColumnDefaultValues

public void getColumnDefaultValues(String[] input) throws MonetDBEmbeddedException

Gets the columns default values in an array.

Parameters:

input - The columns default values array to fill

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getColumnMetadataByIndex

public MonetDBTableColumn getColumnMetadataByIndex(int index) throws MonetDBEmbeddedException

Gets a column metadata by index.

Parameters:

index - The column index (starting from 1)

Returns:

The column metadata, null if index not in bounds

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getColumnMetadataByName

public MonetDBTableColumn getColumnMetadataByName(String name) throws MonetDBEmbeddedException

Gets a column metadata by name.

Parameters:

name - The column name

Returns:

The column metadata, null if not found

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

getAllColumnsMetadata

public MonetDBTableColumn[] getAllColumnsMetadata() throws MonetDBEmbeddedException

Gets all columns metadata.

Returns:

An array instance of columns metadata

Throws:

MonetDBEmbeddedException - If an error in the database occurred.

iterateTable

public int iterateTable(IMonetDBTableCursor cursor) throws MonetDBEmbeddedException

Iterate over the table using a IMonetDBTableCursor instance.

Parameters:

cursor - The iterator with the business logic

Returns:

The number of rows iterated

Throws:

MonetDBEmbeddedException - If an error in the database occurred

appendColumns

public int appendColumns(Object[] input) throws MonetDBEmbeddedException

Appends new rows to the table column-wise.

Parameters:

input - An array of columns to append

Returns:

The number of rows appended

Throws:

MonetDBEmbeddedException - If an error in the database occurred

closeResultImplementation

protected void closeResultImplementation()

Description copied from class: AbstractConnectionResult

Close the result set internally.

Specified by:

closeResultImplementation in class AbstractConnectionResult