oracle.jbo.server
Class NullDBTransactionImpl

java.lang.Object
  |
  +--oracle.jbo.server.NullDBTransactionImpl

public class NullDBTransactionImpl

extends java.lang.Object

implements DBTransaction

Internal: Applications should not use this class.

Field Summary

protected ConnectionCredentials

mConnectionCredentials

Fields inherited from interface oracle.jbo.server.DBTransaction

DEFAULT

Fields inherited from interface oracle.jbo.Transaction

LOCK_NONE, LOCK_OPTIMISTIC, LOCK_PESSIMISTIC

Constructor Summary

NullDBTransactionImpl()

Method Summary

void	addToValidationListeners(ValidationListener w) Implementation of the DBTransaction interface.
void	addTransactionListener(TransactionListener listener) Implementation of the DBTransaction interface.
void	addTransactionListenerNoCheck(TransactionListener listener) Implementation of the DBTransaction interface.
void	addTransactionPostListener(TransactionPostListener listener) Implementation of the DBTransaction interface.
void	addTransactionPostListenerNoCheck(TransactionPostListener listener) Implementation of the DBTransaction interface.
void	addWarning(JboWarning warn) Implementation of the DBTransaction interface.
void	applyChangeSet(int id) Applies the changes committed by another transaction in order to synchronize caches between root Application Module instances.
void	clearEntityCache(java.lang.String entityName) Clears the cache of the specified Entity Object.
void	closeTransaction() Implementation of the DBTransaction interface.
void	commit() Implementation of the DBTransaction interface.
int	commitAndSaveChangeSet() Commits the transaction and writes updated EntityImpls to the persistent store.
void	connect(java.sql.Connection sqlConnection) Implementation of the DBTransaction interface.
void	connect(java.lang.String url) Implementation of the DBTransaction interface.
void	connect(java.lang.String url, java.util.Properties info) Implementation of the DBTransaction interface.
void	connect(java.lang.String url, java.lang.String user, java.lang.String password) Implementation of the DBTransaction interface.
ApplicationModule	createApplicationModule(java.lang.String defName) Implementation of the DBTransaction interface.
java.sql.CallableStatement	createCallableStatement(java.lang.String str, int noRowsPrefetch) Implementation of the DBTransaction interface.
EntityImpl	createEntityInstance(EntityDefImpl entityDef, AttributeList al) Implementation of the DBTransaction interface.
EntityImpl	createEntityInstance(java.lang.String entityDefName, AttributeList al) Implementation of the DBTransaction interface.
java.sql.PreparedStatement	createPreparedStatement(java.lang.String str, int noRowsPrefetch) Implementation of the DBTransaction interface.
java.lang.Object	createRef(java.lang.String structName, byte[] data) Internal: Applications should not use this method.
java.sql.Statement	createStatement(int noRowsPrefetch) Implementation of the DBTransaction interface.
ViewLink	createViewLink(java.lang.String viewLinkDefName, ViewObject master, ViewObject detail) Implementation of the DBTransaction interface.
ViewLink	createViewLinkBetweenViewObjects(java.lang.String accessorName, ViewObject master, AttributeDef[] srcAttrs, ViewObject detail, AttributeDef[] destAttrs, java.lang.String assocClause) Implementation of the DBTransaction interface.
ViewLink	createViewLinkFromEntityAssocName(java.lang.String entityAssocName, ViewObject master, ViewObject detail) Implementation of the DBTransaction interface.
ViewObject	createViewObject(java.lang.String voDefName) Implementation of the DBTransaction interface.
ViewObject	createViewObjectFromQueryClauses(java.lang.String eoName, java.lang.String selectClause, java.lang.String fromClause, java.lang.String whereClause, java.lang.String orderByClause) Implementation of the DBTransaction interface.
ViewObject	createViewObjectFromQueryStmt(java.lang.String sqlStatement) Implementation of the DBTransaction interface.
void	disconnect() Implementation of the DBTransaction interface.
void	disconnect(boolean retainState) Closes the JDBC connection object and removes this transaction from the root application module.
java.lang.String	dumpQueryResult(java.lang.String query, java.lang.String dumpClassName, java.lang.String[] data) Implementation of the DBTransaction interface.
int	executeCommand(java.lang.String command) Implementation of the DBTransaction interface.
EntityImpl	findByPrimaryKey(EntityDefImpl entityDef, Key key) Implementation of the DBTransaction interface.
EntityImpl	findByPrimaryKey(java.lang.String entityDefName, Key key) Implementation of the DBTransaction interface.
int	getLockingMode() Implementation of the DBTransaction interface.
int	getPostThreshold() Implementation of the DBTransaction interface.
Session	getSession() Implementation of the DBTransaction interface.
SQLBuilder	getSQLBuilder()
TransactionHandler	getTransactionHandler() Internal: Applications should not use this method.
int	getValidationThreshold() Implementation of the DBTransaction interface.
boolean	isClearCacheOnCommit() Indicates whether all Entity Object caches will be cleared after the transaction is committed.
boolean	isClearCacheOnRollback() Indicates whether all Entity Object caches will be cleared after the transaction is rolled back.
boolean	isConnected() Implementation of the DBTransaction interface.
boolean	isDirty() Implementation of the DBTransaction interface.
void	postChanges() Implementation of the DBTransaction interface.
void	reconnect() Reconnect the application module to the database, if necessary, using previously supplied database credentials.
void	reconnect(boolean force) Implementation of the DBTransaction interface.
void	removeChangeSet(int id) Removes the change set that defines the changes to EntityImpls within a transaction.
void	removeTransactionListener(TransactionListener listener) Implementation of the DBTransaction interface.
void	removeTransactionPostListener(TransactionPostListener listener) Implementation of the DBTransaction interface.
void	rollback() Implementation of the DBTransaction interface.
void	setClearCacheOnCommit(boolean val) Indicates whether all Entity Object caches will be cleared after the transaction is committed.
void	setClearCacheOnRollback(boolean val) Indicates whether all Entity Object caches will be cleared after the transaction is rolled back.
void	setLockingMode(int mode) Implementation of the DBTransaction interface.
void	setPostThreshold(int count) Implementation of the DBTransaction interface.
void	setTransactionHandler(TransactionHandler txnHandler) Internal: Applications should not use this method.
void	setValidationThreshold(int count) Implementation of the DBTransaction interface.
void	validate() Implementation of the DBTransaction interface.

