com.sssw.srv.busobj
Interface AgiTableListener

public interface AgiTableListener

Implemented by all business objects which listen for events on database tables. In the event that a silverstream client modifies the data in a table with a table listener, then at least two and perhaps as many as five of six possible events are fired. The beforeTableChange event is fired before the transaction is begun. Then the transaction is started and an event is fired just before each row is either inserted (rowInserted), modified (rowModified), or deleted (rowDeleted). Finally the afterTableChange event is fired just after the transaction is commited. If the transaction is abortted for any reason, the Aborted event is fired (and the afterTableChange event is not fired).

Note that table listeners are not database triggers. They are only fired if the data modification comes from a SilverStream client through the SilverStream Server. If some other database client directly modifies the database, the table listeners will not be fired.

When a Table-modified business object is created, SilverStream automatically adds the implements AgiTableListener clause to the object's class definition.

Method Summary

void	aborted(AgoTransactionAbortEvent e) Fires just after a transaction is aborted.
void	afterTableChange(AgoTableEvent e) Fires just before a database transaction is started.
void	beforeTableChange(AgoTableEvent e) Fires just before a database transaction is started.
void	rowDeleted(AgoRowDeleteEvent e) Fires just before a row in the table is modified.
void	rowInserted(AgoRowInsertEvent e) Fires just before a row is inserted into a table.
void	rowModified(AgoRowModifyEvent e) Fires just before a row in the table is modified.

Method Detail

beforeTableChange

public void beforeTableChange(AgoTableEvent e)

Fires just before a database transaction is started.

Parameters:

e - an instance of a AgoTableEvent.

See Also:

AgoTableEvent

rowInserted

public void rowInserted(AgoRowInsertEvent e)

Fires just before a row is inserted into a table.

Parameters:

e - an instance of an AgoRowInsertEvent.

See Also:

AgoRowInsertEvent

rowModified

public void rowModified(AgoRowModifyEvent e)

Fires just before a row in the table is modified.

Parameters:

e - an instance of an AgoRowModifyEvent.

See Also:

AgoRowModifyEvent

rowDeleted

public void rowDeleted(AgoRowDeleteEvent e)

Fires just before a row in the table is modified.

Parameters:

e -

See Also:

AgoRowDeleteEvent

afterTableChange

public void afterTableChange(AgoTableEvent e)

Fires just before a database transaction is started.

Parameters:

e - an instance of a AgoTableEvent.

See Also:

AgoTableEvent

aborted

public void aborted(AgoTransactionAbortEvent e)

Fires just after a transaction is aborted. No other events related to this transaction are fired.

Parameters:

e - an instance of an AgoTransactionAbortEvent.

See Also:

AgoTransactionAbortEvent