com.hardcode.gdbms.engine.strategies
Class OperationDataSource

java.lang.Object
  com.hardcode.gdbms.engine.strategies.OperationDataSource

All Implemented Interfaces:

DataSource, ReadAccess

Direct Known Subclasses:

AggregateDataSource, DistinctDataSource, FilteredDataSource, OrderedDataSource, PDataSource, ProjectionDataSource, UnionDataSource

public abstract class OperationDataSource
extends java.lang.Object
implements DataSource

operation layer DataSource base class

Author:

Fernando González Cortés

Field Summary

Fields inherited from interface com.hardcode.gdbms.engine.data.DataSource

COHERENT_ROW_ORDER, DIRECT_MODE, DISPATCH, IGNORE, STORE

Constructor Summary

OperationDataSource()

Method Summary

void	addEditionListener(EditionListener listener) Adds an EditionListener to the DataSource
void	addField(java.lang.String name, java.lang.String type) Adds a field to the DataSource
void	addField(java.lang.String name, java.lang.String type, java.lang.String[] paramNames, java.lang.String[] paramValues) Adds a field to the DataSource
void	addMetadataEditionListener(MetadataEditionListener listener) Adds a listener for the Metadata edition events
void	addSelectionListener(SelectionListener listener) Adds an SelectionListener to the DataSource
void	beginTrans() Begins a transaction
boolean	canRedo()
boolean	canUndo()
java.lang.String	check(int fieldId, Value value) Checks if this value is a valid one for the specified field.
void	commitTrans() Commits the changes made during the transaction.
void	deleteRow(long rowId)
java.lang.String	getAlias() Returns the alias used in this DataSource
java.lang.String	getAsString() Gets the string representation of this DataSource
DataSourceFactory	getDataSourceFactory() gets a reference to the factory object that created the DataSource
int	getDispatchingMode() Gets the dispatchingMode property
GDBMSDriver	getDriver() Gets the driver which this DataSource is over.
DriverMetadata	getDriverMetadata() Gets the driver metadata
int	getFieldIndexByName(java.lang.String name) Obtiene el indice de un campo a partir de su nombre o -1 si no existe un campo con ese nombre
java.lang.String[]	getFieldNames() Gets the field names array
Memento	getMemento() Gets a memento object with the current status of the DataSource
java.lang.String	getName() Devuelve el nombre del DataSource
Value[]	getRow(long rowIndex) Gets the value of all fields at the specified row
int[]	getSelectedRows() Gets the row selection
java.lang.String	getSQL() Gets the SQL string that created this DataSource
long[]	getWhereFilter() Devuelve el filtro que resultó de la cláusula where de la instrucción que dió como resultado este DataSource.
void	insertEmptyRow() Inserts a row at the end of the dataware
void	insertEmptyRowAt(long index)
void	insertFilledRow(Value[] values) Inserts a row at the end of the dataware with the specified values
void	insertFilledRowAt(long index, Value[] values)
boolean	isModified() Returns true if the DataSource has been modified since it was created.
void	redo() Redoes the last undone edition action
void	remove() Removes from the system the data source this DataSource instance represents.
void	removeEditionListener(EditionListener listener) Removes an EditionListener from the DataSource
void	removeField(int index) Removes the field at the indexth position
void	removeMetadataEditionListener(MetadataEditionListener listener) Removes a listener for the Metadata edition events
void	removeSelectionListener(SelectionListener listener) Removes an SelectionListener from the DataSource
void	rollBackTrans() Cancels the changes made during the transaction
void	saveData(DataSource ds) Saves the data in the parameter DataSource in the source of this DataSource.
void	setAlias(java.lang.String alias)
void	setDataSourceFactory(DataSourceFactory dsf) Sets the DataSourceFactory that created the DataSource instance
void	setDispatchingMode(int dispatchingMode) Defines the behaviour of the DataSource when an edition event happens.
void	setFieldName(int index, java.lang.String name) Sets the name of the field at the indexth position
void	setFieldValue(long row, int fieldId, Value value) Sets the value of a cell of the table.
void	setName(java.lang.String name)
void	setSelectedRows(int[] sel) Sets the row selection
void	setSQL(java.lang.String sql) sets the sql query of this operation DataSource.
void	undo() Undoes the last edition action

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.hardcode.gdbms.engine.data.DataSource