Methods inherited from class java.lang.Object

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

Field Detail

mConnectionCredentials

protected ConnectionCredentials mConnectionCredentials

Constructor Detail

NullDBTransactionImpl

public NullDBTransactionImpl()

Method Detail

closeTransaction

public void closeTransaction()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

closeTransaction in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

commit

public void commit()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

commitAndSaveChangeSet

public int commitAndSaveChangeSet()

Description copied from interface: Transaction

Commits the transaction and writes updated EntityImpls to the persistent store.

This method (along with applyChangeSet and removeChangeSet is used to synchronize the cache between root Application Module instances in an Application Module pool.

commitAndSaveChangeSet commits the transaction, but during the commit process, writes out "changed" EntityImpls to the persistent store. These changes are stored as a "change set". The change set can then be applied to other transactions (that is, to the Entity caches of other root Application Modules).

The integer value returned by this method identifies the change set that is stored in persistent store.

To apply the changes to another transaction (or Application Module cache), call Transaction.applyChangeSet(int) where int is the integer value returned by commitAndSaveChangeSet that represents the change set.

For example, assume you have two root Application Modules, named am1 and am2, in an Application Module pool.

  // The line below commits the transaction in am1 and writes the change
  // set to persistent store (database table).  The returning snapId
  // identifies the (persistent) change set.

  int snapId = am1.getTransaction().commitAndSaveChangeSet();

  // Use that change set and apply the changes to the other Application
  // Module, am2.  That is, apply changes from am1 to am2.

  am2.getTransaction().applyChangeSet(snapId);

  // When you are done with the change set, remove (free) it.

  am1.getTransaction().removeChangeSet(snapId);
 

Tags copied from interface: Transaction

Returns:

an integer representing an EntityImpl change set in persistent store.

See Also:

Transaction.applyChangeSet(int), Transaction.removeChangeSet(int)

applyChangeSet

public void applyChangeSet(int id)

Description copied from interface: Transaction

Applies the changes committed by another transaction in order to synchronize caches between root Application Module instances.

This method (along with commitAndSaveChangeSet and removeChangeSet is used to synchronize the cache between root Application Module instances in an Application Module pool.

Call applyChangeSet to apply changes commited by another transaction. The integer id parameter (returned by commitAndSaveChangeSet) identifies the change set to be found in the persistent store.

After this call, this transaction's cache is synchronized with the changes from the change set.

For an example of how to use applyChangeSet, see commitAndSaveChangeSet.

Tags copied from interface: Transaction

Parameters:

id - an integer representing the change set to apply to the transaction.

See Also:

Transaction.commitAndSaveChangeSet(), Transaction.removeChangeSet(int)

removeChangeSet

public void removeChangeSet(int id)

Description copied from interface: Transaction

Removes the change set that defines the changes to EntityImpls within a transaction.

This method (along with commitAndSaveChangeSet and applyChangeSet is used to synchronize the cache between root Application Module instances in an Application Module pool.

For an example of how to use removeChangeSet, see commitAndSaveChangeSet.

Tags copied from interface: Transaction

Parameters:

id - an integer representing the change set to remove from the persistent store.

See Also:

Transaction.commitAndSaveChangeSet(), Transaction.applyChangeSet(int)

rollback

public void rollback()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

postChanges

public void postChanges()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

isDirty

public boolean isDirty()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

setPostThreshold

public void setPostThreshold(int count)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

setPostThreshold in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

getPostThreshold

public int getPostThreshold()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

getPostThreshold in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

setValidationThreshold

public void setValidationThreshold(int count)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

setValidationThreshold in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

getValidationThreshold

public int getValidationThreshold()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

getValidationThreshold in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

addTransactionListener

public void addTransactionListener(TransactionListener listener)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

addTransactionListener in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

addTransactionListenerNoCheck

public void addTransactionListenerNoCheck(TransactionListener listener)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

addTransactionListenerNoCheck in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

removeTransactionListener

public void removeTransactionListener(TransactionListener listener)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

removeTransactionListener in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

addTransactionPostListener

public void addTransactionPostListener(TransactionPostListener listener)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

addTransactionPostListener in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

addTransactionPostListenerNoCheck

public void addTransactionPostListenerNoCheck(TransactionPostListener listener)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

addTransactionPostListenerNoCheck in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

removeTransactionPostListener

public void removeTransactionPostListener(TransactionPostListener listener)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

removeTransactionPostListener in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createStatement

public java.sql.Statement createStatement(int noRowsPrefetch)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createStatement in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createCallableStatement

public java.sql.CallableStatement createCallableStatement(java.lang.String str,
                                                          int noRowsPrefetch)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createCallableStatement in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createPreparedStatement

public java.sql.PreparedStatement createPreparedStatement(java.lang.String str,
                                                          int noRowsPrefetch)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createPreparedStatement in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

executeCommand

public int executeCommand(java.lang.String command)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

dumpQueryResult

public java.lang.String dumpQueryResult(java.lang.String query,
                                        java.lang.String dumpClassName,
                                        java.lang.String[] data)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

validate

public void validate()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

addToValidationListeners

public void addToValidationListeners(ValidationListener w)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

connect

public void connect(java.sql.Connection sqlConnection)

Implementation of the DBTransaction interface. Transitions the application from disconnected to connected state using the DatabaseTransactionFactory.

Specified by:

connect in interface DBTransaction

Parameters:

sqlConnection - Reqeusts the factory to create a DBTransactionImpl object from the given Connection

See Also:

DBTransaction.connect(Connection), DatabaseTransactionFactory

connect

public void connect(java.lang.String url)

Implementation of the DBTransaction interface. Transitions the application from disconnected to connected state using the DatabaseTransactionFactory.

Parameters:

url - Reqeusts the factory to create a DBTransactionImpl object from the given URL

See Also:

Transaction.connect(String), DatabaseTransactionFactory

connect

public void connect(java.lang.String url,
                    java.util.Properties info)

Implementation of the DBTransaction interface. Transitions the application from disconnected to connected state using the DatabaseTransactionFactory.

Parameters:

url - Reqeusts the factory to create a DBTransactionImpl object from the given url and properties

info - Reqeusts the factory to create a DBTransactionImpl object from given the url and properties

See Also:

Transaction.connect(String, Properties), DatabaseTransactionFactory

connect

public void connect(java.lang.String url,
                    java.lang.String user,
                    java.lang.String password)

Implementation of the DBTransaction interface. Transitions the application from disconnected to connected state using the DatabaseTransactionFactory.

Parameters:

url - Reqeusts the factory to create a DBTransactionImpl object from the given url, username and password.

user - Reqeusts the factory to create a DBTransactionImpl object from the given url, username and password.

password - Reqeusts the factory to create a DBTransactionImpl object from the given url, username and password.

See Also:

Transaction.connect(String, Properties), DatabaseTransactionFactory

disconnect

public void disconnect()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

isConnected

public boolean isConnected()

Implementation of the DBTransaction interface. Test if JDBC connection is established

Returns:

Always returns false.

reconnect

public void reconnect(boolean force)

Implementation of the DBTransaction interface. reconnects if possible: ie. if we have been connected before, using the existing credentials.

Throws:

NotConnectedConnection - Always thrown.

setLockingMode

public void setLockingMode(int mode)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

getLockingMode

public int getLockingMode()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Throws:

NotConnectedConnection - Always thrown.

getTransactionHandler

public TransactionHandler getTransactionHandler()

Description copied from interface: DBTransaction

Internal: Applications should not use this method.

Specified by:

getTransactionHandler in interface DBTransaction

setTransactionHandler

public void setTransactionHandler(TransactionHandler txnHandler)

Description copied from interface: DBTransaction

Internal: Applications should not use this method.

Specified by:

setTransactionHandler in interface DBTransaction

createEntityInstance

public EntityImpl createEntityInstance(EntityDefImpl entityDef,
                                       AttributeList al)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createEntityInstance in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createEntityInstance

public EntityImpl createEntityInstance(java.lang.String entityDefName,
                                       AttributeList al)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createEntityInstance in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

findByPrimaryKey

public EntityImpl findByPrimaryKey(EntityDefImpl entityDef,
                                   Key key)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

findByPrimaryKey in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

findByPrimaryKey

public EntityImpl findByPrimaryKey(java.lang.String entityDefName,
                                   Key key)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

findByPrimaryKey in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createViewObject

public ViewObject createViewObject(java.lang.String voDefName)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createViewObject in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createViewObjectFromQueryClauses

public ViewObject createViewObjectFromQueryClauses(java.lang.String eoName,
                                                   java.lang.String selectClause,
                                                   java.lang.String fromClause,
                                                   java.lang.String whereClause,
                                                   java.lang.String orderByClause)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createViewObjectFromQueryClauses in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createViewObjectFromQueryStmt

public ViewObject createViewObjectFromQueryStmt(java.lang.String sqlStatement)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createViewObjectFromQueryStmt in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createApplicationModule

public ApplicationModule createApplicationModule(java.lang.String defName)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createApplicationModule in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createViewLink

public ViewLink createViewLink(java.lang.String viewLinkDefName,
                               ViewObject master,
                               ViewObject detail)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createViewLink in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createViewLinkFromEntityAssocName

public ViewLink createViewLinkFromEntityAssocName(java.lang.String entityAssocName,
                                                  ViewObject master,
                                                  ViewObject detail)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createViewLinkFromEntityAssocName in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

createViewLinkBetweenViewObjects

public ViewLink createViewLinkBetweenViewObjects(java.lang.String accessorName,
                                                 ViewObject master,
                                                 AttributeDef[] srcAttrs,
                                                 ViewObject detail,
                                                 AttributeDef[] destAttrs,
                                                 java.lang.String assocClause)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

createViewLinkBetweenViewObjects in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

addWarning

public void addWarning(JboWarning warn)

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

addWarning in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

getSession

public Session getSession()

Implementation of the DBTransaction interface. Calling this method always results in NotConnectedException.

Specified by:

getSession in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

getSQLBuilder

public SQLBuilder getSQLBuilder()

Specified by:

getSQLBuilder in interface DBTransaction

isClearCacheOnCommit

public boolean isClearCacheOnCommit()

Description copied from interface: Transaction

Indicates whether all Entity Object caches will be cleared after the transaction is committed. If the Entity caches are cleared, they will be refreshed with new data from the database. Clearing the Entity cache will ensure that all changes from the database will be captured; relying on the fault-in mechanism or RowSet.executeQuery might miss some of the changes.

The value of the Application Module's isClearCacheOnCommit() flag will be used if the client has not set this flag in the Transaction. At the end of transaction, the transaction checks the value of its isClearCacheOnCommit() flag and either clears the Entity Object caches or not. However, if the client never called setClearCacheOnCommit on this transaction, the framework will use the value for the root Application Module's definition object.

In contrast, if the client called setClearCacheOnCommit on the Transaction, then the value of the root Application Module Def's isClearCacheOnCommit is not used.

Note that clearing the Entity Object caches has performance ramifications: repopulating the caches is expensive in terms of time and processing effort.

For middle-tier applications, you can use isClearCacheOnCommit and setClearCacheOnCommit in the DBTransactionImpl class.

Tags copied from interface: Transaction

Returns:

true indicates that the Entity Object caches will be cleared on commit, and will be refreshed with new data from the database.

See Also:

RowSet.executeQuery(), Transaction.setClearCacheOnCommit(boolean val), DBTransactionImpl.isClearCacheOnCommit(), DBTransactionImpl.setClearCacheOnCommit(boolean val)

setClearCacheOnCommit

public void setClearCacheOnCommit(boolean val)

Description copied from interface: Transaction

Indicates whether all Entity Object caches will be cleared after the transaction is committed. For more information on this topic, see isClearCacheOnCommit.

Tags copied from interface: Transaction

Parameters:

val - true indicates that the Entity Object caches will be cleared on commit, and will be refreshed with new data from the database.

See Also:

#isClearCacheOnCommit(boolean val)

isClearCacheOnRollback

public boolean isClearCacheOnRollback()

Description copied from interface: Transaction

Indicates whether all Entity Object caches will be cleared after the transaction is rolled back. If the Entity caches are cleared, they will be refreshed with new data from the database. Clearing the Entity caches will ensure that all changes from the database will be captured; relying on the fault-in mechanism or RowSet.executeQuery might miss some of the changes.

The value of the Application Module's isClearCacheOnRollback() flag will be used if the client has not set this flag in the Transaction. At the end of transaction, the transaction checks the value of its isClearCacheOnRollback flag and either clears the Entity Object caches or not. However, if the client never called setClearCacheOnRollback on this transaction, the framework will use the value for the root Application Module's definition object.

In contrast, if the client called oracle.jbo.Transaction.setClearCacheOnRollback on the Transaction, then the value of the root Application Module Def's isClearCacheOnRollback is not used.

For middle-tier applications, you can use isClearCacheOnCommit and setClearCacheOnCommit in the DBTransactionImpl class.

Note that clearing the Entity Object caches has performance ramifications: repopulating the caches is expensive in terms of time and processing effort.

Tags copied from interface: Transaction

Returns:

true indicates that the Entity Object caches will be cleared on rollback, and will be refreshed with new data from the database.

See Also:

RowSet.executeQuery(), Transaction.setClearCacheOnRollback(boolean val), DBTransactionImpl.setClearCacheOnRollback(boolean val), DBTransactionImpl.isClearCacheOnRollback()

setClearCacheOnRollback

public void setClearCacheOnRollback(boolean val)

Description copied from interface: Transaction

Indicates whether all Entity Object caches will be cleared after the transaction is rolled back. For more information on this topic, see isClearCacheOnRollback

Tags copied from interface: Transaction

Parameters:

val - true indicates that the Entity Object caches will be cleared on rollback, and will be refreshed with new data from the database.

See Also:

Transaction.isClearCacheOnRollback()

createRef

public java.lang.Object createRef(java.lang.String structName,
                                  byte[] data)

Description copied from interface: Transaction

Internal: Applications should not use this method.

clearEntityCache

public void clearEntityCache(java.lang.String entityName)

Description copied from interface: Transaction

Clears the cache of the specified Entity Object. A value of null clears the caches of all Entities. If a View Object uses the Entity Object, the View Object's cache will be cleared as well.

Tags copied from interface: Transaction

Parameters:

entityName - the name of the entity whose cache is to be cleared. If null, caches for all entities are cleared.

reconnect

public void reconnect()

Reconnect the application module to the database, if necessary, using previously supplied database credentials.

Specified by:

reconnect in interface DBTransaction

disconnect

public void disconnect(boolean retainState)

Closes the JDBC connection object and removes this transaction from the root application module. Retains the ApplicationModule state wrt cache as is.

All ViewObjects should have fetched all their data or be in forwardonly mode before this method is invoked with retainState = true

In the middle-tier, you can also use the disconnect method on the DBTransactionImpl interface.

Specified by:

disconnect in interface DBTransaction