Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

oracle.jbo.server
Class DBTransactionImpl2

java.lang.Object
  extended byoracle.jbo.server.DBTransactionImpl
      extended byoracle.jbo.server.DBTransactionImpl2
All Implemented Interfaces:
DBTransaction, oracle.jbo.pcoll.PCollManagerHelper, Transaction, oracle.jbo.server.TransactionManager, ValidationManager

public class DBTransactionImpl2
extends DBTransactionImpl

Implementation of DBTransaction interface for representing both "connected" and "not connected" state. In pre 9.0.3 versions the disconnected and connected state implementation was provided by NullDBTransactionImpl and DBTransactionImpl respectivey. DBTransactionImpl instance was created only when clients initiated the acquisition of a jdbc connection by calling the one of Transaction.connect() or Transaction.connectToDataSource() methods.

Beginning from 9.0.3 Creation of root application module results in creation DBTransactionImpl2 instance in disconnected state. Later when clients request acquistion of jdbc connection this instance migrates from disconnected to connected state.

Since:
JDeveloper 9.0.3
See Also:
DatabaseTransactionFactory

Field Summary
 
Fields inherited from class oracle.jbo.server.DBTransactionImpl
MAX_CURSORS_UNINITIALIZED, mConnectionCredentials, mInternalCredentials, mSQLBuilder, mTxnListeners, POST_ABORT_ON_FIRST_EXCEPTION, POST_ALL_NO_RESET_ON_EXCEPTION, POST_ALL_RESET_ON_EXCEPTION
 
Fields inherited from interface oracle.jbo.server.DBTransaction
DEFAULT
 
Fields inherited from interface oracle.jbo.Transaction
LOCK_NONE, LOCK_OPTIMISTIC, LOCK_OPTUPDATE, LOCK_PESSIMISTIC
 
Constructor Summary
DBTransactionImpl2()
           
 
Method Summary
 void connect(java.sql.Connection sqlConnection)
          Implementation of connect method.
 void connect(java.lang.String url)
          Implementation of connect method.
 void connect(java.lang.String url, java.util.Properties info)
          Implementation of connect method.
 void connect(java.lang.String url, java.lang.String user, java.lang.String password)
          Implementation of connect method.
 void connectToDataSource(javax.sql.DataSource ds, boolean isJTAbased)
          Implementation of connectToDataSource method.
 void connectToDataSource(javax.sql.DataSource ds, java.lang.String user, java.lang.String passwd, boolean isJTAbased)
          Implementation of connectToDataSource method.
 void connectToDataSource(java.util.Hashtable env, java.lang.String dsName, boolean isJTABased)
          Implementation of connectToDataSource method.
 void connectToDataSource(java.util.Hashtable env, java.lang.String dsName, java.lang.String user, java.lang.String passwd, boolean isJTABased)
          Implementation of connectToDataSource method.
 void connectToDataSource(java.lang.String nsUrl, java.lang.String nsUser, java.lang.String nsPasswd, java.lang.String dsUrl)
          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)
          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.
 java.sql.CallableStatement createCallableStatement(java.lang.String str, int noRowsPrefetch)
          Implementation of createCallableStatement method.
 EntityImpl createEntityInstance(EntityDefImpl entityDef, AttributeList al)
          Implementation of createEntityInstance method.
 EntityImpl createEntityInstance(java.lang.String entityDefName, AttributeList al)
          Implementation of createEntityInstance method.
 java.sql.PreparedStatement createPreparedStatement(java.lang.String str, int noRowsPrefetch)
          Implementation of createPreparedStatement method.
 java.lang.Object createRef(java.lang.String structName, byte[] data)
          Checks to see if jdbc connection was acquired.
 java.sql.Statement createStatement(int noRowsPrefetch)
          Implementation of createStatement method.
 ViewObject createViewObjectFromQueryClauses(java.lang.String eoName, java.lang.String selectClause, java.lang.String fromClause, java.lang.String whereClause, java.lang.String orderByClause)
          Implementation of createViewObjectFromQueryClauses method.
 ViewObject createViewObjectFromQueryStmt(java.lang.String sqlStatement)
          Implementation of createViewObjectFromQueryStmt method.
 void disconnect(boolean retainState)
          Implementation of disconnect method.
 EntityImpl findByPrimaryKey(EntityDefImpl entityDef, Key key)
          Implementation of findByPrimaryKey method.
 EntityImpl findByPrimaryKey(java.lang.String entityDefName, Key key)
          Implementation of findByPrimaryKey method.
 java.sql.Timestamp getCurrentDbTime()
          Checks to see if jdbc connection was acquired.
 void reconnect()
          Implementation of recconnect method.
 void reconnect(boolean force)
          Implementation of reconnect method.
 
