oracle.jbo.server

Class NullDBTransactionImpl

java.lang.Object

oracle.jbo.server.NullDBTransactionImpl

All Implemented Interfaces:

ExprWrappable, DBTransaction, ValidationManager, Transaction

Deprecated.

Since Jdeveloper 9.0.3. No replacement.

public class NullDBTransactionImpl
extends java.lang.Object
implements DBTransaction

Implementation of DBTransaction interface that represents a disconnected transaction. NullDBTransactionImpl objects are used internally by the framework to make the transition from a disconnected to connected state. Upon startup an application is in a non-transactional disconnected state. When a connect method is called the database connection is established and the transaction is started. This implementation of DBTransaction throws a NotConnectedException for most operations.

From 9.0.3 onwards, this class is no longer used to represent a disconnected transaction. The disconnected state, by default, is now represented by DBTransactionImpl2. Applications using custom DBTransactionImpl and/or NullDBTransactionImpl subclass(es) should now subclass DBTransactionImpl2 instead.

Applications requiring backward compatibility must set the jbo.server.useNullDbTransaction property to true in appmodule configuration, initial context environment, or as a System property to continue using this class.

See Also:

DatabaseTransactionFactory, DBTransactionImpl2

Field Summary

Fields

Modifier and Type	Field and Description
protected ConnectionCredentials	mConnectionCredentials Deprecated.

Fields inherited from interface oracle.jbo.server.DBTransaction

DEFAULT

Fields inherited from interface oracle.jbo.Transaction

DML_OPERATION_TIMEOUT_WAIT_FOREVER, LOCK_NONE, LOCK_OPTIMISTIC, LOCK_OPTUPDATE, LOCK_PESSIMISTIC

Constructor Summary

Constructors

Constructor and Description
NullDBTransactionImpl() Deprecated.

Method Summary