getDataSourceMetadata, start, stop

Methods inherited from interface com.hardcode.gdbms.engine.data.driver.ReadAccess

getFieldValue, getRowCount

Constructor Detail

OperationDataSource

public OperationDataSource()

Method Detail

getWhereFilter

public long[] getWhereFilter()
                      throws java.io.IOException

Description copied from interface: DataSource

Devuelve el filtro que resultó de la cláusula where de la instrucción que dió como resultado este DataSource.

Specified by:

getWhereFilter in interface DataSource

Returns:

Filtro de la cláusula where o null si el DataSource no es resultado de una instrucción con cláusula where

Throws:

java.io.IOException - Si se produce un error accediendo a las estructuras de datos internas

See Also:

DataSource.getWhereFilter()

getDataSourceFactory

public DataSourceFactory getDataSourceFactory()

Description copied from interface: DataSource

gets a reference to the factory object that created the DataSource

Specified by:

getDataSourceFactory in interface DataSource

Returns:

DataSourceFactory

See Also:

DataSource.getDataSourceFactory()

setDataSourceFactory

public void setDataSourceFactory(DataSourceFactory dsf)

Description copied from interface: DataSource

Sets the DataSourceFactory that created the DataSource instance

Specified by:

setDataSourceFactory in interface DataSource

Parameters:

dsf - DataSourceFactory

See Also:

DataSource.setDataSourceFactory(com.hardcode.gdbms.engine.data.DataSourceFactory)

setSQL

public void setSQL(java.lang.String sql)

sets the sql query of this operation DataSource. It's needed by the getMemento method which contains basically the sql

Parameters:

sql - query

getSQL

public java.lang.String getSQL()

Gets the SQL string that created this DataSource

Returns:

String with the query

remove

public void remove()
            throws DriverException

Description copied from interface: DataSource

Removes from the system the data source this DataSource instance represents. No method can be called and no DataSource instance can be obtained from the system after calling this method.

Specified by:

remove in interface DataSource

Throws:

DriverException - if the DataSource original system could not be cleaned properly

See Also:

DataSource.remove()

deleteRow

public void deleteRow(long rowId)
               throws DriverException

Throws:

DriverException

insertFilledRow

public void insertFilledRow(Value[] values)
                     throws DriverException

Description copied from interface: DataSource

Inserts a row at the end of the dataware with the specified values

Specified by:

insertFilledRow in interface DataSource

Parameters:

values - Values of the inserted row fields in the field order

Throws:

DriverException - if the row could not be inserted

insertEmptyRow

public void insertEmptyRow()
                    throws DriverException

Description copied from interface: DataSource

Inserts a row at the end of the dataware

Specified by:

insertEmptyRow in interface DataSource

Throws:

DriverException - if the row could not be inserted

beginTrans

public void beginTrans()
                throws DriverException

Description copied from interface: DataSource

Begins a transaction

Specified by:

beginTrans in interface DataSource

Throws:

DriverException - If the transaction could not be started

commitTrans

public void commitTrans()
                 throws DriverException

Description copied from interface: DataSource

Commits the changes made during the transaction. The DataSource is closed after the commit so any spatial or alphanumeric index will be cleared

Specified by:

commitTrans in interface DataSource

Throws:

DriverException - If the transaction could not be commited

rollBackTrans

public void rollBackTrans()
                   throws DriverException

Description copied from interface: DataSource

Cancels the changes made during the transaction

Specified by:

rollBackTrans in interface DataSource

Throws:

DriverException - If the transaction could not be cancelled

