org.axiondb.engine.tables
Class TableView

java.lang.Object
  org.axiondb.event.BaseTableModificationPublisher
      org.axiondb.engine.tables.TableView

All Implemented Interfaces:

RowSource, Table

public class TableView
extends BaseTableModificationPublisher
implements Table

A sub-query view Table.

Version:

$Revision: 1.31 $ $Date: 2006/01/10 21:02:36 $

Field Summary

static java.lang.String	SUBQUERY
static java.lang.String	VIEW

Fields inherited from interface org.axiondb.Table

REGULAR_TABLE_TYPE, SYSTEM_TABLE_TYPE

Constructor Summary

TableView(Database db, java.lang.String name)

TableView(Database db, java.lang.String name, java.lang.String type, SubSelectCommand subSelectCmd)

TableView(Database db, java.lang.String name, SubSelectCommand subSelectCmd)

Method Summary

void	addColumn(Column col) Add the given Columnto this table.
void	addConstraint(Constraint constraint)
void	addIndex(Index index) Add an index, associating it with a Column, and adding it as a org.axiondb.TableModificationListenerto the table.
void	addRow(Row row) Insert the given Row.
void	applyDeletes(org.apache.commons.collections.primitives.IntCollection rowids) Remove the specified rows from this table and any associated indices.
void	applyInserts(RowCollection rows) Insert the given rows into this table and any associated indices.
void	applyUpdates(RowCollection rows) Update the given rows in this table and any associated indices.
RowDecorator	buildRowDecorator()
void	checkpoint()
protected boolean	deleteFile(java.io.File file)
void	deleteRow(Row oldrow) Delete the given Row.
void	drop() Drop this table from the database.
void	freeRowId(int id) Un-reserve a row id.
Column	getColumn(int index) Return the Columncorresponding to the given zero-based index .
Column	getColumn(java.lang.String name) Return the Columnfor the given name .
int	getColumnCount() Return the number of Columns I contain.
java.util.List	getColumnIdentifierList(TableIdentifier table)
java.util.List	getColumnIdentifiers() Return an readonly Listover the ColumnIdentifiersfor my Columns.
int	getColumnIndex(java.lang.String name) Return the zero-based index of the Columnwith the given name .
Constraint	getConstraint(java.lang.String name)
java.util.Iterator	getConstraints()
RowIterator	getIndexedRows(RowSource source, Selectable node, boolean readOnly)
RowIterator	getIndexedRows(Selectable node, boolean readOnly)
Index	getIndexForColumn(Column column) Return the first Indexthat pertains to the given Column, or null if no such Indexexists.
java.util.Iterator	getIndices() Obtain an Iteratorover my indices.
RowIterator	getMatchingRows(java.util.List selectables, java.util.List values, boolean readOnly) Obtain an iteratorover my Rows where each Selectablein the selectable list evaluatesto the corresponding value in the value list.
java.lang.String	getName() Get the name of this table.
int	getNextRowId() Reserve a row id.
Row	getRow(int id)
int	getRowCount() Return the number of Rows I contain.
protected RowIterator	getRowIterator()
RowIterator	getRowIterator(boolean readOnly) Obtain an iteratorover my Rows.
Sequence	getSequence()
java.util.Iterator	getTables()
java.lang.String	getType() Get the type of this table.
boolean	hasColumn(ColumnIdentifier id) Indicate whether the ColumnIdentifierreferences a column in this table
boolean	hasIndex(java.lang.String name)
boolean	isColumnIndexed(Column column) Check to see if an Indexexists for the given Column
boolean	isPrimaryKeyConstraintExists(java.lang.String columnName) check if primary constraint exists on a column
boolean	isUniqueConstraintExists(java.lang.String columnName) check if unique constraint exists on a column
RowDecorator	makeRowDecorator()
TransactableTable	makeTransactableTable() Create a TransactableTablefor this table.
void	migrate() Migrate from older version to newer version for this table
void	populateIndex(Index index) Populate an Index, adding my current rows to it.
void	remount(java.io.File dir, boolean datafilesonly) Notify this table that its disk-location has moved.
Constraint	removeConstraint(java.lang.String name)
void	removeIndex(Index index) Remove an index, both from the indices and as a TableModificationListener
void	rename(java.lang.String oldName, java.lang.String newName)
void	setSequence(Sequence seq)
void	setSubQuery(java.lang.String query)
void	setType(java.lang.String type)
void	shutdown() The database is shutting down, shutdown this table also.
java.lang.String	toString()
void	truncate() Unconditionally delete all rows in this table.
void	updateRow(Row oldrow, Row newrow) Update the given Row.