Modifier and Type	Method and Description
void	addToValidationListeners(ValidationListener w) Deprecated. Implementation of the DBTransaction interface.
void	addTransactionListener(TransactionListener listener) Deprecated. Implementation of the DBTransaction interface.
void	addTransactionListenerNoCheck(TransactionListener listener) Deprecated. Implementation of the DBTransaction interface.
void	addTransactionPostListener(TransactionPostListener listener) Deprecated. Implementation of the DBTransaction interface.
void	addTransactionPostListenerNoCheck(TransactionPostListener listener) Deprecated. Implementation of the DBTransaction interface.
void	addTransactionStateListener(TransactionStateListener tl) Deprecated. Implementation of the DBTransaction interface.
void	addViewClearCacheListener(ViewClearCacheListener tl) Deprecated.
void	addWarning(JboWarning warn) Deprecated. Implementation of the DBTransaction interface.
void	applyChangeSet(int id) Deprecated. Applies the changes committed by another transaction in order to synchronize caches between root Application Module instances.
boolean	cancelDMLOperations() Deprecated. Cancels the currently running Entity Object DML operations.
void	clearEntityCache(java.lang.String entityName) Deprecated. Clears the cache of the specified Entity Object.
void	closeTransaction() Deprecated. Implementation of the DBTransaction interface.
void	commit() Deprecated. Implementation of the DBTransaction interface.
int	commitAndSaveChangeSet() Deprecated. Commits the transaction and writes updated EntityImpls to the persistent store.
void	connect(java.sql.Connection sqlConnection) Deprecated.
void	connect(java.lang.String url) Deprecated. Implementation of the DBTransaction interface.
void	connect(java.lang.String url, java.util.Properties info) Deprecated. Implementation of the DBTransaction interface.
void	connect(java.lang.String url, java.lang.String user, java.lang.String password) Deprecated. Implementation of the DBTransaction interface.
void	connectToDataSource(javax.sql.DataSource ds, boolean isJTAbased) Deprecated.
void	connectToDataSource(javax.sql.DataSource ds, java.lang.String user, java.lang.String passwd, boolean isJTAbased) Deprecated.
void	connectToDataSource(java.util.Hashtable env, java.lang.String dsName, boolean isJTABased) Deprecated. Looks up a datasource from a jndi tree and acquires the jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection(String user, String passwd) method.
void	connectToDataSource(java.util.Hashtable env, java.lang.String dsName, java.lang.String user, java.lang.String passwd, boolean isJTABased) Deprecated. Looks up a datasource from a jndi tree and acquires the jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection(String user, String passwd) method.
void	connectToDataSource(java.lang.String nsUrl, java.lang.String nsUser, java.lang.String nsPasswd, java.lang.String dsUrl) Deprecated. Looks up a datasource from Oracle 8i namespace using the jdbc_access protocol and acquires the default jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection() method.
void	connectToDataSource(java.lang.String nsUrl, java.lang.String nsUser, java.lang.String nsPasswd, java.lang.String dsUrl, java.lang.String user, java.lang.String passwd) Deprecated. Looks up a datasource from Oracle 8i namespace using the jdbc_access protocol and acquires the jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection(String user, String password) method.
ApplicationModule	createApplicationModule(java.lang.String defName) Deprecated. Implementation of the DBTransaction interface.
ApplicationModule	createApplicationModule(java.lang.String amName, java.lang.String defName) Deprecated. Implementation of the DBTransaction interface.
java.sql.CallableStatement	createCallableStatement(java.lang.String str, int noRowsPrefetch) Deprecated. Implementation of the DBTransaction interface.
EntityImpl	createEntityInstance(EntityDefImpl entityDef, AttributeList al) Deprecated. Implementation of the DBTransaction interface.
EntityImpl	createEntityInstance(java.lang.String entityDefName, AttributeList al) Deprecated. Implementation of the DBTransaction interface.
java.sql.PreparedStatement	createPreparedStatement(java.lang.String str, int noRowsPrefetch) Deprecated. Implementation of the DBTransaction interface.
java.lang.Object	createRef(java.lang.String structName, byte[] data) Deprecated. Internal: Applications should not use this method.
java.sql.Statement	createStatement(int noRowsPrefetch) Deprecated. Implementation of the DBTransaction interface.
ViewLink	createViewLink(java.lang.String viewLinkDefName, ViewObject master, ViewObject detail) Deprecated. Implementation of the DBTransaction interface.
ViewLink	createViewLinkBetweenViewObjects(java.lang.String accessorName, ViewObject master, AttributeDef[] srcAttrs, ViewObject detail, AttributeDef[] destAttrs, java.lang.String assocClause) Deprecated. Implementation of the DBTransaction interface.
ViewLink	createViewLinkFromEntityAssocName(java.lang.String entityAssocName, ViewObject master, ViewObject detail) Deprecated. Implementation of the DBTransaction interface.
ViewObject	createViewObject(java.lang.String voDefName) Deprecated. 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) Deprecated. Implementation of the DBTransaction interface.
ViewObject	createViewObjectFromQueryStmt(java.lang.String sqlStatement) Deprecated. Implementation of the DBTransaction interface.
ViewObject	createViewObjectFromQueryStmt(java.lang.String sqlStatement, java.lang.String voImplClassName) Deprecated. Implementation of the DBTransaction interface.
void	disconnect() Deprecated. Implementation of the DBTransaction interface.
void	disconnect(boolean retainState) Deprecated. 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) Deprecated. Implementation of the DBTransaction interface.
int	executeCommand(java.lang.String command) Deprecated. Implementation of the DBTransaction interface.
ApplicationModule	findApplicationModule(java.lang.String amName) Deprecated. Implementation of the DBTransaction interface.
EntityImpl	findByPrimaryKey(EntityDefImpl entityDef, Key key) Deprecated. Implementation of the DBTransaction interface.
EntityImpl	findByPrimaryKey(java.lang.String entityDefName, Key key) Deprecated. Implementation of the DBTransaction interface.
ViewObject	findViewObject(java.lang.String voName) Deprecated. Implementation of the DBTransaction interface.
int	getBatchPostExceptionThreshold() Deprecated. Implementation of the DBTransaction interface.
ConnectionMetadata	getConnectionMetadata() Deprecated. Returns a metdata structure that describes the transaction's JDBC connection.
int	getDMLOperationTimeOut() Deprecated. Returns the current Entity Object DML operation time out value.
int	getLockingMode() Deprecated. Implementation of the DBTransaction interface.
int	getPostThreshold() Deprecated. Implementation of the DBTransaction interface.
ApplicationModule	getRootApplicationModule() Deprecated.
Session	getSession() Deprecated. Implementation of the DBTransaction interface.
SQLBuilder	getSQLBuilder() Deprecated.
TransactionHandler	getTransactionHandler() Deprecated. Internal: Applications should not use this method.
protected ApplicationModuleImpl	getTxnApplicationModuleImpl() Deprecated.
int	getValidationThreshold() Deprecated. Implementation of the DBTransaction interface.
boolean	isBundledExceptionMode() Deprecated. Implementation of the DBTransaction interface.
boolean	isClearCacheOnCommit() Deprecated. Returns the flag indicating whether all Entity Object caches will be cleared after the transaction is committed.
boolean	isClearCacheOnRollback() Deprecated. Returns the flag indicating whether all Entity Object caches will be cleared after the transaction is rolled back.
boolean	isConnected() Deprecated. Implementation of the DBTransaction interface.
boolean	isConnected(boolean pingDatabase) Deprecated.
boolean	isDirty() Deprecated. Implementation of the DBTransaction interface.
boolean	isLockOptimistic() Deprecated. Indicates whether the current locking mode is optimistic or not.
boolean	isTrackNewAndModifiedRowsOnly() Deprecated. Implementation of the DBTransaction interface.
void	postChanges() Deprecated. Implementation of the DBTransaction interface.
void	reconnect() Deprecated. Reconnect the application module to the database, if necessary, using previously supplied database credentials.
void	reconnect(boolean force) Deprecated. Implementation of the DBTransaction interface.
void	removeChangeSet(int id) Deprecated. Removes the change set that defines the changes to EntityImpls within a transaction.
void	removeTransactionListener(TransactionListener listener) Deprecated. Implementation of the DBTransaction interface.
void	removeTransactionPostListener(TransactionPostListener listener) Deprecated. Implementation of the DBTransaction interface.
void	removeTransactionStateListener(TransactionStateListener tl) Deprecated. Implementation of the DBTransaction interface.
void	removeViewClearCacheListener(ViewClearCacheListener tl) Deprecated.
void	rollback() Deprecated. Implementation of the DBTransaction interface.
void	setBatchPostExceptionThreshold(int count) Deprecated. Implementation of the DBTransaction interface.
void	setBundledExceptionMode(boolean flag) Deprecated. Implementation of the DBTransaction interface.
void	setClearCacheOnCommit(boolean val) Deprecated. Sets the value of the flag indicating whether all Entity Object caches will be cleared after the transaction is committed.
void	setClearCacheOnRollback(boolean val) Deprecated. Sets the value of the flag indicating whether all Entity Object caches will be cleared after the transaction is rolled back.
void	setDMLOperationTimeOut(int timeOutMills) Deprecated. Sets the query time out value for the Entity Object's DML operations.
void	setLockingMode(int mode) Deprecated. Implementation of the DBTransaction interface.
void	setPostThreshold(int count) Deprecated. Implementation of the DBTransaction interface.
void	setTrackNewAndModifiedRowsOnly(boolean flag) Deprecated. Implementation of the DBTransaction interface.
void	setTransactionHandler(TransactionHandler txnHandler) Deprecated. Internal: Applications should not use this method.
void	setValidationThreshold(int count) Deprecated. Implementation of the DBTransaction interface.
void	validate() Deprecated. 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