setFieldValue

public void setFieldValue(long row,
                          int fieldId,
                          Value value)
                   throws DriverException

Description copied from interface: DataSource

Sets the value of a cell of the table. Cannot be called outside a beginTrans-commintTrans or beginTrans-rollBackTrans

Specified by:

setFieldValue in interface DataSource

Parameters:

row - row to update

fieldId - field to update

value - Value to update

Throws:

DriverException - If the operation failed

insertEmptyRowAt

public void insertEmptyRowAt(long index)
                      throws DriverException

Throws:

DriverException

insertFilledRowAt

public void insertFilledRowAt(long index,
                              Value[] values)
                       throws DriverException

Throws:

DriverException

saveData

public void saveData(DataSource ds)
              throws DriverException

Description copied from interface: DataSource

Saves the data in the parameter DataSource in the source of this DataSource. Both DataSource's must have the same schema, the same metadata. This DataSource must be closed before any call to this method

Specified by:

saveData in interface DataSource

Parameters:

ds - DataSource with the data

Throws:

DriverException - if the operation fails

getAlias

public java.lang.String getAlias()

Description copied from interface: DataSource

Returns the alias used in this DataSource

Specified by:

getAlias in interface DataSource

Returns:

String

See Also:

DataSource.getAlias()

getAsString

public java.lang.String getAsString()
                             throws DriverException

Description copied from interface: DataSource

Gets the string representation of this DataSource

Specified by:

getAsString in interface DataSource

Returns:

String

Throws:

DriverException

See Also:

DataSource.getAsString()

getFieldNames

public java.lang.String[] getFieldNames()
                                 throws DriverException

Description copied from interface: DataSource

Gets the field names array

Specified by:

getFieldNames in interface DataSource

Returns:

String[]

Throws:

DriverException - if the access fails

See Also:

DataSource.getFieldNames()

getFieldIndexByName

public int getFieldIndexByName(java.lang.String name)
                        throws DriverException

Description copied from interface: DataSource

Obtiene el indice de un campo a partir de su nombre o -1 si no existe un campo con ese nombre

Specified by:

getFieldIndexByName in interface DataSource

Parameters:

name - Nombre del campo

Returns:

Indice del campo con el nombre dado o -1 si el campo no existe

Throws:

DriverException

See Also:

DataSource.getFieldIndexByName(java.lang.String)

getMemento

public Memento getMemento()
                   throws MementoException

Description copied from interface: DataSource

Gets a memento object with the current status of the DataSource

Specified by:

getMemento in interface DataSource

Returns:

DataSourceMemento

Throws:

MementoException - If the state cannot be obtained

See Also:

DataSource.getMemento()

getName

public java.lang.String getName()

Description copied from interface: DataSource

Devuelve el nombre del DataSource

Specified by:

getName in interface DataSource

Returns:

nombre de la tabla

See Also:

DataSource.getName()

getRow

public Value[] getRow(long rowIndex)
               throws DriverException

Description copied from interface: DataSource

Gets the value of all fields at the specified row

Specified by:

getRow in interface DataSource

Parameters:

rowIndex - index of the row to be retrieved

Returns:

Value[]

Throws:

DriverException - If the access fails

See Also:

DataSource.getRow(long)

setAlias

public void setAlias(java.lang.String alias)

Parameters:

alias -

setName

public void setName(java.lang.String name)

Parameters:

name -

canRedo

public boolean canRedo()

Specified by:

canRedo in interface DataSource

Returns:

true if there is an edition action to redo

canUndo

public boolean canUndo()

Specified by:

canUndo in interface DataSource

Returns:

true if there is an edition action to undo

redo

public void redo()
          throws DriverException

Description copied from interface: DataSource

Redoes the last undone edition action

Specified by:

redo in interface DataSource

Throws:

DriverException

undo

public void undo()
          throws DriverException

Description copied from interface: DataSource

Undoes the last edition action

Specified by:

undo in interface DataSource

