Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1)

E10653-03


oracle.jbo.server
Class NullDBTransactionImpl

java.lang.Object
  extended by oracle.jbo.server.NullDBTransactionImpl

All Implemented Interfaces:
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
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
NullDBTransactionImpl()
          Deprecated.  

 

Method Summary
 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.

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1)

E10653-03


Copyright © 1997, 2009, Oracle. All rights reserved.