Deprecated.

Constructor Detail

NullDBTransactionImpl

public NullDBTransactionImpl()

Deprecated.

Method Detail

closeTransaction

public void closeTransaction()

Deprecated.

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

Deprecated.

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

Specified by:

commit in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

See Also:

TransactionListener.beforeCommit(TransactionEvent), TransactionListener.afterCommit(TransactionEvent), DBTransaction, Transaction.postChanges()

commitAndSaveChangeSet

public int commitAndSaveChangeSet()

Deprecated.

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);
 

Specified by:

commitAndSaveChangeSet in 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)

Deprecated.

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.

Specified by:

applyChangeSet in 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)

Deprecated.

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.

Specified by:

removeChangeSet in 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()

Deprecated.

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

Specified by:

rollback in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

See Also:

DBTransaction, TransactionListener.afterRollback(TransactionEvent), TransactionListener.beforeRollback(TransactionEvent)

postChanges

public void postChanges()

Deprecated.

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

Specified by:

postChanges in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

See Also:

Transaction.commit()

isDirty

public boolean isDirty()

Deprecated.

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

Specified by:

isDirty in interface Transaction

Returns:

true if the local data and the database differ.

Throws:

NotConnectedConnection - Always thrown.

setPostThreshold

public void setPostThreshold(int count)

Deprecated.

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

Specified by:

setPostThreshold in interface DBTransaction

Parameters:

count - the new threshold value.

Throws:

NotConnectedConnection - Always thrown.

getPostThreshold

public int getPostThreshold()

Deprecated.

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)

Deprecated.

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

Specified by:

setValidationThreshold in interface DBTransaction

Parameters:

count - the new threshold value.

Throws:

NotConnectedConnection - Always thrown.

getValidationThreshold

public int getValidationThreshold()

Deprecated.

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)

Deprecated.

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

Specified by:

addTransactionListener in interface DBTransaction