Methods inherited from class org.axiondb.event.BaseTableModificationPublisher

addTableModificationListener, getTableModificationListeners, publishEvent, removeTableModificationListener, setDeferAllConstraints

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.axiondb.Table

addTableModificationListener, getTableModificationListeners, removeTableModificationListener, setDeferAllConstraints

Field Detail

VIEW

public static java.lang.String VIEW

SUBQUERY

public static java.lang.String SUBQUERY

Constructor Detail

TableView

public TableView(Database db,
                 java.lang.String name,
                 java.lang.String type,
                 SubSelectCommand subSelectCmd)
          throws AxionException

Throws:

AxionException

TableView

public TableView(Database db,
                 java.lang.String name,
                 SubSelectCommand subSelectCmd)
          throws AxionException

Throws:

AxionException

TableView

public TableView(Database db,
                 java.lang.String name)
          throws AxionException

Throws:

AxionException

Method Detail

setSubQuery

public void setSubQuery(java.lang.String query)
                 throws AxionException

Throws:

AxionException

populateIndex

public void populateIndex(Index index)
                   throws AxionException

Description copied from interface: Table

Populate an Index, adding my current rows to it. Does not addthe index.

Specified by:

populateIndex in interface Table

Throws:

AxionException

See Also:

Table.addIndex(org.axiondb.Index)

getNextRowId

public int getNextRowId()

Description copied from interface: Table

Reserve a row id.

Specified by:

getNextRowId in interface Table

freeRowId

public void freeRowId(int id)

Description copied from interface: Table

Un-reserve a row id.

Specified by:

freeRowId in interface Table

getRowCount

public int getRowCount()

Description copied from interface: Table

Return the number of Rows I contain.

Specified by:

getRowCount in interface Table

getRow

public Row getRow(int id)

Specified by:

getRow in interface RowSource

applyInserts

public void applyInserts(RowCollection rows)
                  throws AxionException

Description copied from interface: Table

Insert the given rows into this table and any associated indices. This process is allowed to be destructive, the table my delete rows from the given list.

Specified by:

applyInserts in interface Table

Parameters:

rows - a collection of Rows

Throws:

AxionException

applyDeletes

public void applyDeletes(org.apache.commons.collections.primitives.IntCollection rowids)
                  throws AxionException

Description copied from interface: Table

Remove the specified rows from this table and any associated indices. This process is allowed to be destructive, the table my delete values from the given list.

Specified by:

applyDeletes in interface Table

Throws:

AxionException

applyUpdates

public void applyUpdates(RowCollection rows)
                  throws AxionException

Description copied from interface: Table

Update the given rows in this table and any associated indices. This process is allowed to be destructive, the table my delete rows from the given list.

Specified by:

applyUpdates in interface Table

Throws:

AxionException

getRowIterator

protected RowIterator getRowIterator()
                              throws AxionException

Throws:

AxionException

getRowIterator

public RowIterator getRowIterator(boolean readOnly)
                           throws AxionException

Description copied from interface: Table

Obtain an iteratorover my Rows.

Specified by:

getRowIterator in interface Table

Parameters:

readOnly - when true, the caller does not expect to be able to modify (i.e., call RowIterator.set(org.axiondb.Row)or RowIterator.remove()on) the returned RowIterator, the returned iterator may be unmodifiable.

Throws:

AxionException

addRow

public void addRow(Row row)
            throws AxionException

Description copied from interface: Table

