com.simba.dsi.core.interfaces
Interface ITransactionStateListener


public interface ITransactionStateListener

An ITransactionStateListener allows the object that it is registered with to notify any components using the DSI that a transaction state change has occurred because of a SQL statement. For instance, executing the query "COMMIT" will cause a transaction state change which must be propagated upwards through the ITransactionStateListener, as it was not done through the normal APIs. The component using the DSI is responsible for beginning new transactions, they should not be implicitly started within the DSI.


Method Summary
 void notifyBeginTransaction()
          Notify the listener that a begin transaction has occurred.
 void notifyCommit()
          Notify the listener that a commit has occurred.
 void notifyCreateSavepoint(java.lang.String name)
          Notify the listener that a savepoint has been created.
 void notifyReleaseSavepoint(java.lang.String name)
          Notify the listener that a savepoint has been released.
 void notifyRollback()
          Notify the listener that a rollback has occurred.
 void notifyRollbackSavepoint(java.lang.String name)
          Notify the listener that a rollback to a savepoint has occurred.
 

Method Detail

notifyBeginTransaction

void notifyBeginTransaction()
                            throws com.simba.support.exceptions.ErrorException
Notify the listener that a begin transaction has occurred.

Throws:
com.simba.support.exceptions.ErrorException - if an error occurs or transactions aren't supported.

notifyCommit

void notifyCommit()
                  throws com.simba.support.exceptions.ErrorException
Notify the listener that a commit has occurred. Note that a commit will invalidate all savepoints from the current transaction.

Throws:
com.simba.support.exceptions.ErrorException - if an error occurs, auto-commit is on, or transactions aren't supported.

notifyCreateSavepoint

void notifyCreateSavepoint(java.lang.String name)
                           throws com.simba.support.exceptions.ErrorException
Notify the listener that a savepoint has been created.

Parameters:
name - The name of the savepoint to create.
Throws:
com.simba.support.exceptions.ErrorException - if an error occurs, auto-commit is on, or transactions aren't supported.

notifyReleaseSavepoint

void notifyReleaseSavepoint(java.lang.String name)
                            throws com.simba.support.exceptions.ErrorException
Notify the listener that a savepoint has been released.

Parameters:
name - The name of the savepoint to create.
Throws:
com.simba.support.exceptions.ErrorException - if an error occurs, auto-commit is on, or transactions aren't supported, or the savepoint does not exist.

notifyRollback

void notifyRollback()
                    throws com.simba.support.exceptions.ErrorException
Notify the listener that a rollback has occurred. Note that a rollback will invalidate all savepoints from the current transaction.

Throws:
com.simba.support.exceptions.ErrorException - if an error occurs, auto-commit is on, or transactions aren't supported.

notifyRollbackSavepoint

void notifyRollbackSavepoint(java.lang.String name)
                             throws com.simba.support.exceptions.ErrorException
Notify the listener that a rollback to a savepoint has occurred.

Parameters:
name - The name of the savepoint to create.
Throws:
com.simba.support.exceptions.ErrorException - if an error occurs, auto-commit is on, or transactions aren't supported, or the savepoint does not exist.


Copyright © 2006-2014 Simba Technologies Incorporated. All Rights Reserved.