oracle.jbo.server
Class DBTransactionImpl2

java.lang.Object
oracle.jbo.server.DBTransactionImpl
oracle.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