com.webobjects.eoaccess
Interface EOAdaptorContext.Delegate

Enclosing class:

EOAdaptorContext

public static interface EOAdaptorContext.Delegate

EOAdaptorContext invokes its delegate any time a transaction is begun, committed, or rolled back. The delegate can use these methods to preempt these operations, modify their results, or simply track activity.

Method Summary

void	adaptorContextDidBegin(Object object) Invoked from beginTransaction or transactionDidBegin to tell the delegate that a transaction has begun.
void	adaptorContextDidCommit(Object object) Invoked from commitTransaction or transactionDidCommit to tell the delegate that a transaction has been committed.
void	adaptorContextDidRollback(Object object) Invoked from rollbackTransaction or transactionDidRollback to tell the delegate that a transaction has been rolled back.
boolean	adaptorContextShouldBegin(Object object) Invoked from beginTransaction to ask the delegate whether the adaptor context object should begin a transaction.
boolean	adaptorContextShouldCommit(Object object) Invoked from commitTransaction to ask the delegate whether or not to commit a transaction.
boolean	adaptorContextShouldConnect(Object object) Invoked before the adaptor attempts to connect.
boolean	adaptorContextShouldRollback(Object object) Invoked from rollbackTransaction to ask the delegate whether or not to roll back a transaction.

Method Detail

adaptorContextDidBegin

public void adaptorContextDidBegin(Object object)

Invoked from beginTransaction or transactionDidBegin to tell the delegate that a transaction has begun. The delegate may take whatever action it needs based on this information.

Parameters:

object - An adaptor context object.

See Also:

EOAdaptorContext.beginTransaction(), EOAdaptorContext.transactionDidBegin()

adaptorContextDidCommit

public void adaptorContextDidCommit(Object object)

Invoked from commitTransaction or transactionDidCommit to tell the delegate that a transaction has been committed. The delegate may take whatever action it needs based on this information.

Parameters:

object - An adaptor context object.

See Also:

EOAdaptorContext.commitTransaction(), EOAdaptorContext.transactionDidCommit()

adaptorContextDidRollback

public void adaptorContextDidRollback(Object object)

Invoked from rollbackTransaction or transactionDidRollback to tell the delegate that a transaction has been rolled back. The delegate may take whatever action it needs based on this information.

Parameters:

object - An adaptor context object.

See Also:

EOAdaptorContext.rollbackTransaction(), EOAdaptorContext.transactionDidRollback()

adaptorContextShouldBegin

public boolean adaptorContextShouldBegin(Object object)

Invoked from beginTransaction to ask the delegate whether the adaptor context object should begin a transaction. The delegate should return true to allow the adaptor context to begin a transaction, false to prevent the transaction. If the delegate returns false, it is the delegate's responsibility to handle the transaction state. It might start its own transaction or it might return false from adaptorContextShouldCommit in order to control the transaction in a private way.

Parameters:

object - An adaptor context object.

Returns:

Should return true to allow the adaptor context to begin a transaction.

See Also:

EOAdaptorContext.beginTransaction(), adaptorContextShouldCommit(java.lang.Object)

adaptorContextShouldCommit

public boolean adaptorContextShouldCommit(Object object)

Invoked from commitTransaction to ask the delegate whether or not to commit a transaction. If this method returns false, the adaptor context does not commit the transaction; the delegate must perform the database COMMIT itself.

Parameters:

object - An adaptor context object.

Returns:

Should return true to allow the adaptor context to commit.

See Also:

EOAdaptorContext.commitTransaction(), adaptorContextShouldBegin(java.lang.Object)

adaptorContextShouldConnect

public boolean adaptorContextShouldConnect(Object object)

Invoked before the adaptor attempts to connect. The delegate should return false if it wants to override the connect operation, true if it wants the adaptor to attempt to connect in the usual way. Should throw a runtime exception if it fails to connect.

Parameters:

object - An adaptor context object.

Returns:

Should return true to permit the adaptor to attempt to connect.

adaptorContextShouldRollback

public boolean adaptorContextShouldRollback(Object object)

Invoked from rollbackTransaction to ask the delegate whether or not to roll back a transaction. Should return true to allow the adaptor context object to roll back the transaction, false to prevent the rollback.

Parameters:

object - An adaptor context object.

Returns:

Should return true to allow the adaptor context to roll back the transaction.

See Also:

EOAdaptorContext.rollbackTransaction()