Methods inherited from class oracle.jbo.server.DBTransactionImpl
addToValidationListeners, addTransactionListener, addTransactionListenerNoCheck, addTransactionPostListener, addTransactionPostListenerNoCheck, addTransactionStateListener, addViewClearCacheListener, addWarning, applyChangeSet, checkConnected, clearEntityCache, closeTransaction, commit, commitAndSaveChangeSet, createApplicationModule, createApplicationModule, createViewLink, createViewLinkBetweenViewObjects, createViewLinkFromEntityAssocName, createViewObject, disconnect, doCommit, doRollback, dumpEntityCaches, dumpQueryResult, executeCommand, findApplicationModule, findEntityCache, getBatchPostExceptionThreshold, getConnectionMetadata, getEntityCache, getJdbcConnection, getLockingMode, getPersistManagerConnection, getPostChangesFlag, getPostThreshold, getRootApplicationModule, getSession, getSQLBuilder, getSyncLock, getTransactionHandler, getTransactionState, getTxnApplicationModuleImpl, getValidationThreshold, hasRollbackSavePoint, isBundledExceptionMode, isClearCacheOnCommit, isClearCacheOnRollback, isConnected, isConnected, isDirty, isLockOptimistic, isTrackNewAndModifiedRowsOnly, postChanges, postChanges, removeChangeSet, removeTransactionListener, removeTransactionPostListener, removeTransactionStateListener, removeViewClearCacheListener, rollback, setBatchModeForEntity, setBatchPostExceptionThreshold, setBundledExceptionMode, setClearCacheOnCommit, setClearCacheOnRollback, setLockingMode, setPostChangesFlag, setPostThreshold, setTrackNewAndModifiedRowsOnly, setTransactionHandler, setValidationThreshold, showCursorUsage, validate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DBTransactionImpl2

public DBTransactionImpl2()
Method Detail

connect

public void connect(java.sql.Connection sqlConnection)
Implementation of connect method.

Specified by:
connect in interface DBTransaction
Overrides:
connect in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connect

public void connect(java.lang.String url)
Implementation of connect method.

Specified by:
connect in interface Transaction
Overrides:
connect in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connect

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

Specified by:
connect in interface Transaction
Overrides:
connect in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connect

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

Specified by:
connect in interface Transaction
Overrides:
connect in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connectToDataSource

public void connectToDataSource(java.lang.String nsUrl,
                                java.lang.String nsUser,
                                java.lang.String nsPasswd,
                                java.lang.String dsUrl)
Deprecated. Since Jdeveloper 9.0.2

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
Overrides:
connectToDataSource in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.
java.lang.UnSupportedOperationException - if not connected.

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. Since Jdeveloper 9.0.2

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
Overrides:
connectToDataSource in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.
java.lang.UnSupportedOperationException - if not connected.

connectToDataSource

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

Specified by:
connectToDataSource in interface DBTransaction
Overrides:
connectToDataSource in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connectToDataSource

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

Specified by:
connectToDataSource in interface DBTransaction
Overrides:
connectToDataSource in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connectToDataSource

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

Specified by:
connectToDataSource in interface Transaction
Overrides:
connectToDataSource in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

connectToDataSource

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

Specified by:
connectToDataSource in interface Transaction
Overrides:
connectToDataSource in class DBTransactionImpl
Throws:
AlreadyConnectedException - if the jdbc connection has already been acquired.

disconnect

public void disconnect(boolean retainState)
Implementation of disconnect method.

Specified by:
disconnect in interface DBTransaction
Overrides:
disconnect in class DBTransactionImpl

reconnect

public void reconnect()
Implementation of recconnect method.