Parameters:

listener - the subscriber to be added.

Throws:

NotConnectedConnection - Always thrown.

addTransactionListenerNoCheck

public void addTransactionListenerNoCheck(TransactionListener listener)

Deprecated.

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

Specified by:

addTransactionListenerNoCheck in interface DBTransaction

Parameters:

listener - the subscriber to be added.

Throws:

NotConnectedConnection - Always thrown.

removeTransactionListener

public void removeTransactionListener(TransactionListener listener)

Deprecated.

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

Specified by:

removeTransactionListener in interface DBTransaction

Parameters:

listener - the subscriber to be removed.

Throws:

NotConnectedConnection - Always thrown.

addTransactionPostListener

public void addTransactionPostListener(TransactionPostListener listener)

Deprecated.

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

Specified by:

addTransactionPostListener in interface DBTransaction

Parameters:

listener - the subscriber to be added.

Throws:

NotConnectedConnection - Always thrown.

addTransactionPostListenerNoCheck

public void addTransactionPostListenerNoCheck(TransactionPostListener listener)

Deprecated.

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

Specified by:

addTransactionPostListenerNoCheck in interface DBTransaction

Parameters:

listener - the subscriber to be added.

Throws:

NotConnectedConnection - Always thrown.

removeTransactionPostListener

public void removeTransactionPostListener(TransactionPostListener listener)

Deprecated.

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)

Deprecated.

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

Specified by:

createStatement in interface DBTransaction

Parameters:

noRowsPrefetch - the number of rows to prefetch when executing this statement's query.

Returns:

a JDBC Statement instance.

Throws:

NotConnectedConnection - Always thrown.

createCallableStatement

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

Deprecated.

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

Specified by:

createCallableStatement in interface DBTransaction

Parameters:

str - the CallableStatement instance's SQL statement.

noRowsPrefetch - the number of rows to prefetch when executing this statement's query. If this parameter is set to DBTransaction.DEFAULT, then the default value from the jdbc driver is used.

Returns:

a JDBC CallableStatement instance.

Throws:

NotConnectedConnection - Always thrown.

createPreparedStatement

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

Deprecated.

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

Specified by:

createPreparedStatement in interface DBTransaction

Parameters:

str - the PreparedStatement instance's SQL statement.

noRowsPrefetch - the number of rows to prefetch when executing this statement's query. If this parameter is set to DBTransaction.DEFAULT, then the default value from the jdbc driver is used.

Returns:

a JDBC PreparedStatement instance.

Throws:

NotConnectedConnection - Always thrown.

executeCommand

public int executeCommand(java.lang.String command)

Deprecated.

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

Specified by:

executeCommand in interface Transaction

Parameters:

command - a valid SQL statement.

Returns:

the number of rows affected.

Throws:

NotConnectedConnection - Always thrown.

dumpQueryResult

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

Deprecated.

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

Specified by:

dumpQueryResult in interface Transaction

Parameters:

query - the SQL query statement.

dumpClassName - the class that dumps the result to a string.

data - an array of data items.

Throws:

NotConnectedConnection - Always thrown.

validate

public void validate()

Deprecated.

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

Specified by:

validate in interface ValidationManager

Specified by:

validate in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

addToValidationListeners

public void addToValidationListeners(ValidationListener w)

Deprecated.

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

Specified by:

addToValidationListeners in interface ValidationManager

Parameters:

w - a validation listener.

Throws:

NotConnectedConnection - Always thrown.

connect

public void connect(java.sql.Connection sqlConnection)

Deprecated.

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

Since:

5.0

See Also:

DBTransaction.connect(Connection), DatabaseTransactionFactory

connect

public void connect(java.lang.String url)

Deprecated.

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

Specified by:

connect in interface Transaction

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)

Deprecated.

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

Specified by:

connect in interface Transaction

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)

Deprecated.

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

Specified by:

connect in interface Transaction

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

Deprecated.

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

Specified by:

disconnect in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

isConnected

public boolean isConnected()

Deprecated.

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

Specified by:

isConnected in interface Transaction

Returns:

Always returns false.

reconnect

public void reconnect(boolean force)

Deprecated.

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

Specified by:

reconnect in interface Transaction

Parameters:

force - force a reconnect, should usually be false.

Throws:

NotConnectedConnection - Always thrown.

setLockingMode

public void setLockingMode(int mode)

Deprecated.

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

Specified by:

setLockingMode in interface Transaction

Parameters:

mode - one of LOCK_PESSIMISTIC, LOCK_OPTIMISTIC or LOCK_NONE.

