public class DatabaseTransactionFactory
extends java.lang.Object
This class is used by the framework to create an instance when the client attempts to establish a connection to the database. Applications may provide custom DBTransaction implementations. Such applications will need to subclass this class and DBTransactionImpl.
The framework calls the getFactory()
method to get the currently installed factory, and calls its create() method
to establish a connection.
This class has a single active instance, which cannot be replaced.
DBTransaction
,
DBTransactionImpl
,
DBTransactionImpl2
Constructor and Description |
---|
DatabaseTransactionFactory() |
Modifier and Type | Method and Description |
---|---|
DBTransactionImpl2 |
create()
Instantiates a DBTransactionImpl2 instance.
|
DBTransactionImpl |
create(java.sql.Connection connection)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
DBTransactionImpl |
create(javax.sql.DataSource ds)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
DBTransactionImpl |
create(javax.sql.DataSource ds,
java.lang.String user,
java.lang.String passwd)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
DBTransactionImpl |
create(java.lang.String url)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
DBTransactionImpl |
create(java.lang.String url,
java.util.Properties info)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
DBTransactionImpl |
create(java.lang.String url,
java.lang.String user,
java.lang.String password)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
DBTransactionImpl |
create(java.lang.String url,
java.lang.String user,
java.lang.String password,
java.util.Properties info)
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
NullDBTransactionImpl |
createNullTransaction()
Deprecated.
Since 9.0.3.
This method is no longer called
to create a connected DBTransaction instance.
Instead, DBTransactionImpl2 instance, created by
create() , migrates from
disconnected to connected state. |
static DatabaseTransactionFactory |
getFactory()
Returns the installed factory using setFactory().
|
static void |
setFactory(DatabaseTransactionFactory impl)
Establishes the custom factory instance.
|
public static void setFactory(DatabaseTransactionFactory impl) throws java.lang.IllegalArgumentException
impl
- The subclassed factory implementation to be usedjava.lang.IllegalArgumentException
- if the instance is already createdgetFactory()
public static DatabaseTransactionFactory getFactory()
public DBTransactionImpl2 create()
public DBTransactionImpl create(java.lang.String url)
create()
, migrates from
disconnected to connected state.url
- Url to be used for creating DBTransactionImpl.DBTransactionImpl.DBTransactionImpl(String)
,
Transaction.connect(String)
,
DBTransactionImpl2
public DBTransactionImpl create(java.lang.String url, java.lang.String user, java.lang.String password)
create()
, migrates from
disconnected to connected state.url
- Url to be used for creating DBTransactionImpl.user
- Username to be used to create DBTransactionImplpassword
- Password to be used to create DBTransactionImplDBTransactionImpl.DBTransactionImpl(String, String, String)
,
Transaction.connect(String, String, String)
,
DBTransactionImpl2
public DBTransactionImpl create(java.lang.String url, java.lang.String user, java.lang.String password, java.util.Properties info)
create()
, migrates from
disconnected to connected state.url
- Url to be used for creating DBTransactionImpl.user
- Username to be used to create DBTransactionImplpassword
- Password to be used to create DBTransactionImplinfo
- Properties to be used to create DBTransactionImplDBTransactionImpl.DBTransactionImpl(String, String, String)
,
Transaction.connect(String, String, String)
,
DBTransactionImpl2
public DBTransactionImpl create(java.sql.Connection connection)
create()
, migrates from
disconnected to connected state.connection
- Connection to be used for creating DBTransactionImpl.DBTransactionImpl.DBTransactionImpl(Connection)
,
DBTransaction.connect(Connection)
,
DBTransactionImpl2
public DBTransactionImpl create(java.lang.String url, java.util.Properties info)
create()
, migrates from
disconnected to connected state.url
- Url to be used for creating DBTransactionImpl.info
- Properties to be used to create DBTransactionImplDBTransactionImpl.DBTransactionImpl(String, Properties)
,
Transaction.connect(String, Properties)
,
DBTransactionImpl2
public DBTransactionImpl create(javax.sql.DataSource ds)
create()
, migrates from
disconnected to connected state.DBTransactionImpl2
public DBTransactionImpl create(javax.sql.DataSource ds, java.lang.String user, java.lang.String passwd)
create()
, migrates from
disconnected to connected state.DBTransactionImpl2
public NullDBTransactionImpl createNullTransaction()
create()
, migrates from
disconnected to connected state.DBTransactionImpl2