com.klg.jclass.datasource
Interface DataModelListener

All Superinterfaces:

EventListener, ReadOnlyBindingListener

All Known Implementing Classes:

Binding.EventListener, DataBinding, DataModelAdapter, IdeDataTable, MetaData

public interface DataModelListener

extends ReadOnlyBindingListener

Objects interested in receiving DataModelEvents must implement this interface. These methods will be called by the data source when its data has changed.

See Also:

DataModelEvent, DataTableModel

Method Summary

void	beforeCancelAll(com.klg.jclass.datasource.DataModelEvent e) Called before all changes are cancelled.
void	beforeCancelRowChanges(com.klg.jclass.datasource.DataModelEvent e) Called before all edits to a row are undone.
void	beforeCommitAll(com.klg.jclass.datasource.DataModelEvent e) Called before all changes are committed.
void	beforeCommitConditional(com.klg.jclass.datasource.DataModelEvent e) Called when the root-level bookmark for a subtree changes.
void	beforeCommitRow(com.klg.jclass.datasource.DataModelEvent e) Called before single row is committed to data source.
void	beforeDeleteRow(com.klg.jclass.datasource.DataModelEvent e) Called before a row is [logically] deleted.
void	beforeDeleteTable(com.klg.jclass.datasource.DataModelEvent e) The indicated DataTable will be deleted and flushed from the cache.
void	beforeEditCell(com.klg.jclass.datasource.DataModelEvent e) Called before a cell is edited.
void	beforeInsertRow(com.klg.jclass.datasource.DataModelEvent e) Called before a row is inserted.
void	beforeMoveToCurrentRow(com.klg.jclass.datasource.DataModelEvent e) The global cursor will move to a new row.
void	beforeRequery(com.klg.jclass.datasource.DataModelEvent e) Called when either DataTableModel.requeryRowAndDetails() or DataTableModel.requeryRow() is called.
void	beforeReset(com.klg.jclass.datasource.DataModelEvent e) Called before entire grid is reset.
void	originatorNavigateRow(com.klg.jclass.datasource.DataModelEvent e) The current row has been deleted and the originator of the deletion should now reposition the global cursor to a new, valid row.

Methods inherited from interface com.klg.jclass.datasource.ReadOnlyBindingListener

afterChangeOfRowData, afterDeleteRow, afterInsertRow, afterMoveToCurrentRow, afterRequeryRowAndDetails, afterRequeryTable, afterReset, beginEvents, endEvents, initialize

Method Detail

beforeInsertRow

public void beforeInsertRow(com.klg.jclass.datasource.DataModelEvent e)

Called before a row is inserted. Can be cancelled. If not cancelled will be followed by afterInsertRow().

See Also:

DataTableModel.addRow(com.klg.jclass.datasource.DataModelListener)

beforeReset

public void beforeReset(com.klg.jclass.datasource.DataModelEvent e)

Called before entire grid is reset. Can be cancelled. If not cancelled will be followed by afterReset(). This will result from a call to DataModel.requeryAll().

See Also:

DataModel.requeryAll(com.klg.jclass.datasource.DataModelListener)

beforeRequery

public void beforeRequery(com.klg.jclass.datasource.DataModelEvent e)

Called when either DataTableModel.requeryRowAndDetails() or DataTableModel.requeryRow() is called. If not cancelled will be followed by an,

• afterRequeryRowAndDetails() call or an
• afterDeleteRow() call in the case getRowStatus() == INSERTED or a
• afterChangeOfRowData() call in the case getRowStatus() == UPDATED or COMMITTED.

See Also:

DataTableModel.requeryRow(com.klg.jclass.datasource.DataModelListener, long), DataTableModel.requeryRowAndDetails(com.klg.jclass.datasource.DataModelListener, long)

beforeEditCell

public void beforeEditCell(com.klg.jclass.datasource.DataModelEvent e)

Called before a cell is edited. Can be cancelled.

See Also:

DataTableModel.updateCell(com.klg.jclass.datasource.DataModelListener, long, java.lang.String, java.lang.Object)

beforeDeleteRow

public void beforeDeleteRow(com.klg.jclass.datasource.DataModelEvent e)

Called before a row is [logically] deleted. Can be cancelled. If not cancelled will be followed by an afterDeleteRow90 or a afterChangeOfRowData() if the commit policy is COMMIT_MANUALLY or COMMIT_LEAVING_ANCESTOR.

See Also:

DataTableModel.deleteRow(com.klg.jclass.datasource.DataModelListener, long), MetaDataModel.getCommitPolicy()

beforeCommitAll

public void beforeCommitAll(com.klg.jclass.datasource.DataModelEvent e)

Called before all changes are committed. Can be cancelled. All modified, deleted and inserted rows at all levels are about to be committed. beforeDeleteRow() and afterChangeOfRowData() will follow depending on the operations performed on the modified rows being saved. Results from a call to DataModel.updateAll.

See Also:

DataModel.updateAll(com.klg.jclass.datasource.DataModelListener)

beforeCancelAll

public void beforeCancelAll(com.klg.jclass.datasource.DataModelEvent e)

Called before all changes are cancelled. Can be cancelled. afterInsertRow() and afterChangeOfRowData() can follow this event.

See Also:

DataModel.cancelAll(com.klg.jclass.datasource.DataModelListener)

beforeCancelRowChanges

public void beforeCancelRowChanges(com.klg.jclass.datasource.DataModelEvent e)

Called before all edits to a row are undone. Can be cancelled An afterDeleteRow() or afterChangeOfRowData() will follow.

See Also:

DataTableModel.cancelRowChanges(com.klg.jclass.datasource.DataModelListener, long)

beforeCommitConditional

public void beforeCommitConditional(com.klg.jclass.datasource.DataModelEvent e)

Called when the root-level bookmark for a subtree changes. When this happens those nodes in the previous subtree which are not COMMIT_MANUALLY are committed. Can be cancelled. If cancelled the cursor moves but the changes are automatically committed.

beforeCommitRow

public void beforeCommitRow(com.klg.jclass.datasource.DataModelEvent e)

Called before single row is committed to data source. Can be cancelled in which case the row edits are not written to the datasource and the rows status remains modified. afterDeleteRow() or afterChangeOfRowData() will follow depending on the status of the row to be committed.

See Also:

DataTableModel.commitRow(com.klg.jclass.datasource.DataModelListener, long)

beforeMoveToCurrentRow

public void beforeMoveToCurrentRow(com.klg.jclass.datasource.DataModelEvent e)

The global cursor will move to a new row. Can be cancelled.

beforeDeleteTable

public void beforeDeleteTable(com.klg.jclass.datasource.DataModelEvent e)

The indicated DataTable will be deleted and flushed from the cache. Can be cancelled.

originatorNavigateRow

public void originatorNavigateRow(com.klg.jclass.datasource.DataModelEvent e)

The current row has been deleted and the originator of the deletion should now reposition the global cursor to a new, valid row.