Throws:

NotConnectedConnection - Always thrown.

getLockingMode

public int getLockingMode()

Deprecated.

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

Specified by:

getLockingMode in interface Transaction

Returns:

an integer representing the preferred locking mode. The values can be LOCK_NONE, LOCK_PESSIMISTIC (default), or LOCK_OPTIMISTIC.

Throws:

NotConnectedConnection - Always thrown.

isLockOptimistic

public boolean isLockOptimistic()

Deprecated.

Description copied from interface: DBTransaction

Indicates whether the current locking mode is optimistic or not.

Specified by:

isLockOptimistic in interface DBTransaction

Returns:

true if the locking mode is LOCK_OPTIMISTIC or LOCK_OPTUPDATE.

getTransactionHandler

public TransactionHandler getTransactionHandler()

Deprecated.

Description copied from interface: DBTransaction

Internal: Applications should not use this method.

Specified by:

getTransactionHandler in interface DBTransaction

setTransactionHandler

public void setTransactionHandler(TransactionHandler txnHandler)

Deprecated.

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)

Deprecated.

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

Specified by:

createEntityInstance in interface DBTransaction

Parameters:

entityDef - the defintion to to be used to create the instance.

al - an attribute list to be passed to the new instance's create() method.

Returns:

the new EntityImpl instance.

Throws:

NotConnectedConnection - Always thrown.

createEntityInstance

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

Deprecated.

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

Specified by:

createEntityInstance in interface DBTransaction

Parameters:

entityDefName - the name of the defintion to to be used to create the instance.

al - an attribute list to be passed to the new instance's create() method.

Returns:

the new EntityImpl instance.

Throws:

NotConnectedConnection - Always thrown.

findByPrimaryKey

public EntityImpl findByPrimaryKey(EntityDefImpl entityDef,
                                   Key key)

Deprecated.

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

Specified by:

findByPrimaryKey in interface DBTransaction

Parameters:

entityDef - the defintion to to be used to find the instance.

key - the Primary Key.

Returns:

the Entity Object matching Key, or null if not found.

Throws:

NotConnectedConnection - Always thrown.

findByPrimaryKey

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

Deprecated.

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

Specified by:

findByPrimaryKey in interface DBTransaction

Parameters:

entityDefName - the name of the defintion to to be used to find the instance.

key - the Primary Key.

Returns:

the Entity Object matching Key, or null if not found.

Throws:

NotConnectedConnection - Always thrown.

createApplicationModule

public ApplicationModule createApplicationModule(java.lang.String amName,
                                                 java.lang.String defName)

Deprecated.

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

Specified by:

createApplicationModule in interface DBTransaction

Parameters:

amName - the name to be given to the Application Module. If amName is empty, a name is generated.

defName - the name of the Application Module definition to be used. If null a default definition is used.

Returns:

a new Application Module.

Throws:

NotConnectedConnection - Always thrown.

findApplicationModule

public ApplicationModule findApplicationModule(java.lang.String amName)

Deprecated.

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

Specified by:

findApplicationModule in interface DBTransaction

Parameters:

amName - the name of the Application Module.

Returns:

the Application Module.

Throws:

NotConnectedConnection - Always thrown.

createViewObject

public ViewObject createViewObject(java.lang.String voDefName)

Deprecated.

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

Specified by:

createViewObject in interface DBTransaction

Parameters:

voDefName - the name of the defintion to to be used to create the instance.

Returns:

the new ViewObject instance.

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)

Deprecated.

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

Specified by:

createViewObjectFromQueryClauses in interface DBTransaction

Parameters:

eoName - the name of a EntityObject beaninfo class.

selectClause - an SQL statement SELECT clause.

fromClause - an SQL statement FROM clause.

whereClause - an SQL statement WHERE clause.

orderByClause - an SQL statement ORDERBY clause.

Throws:

NotConnectedConnection - Always thrown.

createViewObjectFromQueryStmt

public ViewObject createViewObjectFromQueryStmt(java.lang.String sqlStatement)

Deprecated.

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

Specified by:

createViewObjectFromQueryStmt in interface DBTransaction

Parameters:

sqlStatement - a SQL statement.

Throws:

NotConnectedConnection - Always thrown.

createViewObjectFromQueryStmt

public ViewObject createViewObjectFromQueryStmt(java.lang.String sqlStatement,
                                                java.lang.String voImplClassName)

Deprecated.

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

Specified by:

createViewObjectFromQueryStmt in interface DBTransaction

Parameters:

sqlStatement - a SQL statement.

