com.klg.jclass.datasource
Interface ReadOnlyBindingListener

All Superinterfaces:

EventListener

All Known Subinterfaces:

DataModelListener

All Known Implementing Classes:

Binding.EventListener, DataBinding, DataModelAdapter, IdeDataTable, MetaData

public interface ReadOnlyBindingListener

extends EventListener

Passive listeners -- objects interested in receiving only read-only DataModelEvents should implement this interface. These methods will be called by the data source AFTER its data has changed.

This interface is extended by the DataModelListener to add events of interest to active listeners -- listeners who make changes to the data and need to know about changes made by other components BEFORE they occur.

For convenience, override these methods in the DataModelAdapter to satisfy a read-only implmentation of a DataModelListener.

See Also:

DataModelEvent, DataTableModel, DataModelAdapter

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

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.

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

afterRequeryRowAndDetails

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

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

afterRequeryTable

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

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

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

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.

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

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.

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

initialize

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

For internal use only Used by the JCData bean.