Specified by:
reconnect in interface DBTransaction
Overrides:
reconnect in class DBTransactionImpl
See Also:
DBTransactionImpl.disconnect(boolean)

reconnect

public void reconnect(boolean force)
Implementation of reconnect method.

Specified by:
reconnect in interface Transaction
Overrides:
reconnect in class DBTransactionImpl
Parameters:
force - force a reconnect, should usually be false.

createStatement

public java.sql.Statement createStatement(int noRowsPrefetch)
Implementation of createStatement method.

Specified by:
createStatement in interface DBTransaction
Overrides:
createStatement in class DBTransactionImpl
Throws:
NotConnectedException - if no jdbc connection was acquired

createCallableStatement

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

Specified by:
createCallableStatement in interface DBTransaction
Overrides:
createCallableStatement in class DBTransactionImpl
Throws:
NotConnectedException - if no jdbc connection was acquired

createPreparedStatement

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

Specified by:
createPreparedStatement in interface DBTransaction
Overrides:
createPreparedStatement in class DBTransactionImpl
Throws:
NotConnectedException - if no jdbc connection was acquired

createEntityInstance

public EntityImpl createEntityInstance(EntityDefImpl entityDef,
                                       AttributeList al)
Implementation of createEntityInstance method.

Specified by:
createEntityInstance in interface DBTransaction
Overrides:
createEntityInstance in class DBTransactionImpl
Parameters:
entityDef - the EntityDef defintion to use to create the EntityImpl.
al - attribute list to pass to the create() method on the EntityImpl.
Throws:
NotConnectedException - if no jdbc connection was acquired

createEntityInstance

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

Specified by:
createEntityInstance in interface DBTransaction
Overrides:
createEntityInstance in class DBTransactionImpl
Parameters:
entityDefName - the String name of entity defintion to use to create the EntityImpl.
al - attribute list to pass to the create method on the EntityImpl.
Throws:
NotConnectedException - if no jdbc connection was acquired

findByPrimaryKey

public EntityImpl findByPrimaryKey(EntityDefImpl entityDef,
                                   Key key)
Implementation of findByPrimaryKey method.

Specified by:
findByPrimaryKey in interface DBTransaction
Overrides:
findByPrimaryKey in class DBTransactionImpl
Parameters:
entityDef - the Entity Def object to to be used to find the instance.
key - the Primary Key.
Returns:
the Entity Object matching Key, or null if not found.
Throws:
NotConnectedException - if no jdbc connection was acquired

findByPrimaryKey

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

Specified by:
findByPrimaryKey in interface DBTransaction
Overrides:
findByPrimaryKey in class DBTransactionImpl
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:
NotConnectedException - if no jdbc connection was acquired

createViewObjectFromQueryClauses

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

Specified by:
createViewObjectFromQueryClauses in interface DBTransaction
Overrides:
createViewObjectFromQueryClauses in class DBTransactionImpl
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.
Throws:
NotConnectedException - if no jdbc connection was acquired

createViewObjectFromQueryStmt

public ViewObject createViewObjectFromQueryStmt(java.lang.String sqlStatement)
Implementation of createViewObjectFromQueryStmt method.

Specified by:
createViewObjectFromQueryStmt in interface DBTransaction
Overrides:
createViewObjectFromQueryStmt in class DBTransactionImpl
Parameters:
sqlStatement - a SQL statement.
Throws:
NotConnectedException - if no jdbc connection was acquired

createRef

public java.lang.Object createRef(java.lang.String structName,
                                  byte[] data)
Checks to see if jdbc connection was acquired. Otherwise delegates to the the super class implementation

Specified by:
createRef in interface Transaction
Overrides:
createRef in class DBTransactionImpl
Throws:
NotConnectedException - if no jdbc connection was acquired

getCurrentDbTime

public java.sql.Timestamp getCurrentDbTime()
Checks to see if jdbc connection was acquired. Otherwise delegates to the the super class implementation

Overrides:
getCurrentDbTime in class DBTransactionImpl
Throws:
NotConnectedException - if no jdbc connection was acquired

Oracle ADF Model and Business Components API Reference 10.1.2 B14022-01

 

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