Throws:

DriverException

addEditionListener

public void addEditionListener(EditionListener listener)

Description copied from interface: DataSource

Adds an EditionListener to the DataSource

Specified by:

addEditionListener in interface DataSource

removeEditionListener

public void removeEditionListener(EditionListener listener)

Description copied from interface: DataSource

Removes an EditionListener from the DataSource

Specified by:

removeEditionListener in interface DataSource

addMetadataEditionListener

public void addMetadataEditionListener(MetadataEditionListener listener)

Description copied from interface: DataSource

Adds a listener for the Metadata edition events

Specified by:

addMetadataEditionListener in interface DataSource

removeMetadataEditionListener

public void removeMetadataEditionListener(MetadataEditionListener listener)

Description copied from interface: DataSource

Removes a listener for the Metadata edition events

Specified by:

removeMetadataEditionListener in interface DataSource

setDispatchingMode

public void setDispatchingMode(int dispatchingMode)

Description copied from interface: DataSource

Defines the behaviour of the DataSource when an edition event happens. It can be set to DISPATCH, STORE, IGNORE. It's set to DISPATCH when the DataSource opens

Specified by:

setDispatchingMode in interface DataSource

getDispatchingMode

public int getDispatchingMode()

Description copied from interface: DataSource

Gets the dispatchingMode property

Specified by:

getDispatchingMode in interface DataSource

addField

public void addField(java.lang.String name,
                     java.lang.String type)

Description copied from interface: DataSource

Adds a field to the DataSource

Specified by:

addField in interface DataSource

Parameters:

name - name of the field

type - driver specific type name

addField

public void addField(java.lang.String name,
                     java.lang.String type,
                     java.lang.String[] paramNames,
                     java.lang.String[] paramValues)

Description copied from interface: DataSource

Adds a field to the DataSource

Specified by:

addField in interface DataSource

Parameters:

name - name of the field

type - driver specific type name

removeField

public void removeField(int index)

Description copied from interface: DataSource

Removes the field at the indexth position

Specified by:

removeField in interface DataSource

setFieldName

public void setFieldName(int index,
                         java.lang.String name)

Description copied from interface: DataSource

Sets the name of the field at the indexth position

Specified by:

setFieldName in interface DataSource

getDriverMetadata

public DriverMetadata getDriverMetadata()

Description copied from interface: DataSource

Gets the driver metadata

Specified by:

getDriverMetadata in interface DataSource

Returns:

check

public java.lang.String check(int fieldId,
                              Value value)
                       throws DriverException

Description copied from interface: DataSource

Checks if this value is a valid one for the specified field. Returns null if the field contains a valid value and returns a String with a message to the user if it is not

Specified by:

check in interface DataSource

Returns:

Throws:

DriverException

getDriver

public GDBMSDriver getDriver()

Description copied from interface: DataSource

Gets the driver which this DataSource is over. Can be null

Specified by:

getDriver in interface DataSource

Returns:

isModified

public boolean isModified()

Description copied from interface: DataSource

Returns true if the DataSource has been modified since it was created. Notice that it doesn't check the source and only checks wheter the source has been modified through this instance

Specified by:

isModified in interface DataSource

Returns:

getSelectedRows

public int[] getSelectedRows()

Description copied from interface: DataSource

Gets the row selection

Specified by:

getSelectedRows in interface DataSource

Returns:

setSelectedRows

public void setSelectedRows(int[] sel)

Description copied from interface: DataSource

Sets the row selection

Specified by:

setSelectedRows in interface DataSource

addSelectionListener

public void addSelectionListener(SelectionListener listener)

Description copied from interface: DataSource

Adds an SelectionListener to the DataSource

Specified by:

addSelectionListener in interface DataSource

removeSelectionListener

public void removeSelectionListener(SelectionListener listener)

Description copied from interface: DataSource

Removes an SelectionListener from the DataSource

Specified by:

removeSelectionListener in interface DataSource