Insert the given Row.

Specified by:

addRow in interface Table

Throws:

AxionException

updateRow

public void updateRow(Row oldrow,
                      Row newrow)
               throws AxionException

Description copied from interface: Table

Update the given Row.

Specified by:

updateRow in interface Table

Throws:

AxionException

deleteRow

public void deleteRow(Row oldrow)
               throws AxionException

Description copied from interface: Table

Delete the given Row.

Specified by:

deleteRow in interface Table

Throws:

AxionException

buildRowDecorator

public RowDecorator buildRowDecorator()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getName

public final java.lang.String getName()

Description copied from interface: Table

Get the name of this table.

Specified by:

getName in interface Table

getType

public final java.lang.String getType()

Description copied from interface: Table

Get the type of this table.

Specified by:

getType in interface Table

setType

public void setType(java.lang.String type)

addConstraint

public void addConstraint(Constraint constraint)
                   throws AxionException

Specified by:

addConstraint in interface Table

Throws:

AxionException

removeConstraint

public Constraint removeConstraint(java.lang.String name)

Specified by:

removeConstraint in interface Table

getConstraint

public Constraint getConstraint(java.lang.String name)

Specified by:

getConstraint in interface Table

getConstraints

public java.util.Iterator getConstraints()

Specified by:

getConstraints in interface Table

isUniqueConstraintExists

public boolean isUniqueConstraintExists(java.lang.String columnName)

check if unique constraint exists on a column

Specified by:

isUniqueConstraintExists in interface Table

Parameters:

columnName - name of the columm

Returns:

true if uniqueConstraint exists on the column

isPrimaryKeyConstraintExists

public final boolean isPrimaryKeyConstraintExists(java.lang.String columnName)

check if primary constraint exists on a column

Specified by:

isPrimaryKeyConstraintExists in interface Table

Parameters:

ColumnName - name of the column

Returns:

if PrimaryKeyConstraint exists on the column

addIndex

public void addIndex(Index index)
              throws AxionException

Description copied from interface: Table

Add an index, associating it with a Column, and adding it as a org.axiondb.TableModificationListenerto the table.

Specified by:

addIndex in interface Table

Throws:

AxionException

See Also:

Table.addIndex(org.axiondb.Index), Table.addTableModificationListener(org.axiondb.event.TableModificationListener), Table.getIndexForColumn(org.axiondb.Column), Table.isColumnIndexed(org.axiondb.Column), Table.populateIndex(org.axiondb.Index)

removeIndex

public void removeIndex(Index index)
                 throws AxionException

Description copied from interface: Table

Remove an index, both from the indices and as a TableModificationListener

Specified by:

removeIndex in interface Table

Throws:

AxionException

getIndexForColumn

public Index getIndexForColumn(Column column)

Description copied from interface: Table

Return the first Indexthat pertains to the given Column, or null if no such Indexexists.

Specified by:

getIndexForColumn in interface Table

Returns:

the pertinent Column, or null if no such Indexexists

isColumnIndexed

public final boolean isColumnIndexed(Column column)

Description copied from interface: Table

Check to see if an Indexexists for the given Column

Specified by:

isColumnIndexed in interface Table

Parameters:

column - Columnto check

Returns:

true iff there is an existing Indexfor the given Column

getMatchingRows

public RowIterator getMatchingRows(java.util.List selectables,
                                   java.util.List values,
                                   boolean readOnly)
                            throws AxionException

Description copied from interface: Table

Obtain an iteratorover my Rows where each Selectablein the selectable list evaluatesto the corresponding value in the value list.

This is functionally similiar to executing a SELECT over this table where selectable[i] = value[i] for each value of i . The return RowIterator is not modifiable.

Specified by:

getMatchingRows in interface Table

Throws:

AxionException

getIndexedRows

public RowIterator getIndexedRows(Selectable node,
                                  boolean readOnly)
                           throws AxionException

Specified by:

getIndexedRows in interface Table