voImplClassName - a class name that is a subclass of the oracle.jbo.server.ViewObjectImpl framework class.

Returns:

the ViewObject instance of the Class name passed as the argument

Throws:

NotConnectedConnection - Always thrown.

findViewObject

public ViewObject findViewObject(java.lang.String voName)

Deprecated.

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

Specified by:

findViewObject in interface DBTransaction

Parameters:

voName - the name of the view object.

Returns:

the view object. null if the view object is not found.

Throws:

NotConnectedConnection - Always thrown.

createApplicationModule

public ApplicationModule createApplicationModule(java.lang.String defName)

Deprecated.

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

Specified by:

createApplicationModule in interface DBTransaction

Parameters:

defName - the name of the Application Module definition to be used. If null a default definition is used.

Returns:

a new Application Module.

Throws:

NotConnectedConnection - Always thrown.

createViewLink

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

Deprecated.

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

Specified by:

createViewLink in interface DBTransaction

Parameters:

viewLinkDefName - the name of the definition to be used to create the link. If empty a default definition will be used.

master - the link's source.

detail - the link's destination.

Throws:

NotConnectedConnection - Always thrown.

createViewLinkFromEntityAssocName

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

Deprecated.

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

Specified by:

createViewLinkFromEntityAssocName in interface DBTransaction

Parameters:

entityAssocName - the entity association that the View Link will represent.

master - the link's source.

detail - the link's destination.

Throws:

NotConnectedConnection - Always thrown.

createViewLinkBetweenViewObjects

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

Deprecated.

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

Specified by:

createViewLinkBetweenViewObjects in interface DBTransaction

Parameters:

accessorName - the name to be given to the View Link's accessor.

master - the link's source.

srcAttrs - link attributes taken from the master View Object.

detail - the link's destination.

destAttrs - link attributes taken from the detail View Object.

Throws:

NotConnectedConnection - Always thrown.

addWarning

public void addWarning(JboWarning warn)

Deprecated.

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

Specified by:

addWarning in interface DBTransaction

Parameters:

warn - a warning message.

Throws:

NotConnectedConnection - Always thrown.

getSession

public Session getSession()

Deprecated.

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

Specified by:

getSession in interface DBTransaction

Returns:

the session.

Throws:

NotConnectedConnection - Always thrown.

getSQLBuilder

public SQLBuilder getSQLBuilder()

Deprecated.

Specified by:

getSQLBuilder in interface DBTransaction

getConnectionMetadata

public ConnectionMetadata getConnectionMetadata()

Deprecated.

Description copied from interface: Transaction

Returns a metdata structure that describes the transaction's JDBC connection.

Specified by:

getConnectionMetadata in interface Transaction

isClearCacheOnCommit

public boolean isClearCacheOnCommit()

Deprecated.

Description copied from interface: Transaction

Returns the flag indicating whether all Entity Object caches will be cleared after the transaction is committed.

After the transaction is committed, the value of this flag is used to determine whether the Entity Object caches are cleared or not. If this flag value is false, the cache contents are kept. In this case, the cache may contain data that is stale in that it does not match the newest data (changes made by another user and committed).

If this flag is true, the caches are cleared after the transaction is committed. When the user brings in data by traversing row collection, the latest data from the database will be brought into Entity caches.

Specified by:

isClearCacheOnCommit in interface Transaction

Returns:

the current value of clear-cache-on-commit flag.

See Also:

RowSet.executeQuery(), Transaction.setClearCacheOnCommit(boolean)

setClearCacheOnCommit

public void setClearCacheOnCommit(boolean val)

Deprecated.

Description copied from interface: Transaction

Sets the value of the flag indicating whether all Entity Object caches will be cleared after the transaction is committed.

