com.klg.jclass.datasource
Class Binding.EventListener

java.lang.Object
  |
  +--com.klg.jclass.datasource.Binding.EventListener

All Implemented Interfaces:

DataModelListener, EventListener, ReadOnlyBindingListener, Serializable

Enclosing class:

Binding

protected class Binding.EventListener

extends Object

implements DataModelListener, Serializable

See Also:

Serialized Form

Constructor Summary

protected

Binding.EventListener()

Method Summary

void	afterChangeOfRowData(com.klg.jclass.datasource.DataModelEvent e) A row has changed, re-read all its cells and its status to reflect the new values.
void	afterDeleteRow(com.klg.jclass.datasource.DataModelEvent e) Removes the row from the display.
void	afterInsertRow(com.klg.jclass.datasource.DataModelEvent e) A new row has been added to the datasource.
void	afterMoveToCurrentRow(com.klg.jclass.datasource.DataModelEvent e) The global cursor has moved to a new row.
void	afterRequeryRowAndDetails(com.klg.jclass.datasource.DataModelEvent e) Re-reads the indicated row and refresh all open children under this row.
void	afterRequeryTable(com.klg.jclass.datasource.DataModelEvent e) Re-read this table and refresh all open children in this table.
void	afterReset(com.klg.jclass.datasource.DataModelEvent e) Listeners must close all expanded views and reset/reread the root node.
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	beginEvents(com.klg.jclass.datasource.DataModelEvent e) Notification that multiple events are coming.
void	endEvents(com.klg.jclass.datasource.DataModelEvent e) Notification that multiple events are complete.
void	initialize(com.klg.jclass.datasource.DataModelEvent e) For internal use only Used by the JCData bean.
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 class java.lang.Object

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

Constructor Detail

Binding.EventListener

protected Binding.EventListener()

Method Detail

afterReset

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

Listeners must close all expanded views and reset/reread the root node. The previous pointer to the root node is no longer valid. Call DataModel.getDataTableTree().getRoot() for the new root table. Called when the datasource has been reset.

Specified by:

afterReset in interface ReadOnlyBindingListener

See Also:

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

afterMoveToCurrentRow

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

The global cursor has moved to a new row. Listeners should position their cursor on the indicated row. In a master-detail relationship child levels should refresh themselves to reflect data sets which correspond to the new parent row by calling DataModel.getCurrentDataTable() or for field controls, DataModel.getCurrentDataItem().

Specified by:

afterMoveToCurrentRow in interface ReadOnlyBindingListener

afterRequeryRowAndDetails

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

Re-reads the indicated row and refresh all open children under this row.

Specified by:

afterRequeryRowAndDetails in interface ReadOnlyBindingListener

afterRequeryTable

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

Re-read this table and refresh all open children in this table.

Specified by:

afterRequeryTable in interface ReadOnlyBindingListener

afterChangeOfRowData

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

A row has changed, re-read all its cells and its status to reflect the new values. If this event is the result of a cell edit call DataModelEvent.getColumn() to get the name of the column which changed. If getColumn() returns "", re-read the entire row. Called when

• a row is deleted and getShowDeletedRows() == true
• a cell was edited
• row edits are cancelled and getRowStatus() == UPDATED
• row edits are cancelled and getRowStatus() == DELETED and getShowDeletedRows() == true
• row is commited and getRowStatus() == UPDATED or INSERTED
• row is requeried and getRowStatus() != INSERTED

Specified by:

afterChangeOfRowData in interface ReadOnlyBindingListener

afterInsertRow

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

A new row has been added to the datasource. Listeners need to display the row. Rows are always added to the end of DataTableModels.

Specified by:

afterInsertRow in interface ReadOnlyBindingListener

afterDeleteRow

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

Removes the row from the display. A row has been physically deleted and needs to be removed from the display or has been logically deleted but the showDeletedRows property has been set to false. Called when,

• a row has been logically deleted and getShowDeletedRows() == false
• row changes have been cancelled and getRowStatus() == INSERTED
'
• a row is committed and getRowStatus() == DELETED and getShowDeletedRows() == true
• a row has been requeried and getRowStatus() == INSERTED

Specified by:

afterDeleteRow in interface ReadOnlyBindingListener

beginEvents

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

Notification that multiple events are coming. Multiple events will be nested between beginEvents() and endEvents(). Allows listeners to treat the events as a batch, to, for example, reduce repaints.

Specified by:

beginEvents in interface ReadOnlyBindingListener

endEvents

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

Notification that multiple events are complete. Multiple events will be nested between beginEvents() and endEvents(). Allows listeners to treat the events as a batch, to, for example, reduce repaints. Called when

• DataModel.updateAll is called
• DataModel.cancelAll is called

Specified by:

endEvents in interface ReadOnlyBindingListener

initialize

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

For internal use only Used by the JCData bean.

Specified by:

initialize in interface ReadOnlyBindingListener

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().

Specified by:

beforeInsertRow in interface DataModelListener

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().

Specified by:

beforeReset in interface DataModelListener

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.

Specified by:

beforeRequery in interface DataModelListener

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.

Specified by:

beforeEditCell in interface DataModelListener

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.

Specified by:

beforeDeleteRow in interface DataModelListener

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.

Specified by:

beforeCommitAll in interface DataModelListener

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.

Specified by:

beforeCancelAll in interface DataModelListener

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.

Specified by:

beforeCancelRowChanges in interface DataModelListener

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.

Specified by:

beforeCommitConditional in interface DataModelListener

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.

Specified by:

beforeCommitRow in interface DataModelListener

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.

Specified by:

beforeMoveToCurrentRow in interface DataModelListener

beforeDeleteTable

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

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

Specified by:

beforeDeleteTable in interface DataModelListener

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.

Specified by:

originatorNavigateRow in interface DataModelListener