readOnly - when true, the caller does not expect to be able to modify (i.e., call RowIterator.set(org.axiondb.Row)or RowIterator.remove()on) the returned RowIterator, the returned iterator may be unmodifiable.

Throws:

AxionException

getIndexedRows

public RowIterator getIndexedRows(RowSource source,
                                  Selectable node,
                                  boolean readOnly)
                           throws AxionException

Specified by:

getIndexedRows in interface Table

Throws:

AxionException

addColumn

public void addColumn(Column col)
               throws AxionException

Description copied from interface: Table

Add the given Columnto this table.

Specified by:

addColumn in interface Table

Throws:

AxionException

hasColumn

public boolean hasColumn(ColumnIdentifier id)

Description copied from interface: Table

Indicate whether the ColumnIdentifierreferences a column in this table

Specified by:

hasColumn in interface Table

getColumn

public final Column getColumn(int index)

Description copied from interface: Table

Return the Columncorresponding to the given zero-based index .

Specified by:

getColumn in interface Table

getColumn

public final Column getColumn(java.lang.String name)

Description copied from interface: Table

Return the Columnfor the given name .

Specified by:

getColumn in interface Table

getColumnIndex

public int getColumnIndex(java.lang.String name)

Description copied from interface: Table

Return the zero-based index of the Columnwith the given name .

Specified by:

getColumnIndex in interface RowSource

Specified by:

getColumnIndex in interface Table

getColumnIdentifiers

public final java.util.List getColumnIdentifiers()

Description copied from interface: Table

Return an readonly Listover the ColumnIdentifiersfor my Columns.

Specified by:

getColumnIdentifiers in interface Table

getColumnIdentifierList

public java.util.List getColumnIdentifierList(TableIdentifier table)

getColumnCount

public final int getColumnCount()

Description copied from interface: Table

Return the number of Columns I contain.

Specified by:

getColumnCount in interface RowSource

Specified by:

getColumnCount in interface Table

drop

public void drop()
          throws AxionException

Description copied from interface: Table

Drop this table from the database.

Specified by:

drop in interface Table

Throws:

AxionException

deleteFile

protected boolean deleteFile(java.io.File file)

remount

public void remount(java.io.File dir,
                    boolean datafilesonly)
             throws AxionException

Description copied from interface: Table

Notify this table that its disk-location has moved.

Specified by:

remount in interface Table

Throws:

AxionException

rename

public void rename(java.lang.String oldName,
                   java.lang.String newName)
            throws AxionException

Specified by:

rename in interface Table

Throws:

AxionException

shutdown

public void shutdown()
              throws AxionException

Description copied from interface: Table

The database is shutting down, shutdown this table also.

Specified by:

shutdown in interface Table

Throws:

AxionException

checkpoint

public void checkpoint()
                throws AxionException

Specified by:

checkpoint in interface Table

Throws:

AxionException

setSequence

public void setSequence(Sequence seq)
                 throws AxionException

Specified by:

setSequence in interface Table

Throws:

AxionException

getSequence

public Sequence getSequence()

Specified by:

getSequence in interface Table

truncate

public void truncate()
              throws AxionException

Description copied from interface: Table

Unconditionally delete all rows in this table.

Specified by:

truncate in interface Table

Throws:

AxionException

makeRowDecorator

public RowDecorator makeRowDecorator()

Specified by:

makeRowDecorator in interface RowSource

Specified by:

makeRowDecorator in interface Table

makeTransactableTable

public TransactableTable makeTransactableTable()

Description copied from interface: Table

Create a TransactableTablefor this table.

Specified by:

makeTransactableTable in interface Table

migrate

public void migrate()
             throws AxionException

Description copied from interface: Table

Migrate from older version to newer version for this table

Specified by:

migrate in interface Table

Throws:

AxionException

getIndices

public final java.util.Iterator getIndices()

Description copied from interface: Table

Obtain an Iteratorover my indices.

Specified by:

getIndices in interface Table

getTables

public java.util.Iterator getTables()

hasIndex

public final boolean hasIndex(java.lang.String name)

Specified by:

hasIndex in interface Table