The initial value of this flag is retrieved from the Application Module definition of the root Application Module (an XML attribute value named "ClearCacheOnCommit" in the Application Module definition's XML file). If the Application Module definition does not contain the initial value, the default value is false, i.e., the caches are kept after commit.

The user can override the value of this flag for this Transaction by calling this method. Calling this method does not affect the initial value in the Application Module definition.

Specified by:

setClearCacheOnCommit in interface Transaction

Parameters:

val - the new value of the clear-cache-on-commit flag. true indicates that the Entity Object caches will be cleared after commit.

See Also:

Transaction.isClearCacheOnCommit()

isClearCacheOnRollback

public boolean isClearCacheOnRollback()

Deprecated.

Description copied from interface: Transaction

Returns the flag indicating whether all Entity Object caches will be cleared after the transaction is rolled back.

After the transaction is rolled back, the value of this flag is used to determine whether the Entity Object caches are cleared or not. If this flag value is false, the cache contents are kept. In this case, the cache may contain data that is not in sync with database in that uncommitted changes made this by user (before the transaction was rolled back) will be kept.

If this flag is true, the caches are cleared after the transaction is rolled back. When the user brings in data by traversing row collection, the latest data from the database will be brought into Entity caches.

Specified by:

isClearCacheOnRollback in interface Transaction

Returns:

the current value of clear-cache-on-roll-back flag.

See Also:

RowSet.executeQuery(), Transaction.setClearCacheOnRollback(boolean)

setClearCacheOnRollback

public void setClearCacheOnRollback(boolean val)

Deprecated.

Description copied from interface: Transaction

Sets the value of the flag indicating whether all Entity Object caches will be cleared after the transaction is rolled back.

The initial value of this flag is retrieved from the Application Module definition of the root Application Module (an XML attribute value named "ClearCacheOnRollback" in the Application Module definition's XML file). If the Application Module definition does not contain the initial value, the default value is true, i.e., the caches are cleared after rollback.

The user can override the value of this flag for this Transaction by calling this method. Calling this method does not affect the initial value in the Application Module definition.

Specified by:

setClearCacheOnRollback in interface Transaction

Parameters:

val - the new value of the clear-cache-on-roll-back flag. true indicates that the Entity Object caches will be cleared after 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)

Deprecated.

Description copied from interface: Transaction

Internal: Applications should not use this method.

Specified by:

createRef in interface Transaction

clearEntityCache

public void clearEntityCache(java.lang.String entityName)

Deprecated.

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.

Specified by:

clearEntityCache in 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()

Deprecated.

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

Specified by:

reconnect in interface DBTransaction

Specified by:

reconnect in interface Transaction

disconnect

public void disconnect(boolean retainState)

Deprecated.

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

Specified by:

disconnect in interface Transaction

connectToDataSource

public void connectToDataSource(java.lang.String nsUrl,
                                java.lang.String nsUser,
                                java.lang.String nsPasswd,
                                java.lang.String dsUrl)

Deprecated.

Description copied from interface: Transaction

Looks up a datasource from Oracle 8i namespace using the jdbc_access protocol and acquires the default jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection() method.

Specified by:

connectToDataSource in interface Transaction

Parameters:

nsUrl - Url to the jndi namespace where the datasource is bound

nsUser - User name that is used to access the namespace.

nsPasswd - nsUsers' passwd

dsUrl - Datasource name as bound in the namespace. Name can be the fully qaultified url such as jdbc_access://test/ds/db1 otherwise the the url prefix jdbc_acess:// is prepended to the datasource name for lookup.

connectToDataSource

public void connectToDataSource(java.lang.String nsUrl,
                                java.lang.String nsUser,
                                java.lang.String nsPasswd,
                                java.lang.String dsUrl,
                                java.lang.String user,
                                java.lang.String passwd)

Deprecated.

Description copied from interface: Transaction

Looks up a datasource from Oracle 8i namespace using the jdbc_access protocol and acquires the jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection(String user, String password) method.

Specified by:

connectToDataSource in interface Transaction

Parameters:

nsUrl - Url to the jndi namespace where the datasource is bound

nsUser - User name that is used to access the namespace.

nsPasswd - nsUsers' passwd

dsUrl - Datasource name as bound in the namespace. Name can be the fully qaultified url such as jdbc_access://test/ds/db1 otherwise the the url prefix jdbc_acess:// is prepended to the datasource name for lookup.

user - Username for which the connection is acquired from the datasource

passwd - User's password.

connectToDataSource

public void connectToDataSource(javax.sql.DataSource ds,
                                boolean isJTAbased)

Deprecated.

Specified by:

connectToDataSource in interface DBTransaction

connectToDataSource

public void connectToDataSource(javax.sql.DataSource ds,
                                java.lang.String user,
                                java.lang.String passwd,
                                boolean isJTAbased)

Deprecated.

Specified by:

connectToDataSource in interface DBTransaction

connectToDataSource

public void connectToDataSource(java.util.Hashtable env,
                                java.lang.String dsName,
                                java.lang.String user,
                                java.lang.String passwd,
                                boolean isJTABased)

Deprecated.

Description copied from interface: Transaction

Looks up a datasource from a jndi tree and acquires the jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection(String user, String passwd) method.

Specified by:

connectToDataSource in interface Transaction

Parameters:

env - Envirionment used the create initial context. May be null.

dsName - Datasource name as bound in the namespace.

user - Username for which the connection is acquired from the datasource

passwd - User's password.

isJTABased - True if datasource is XADataSource implementation. If true, the tranasction is assumed to be controlled by an external transaction manager.

connectToDataSource

public void connectToDataSource(java.util.Hashtable env,
                                java.lang.String dsName,
                                boolean isJTABased)

Deprecated.

Description copied from interface: Transaction

Looks up a datasource from a jndi tree and acquires the jdbc connection from the looked up datasource using the javax.sql.Datasource.getConnection(String user, String passwd) method.

Specified by:

connectToDataSource in interface Transaction

Parameters:

env - Envirionment used the create initial context. May be null.

dsName - Datasource name as bound in the namespace.

isJTABased - True if datasource is XADataSource implementation. If true, the tranasction is assumed to be controlled by an external transaction manager.

setBundledExceptionMode

public void setBundledExceptionMode(boolean flag)

Deprecated.

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

Specified by:

setBundledExceptionMode in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

isBundledExceptionMode

public final boolean isBundledExceptionMode()

Deprecated.

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

Specified by:

isBundledExceptionMode in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

getTxnApplicationModuleImpl

protected ApplicationModuleImpl getTxnApplicationModuleImpl()

Deprecated.

getRootApplicationModule

public ApplicationModule getRootApplicationModule()

Deprecated.

Specified by:

getRootApplicationModule in interface DBTransaction

addTransactionStateListener

public void addTransactionStateListener(TransactionStateListener tl)

Deprecated.

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

Specified by:

addTransactionStateListener in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

removeTransactionStateListener

public void removeTransactionStateListener(TransactionStateListener tl)

Deprecated.

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

Specified by:

removeTransactionStateListener in interface Transaction

Throws:

NotConnectedConnection - Always thrown.

addViewClearCacheListener

public void addViewClearCacheListener(ViewClearCacheListener tl)

Deprecated.

Specified by:

addViewClearCacheListener in interface Transaction

removeViewClearCacheListener

public void removeViewClearCacheListener(ViewClearCacheListener tl)

Deprecated.

Specified by:

removeViewClearCacheListener in interface Transaction

setTrackNewAndModifiedRowsOnly

public void setTrackNewAndModifiedRowsOnly(boolean flag)

Deprecated.

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

Specified by:

setTrackNewAndModifiedRowsOnly in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

isTrackNewAndModifiedRowsOnly

public boolean isTrackNewAndModifiedRowsOnly()

Deprecated.

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

Specified by:

isTrackNewAndModifiedRowsOnly in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

getBatchPostExceptionThreshold

public int getBatchPostExceptionThreshold()

Deprecated.

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

Specified by:

getBatchPostExceptionThreshold in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

See Also:

DBTransaction.setBatchPostExceptionThreshold(int)

setBatchPostExceptionThreshold

public void setBatchPostExceptionThreshold(int count)

Deprecated.

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

Specified by:

setBatchPostExceptionThreshold in interface DBTransaction

Throws:

NotConnectedConnection - Always thrown.

isConnected

public boolean isConnected(boolean pingDatabase)

Deprecated.

Specified by:

isConnected in interface DBTransaction

getDMLOperationTimeOut

public int getDMLOperationTimeOut()

Deprecated.

Description copied from interface: Transaction

Returns the current Entity Object DML operation time out value. The default is DML_OPERATION_TIMEOUT_WAIT_FOREVER.

Specified by:

getDMLOperationTimeOut in interface Transaction

Returns:

the current Entity Object DML operation time out value.

setDMLOperationTimeOut

public void setDMLOperationTimeOut(int timeOutMills)

Deprecated.

Description copied from interface: Transaction

Sets the query time out value for the Entity Object's DML operations. The default is DML_OPERATION_TIMEOUT_WAIT_FOREVER (-1), which means that the DML operations will not time out. The user will be able to cancel the long running operations by calling cancelDMLOperations() started by this Transaction during postChanges.

If a positive value of timeout is specified the operation is monitored by a global monitor thread. The monitor thread waits the specified amount of time (approximately) in milli-seconds, and cancels the operation by calling JDBC's Statement.cancel().

Specified by:

setDMLOperationTimeOut in interface Transaction

Parameters:

timeOutMills - if non-negative, number of milli-seconds before the DML operation is timed out.

cancelDMLOperations

public boolean cancelDMLOperations()

Deprecated.

Description copied from interface: Transaction

Cancels the currently running Entity Object DML operations.

Specified by:

cancelDMLOperations in interface Transaction

Returns:

A false is returned if a DML cancel fails.