Class EmbeddedXADataSource
- java.lang.Object
-
- org.apache.derby.jdbc.BasicEmbeddedDataSource40
-
- org.apache.derby.jdbc.ReferenceableDataSource
-
- org.apache.derby.jdbc.EmbeddedDataSource
-
- org.apache.derby.jdbc.EmbeddedXADataSource
-
- All Implemented Interfaces:
java.io.Serializable
,java.sql.Wrapper
,javax.naming.Referenceable
,javax.naming.spi.ObjectFactory
,javax.sql.CommonDataSource
,javax.sql.DataSource
,javax.sql.XADataSource
,EmbeddedDataSourceInterface
,EmbeddedXADataSourceInterface
- Direct Known Subclasses:
EmbeddedXADataSource40
public class EmbeddedXADataSource extends EmbeddedDataSource implements EmbeddedXADataSourceInterface
This data source is suitable for an application using embedded Derby, running on full Java SE 6 or higher, corresponding to JDBC 4.0 and higher. EmbeddedXADataSource is an XADataSource implementation.
An XADataSource is a factory for XAConnection objects. It represents a RM in a DTP environment. An object that implements the XADataSource interface is typically registered with a JNDI service provider.
EmbeddedXADataSource automatically supports the correct JDBC specification version for the Java Virtual Machine's environment.
- JDBC 4.0 - Java SE 6
- JDBC 4.1 - Java SE 7
- JDBC 4.2 - full Java SE 8
Use BasicEmbeddedXADataSource40 if your application runs on Java 8 Compact Profile 2.
EmbeddedXADataSource object only works on a local database. There is no client/server support. An EmbeddedXADataSource object must live in the same jvm as the database.
EmbeddedXADataSource is serializable and referenceable.
See EmbeddedDataSource for DataSource properties.
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description private ResourceAdapter
ra
A cached link to the database, set up with the first connection is made.private static long
serialVersionUID
-
Fields inherited from class org.apache.derby.jdbc.BasicEmbeddedDataSource40
attributesAsPassword, connectionAttributes, createDatabase, databaseName, dataSourceName, description, driver, jdbcurl, loginTimeout, shutdownDatabase
-
-
Constructor Summary
Constructors Constructor Description EmbeddedXADataSource()
no-arg constructor
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description private javax.sql.XAConnection
createXAConnection(ResourceAdapter ra, java.lang.String user, java.lang.String password, boolean requestPassword)
Instantiate and return an EmbedXAConnection from this instance of EmbeddedXADataSource.ResourceAdapter
getResourceAdapter()
javax.sql.XAConnection
getXAConnection()
Attempt to establish a database connection.javax.sql.XAConnection
getXAConnection(java.lang.String user, java.lang.String password)
Attempt to establish a database connection with the given user name and password.protected void
update()
UpdateBasicEmbeddedDataSource40.jdbcurl
from attributes set.-
Methods inherited from class org.apache.derby.jdbc.EmbeddedDataSource
getObjectInstance, getReference
-
Methods inherited from class org.apache.derby.jdbc.BasicEmbeddedDataSource40
equals, findDriver, getAttributesAsPassword, getConnection, getConnection, getConnection, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getLoginTimeout, getLogWriter, getParentLogger, getPassword, getShutdownDatabase, getUser, hashCode, isWrapperFor, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setLoginTimeout, setLogWriter, setPassword, setShutdownDatabase, setupResourceAdapter, setUser, unwrap
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface javax.sql.CommonDataSource
createShardingKeyBuilder, getParentLogger
-
Methods inherited from interface javax.sql.DataSource
createConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
-
Methods inherited from interface org.apache.derby.jdbc.EmbeddedDataSourceInterface
getAttributesAsPassword, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getPassword, getShutdownDatabase, getUser, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setPassword, setShutdownDatabase, setUser
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
ra
private transient ResourceAdapter ra
A cached link to the database, set up with the first connection is made.
-
-
Method Detail
-
getXAConnection
public final javax.sql.XAConnection getXAConnection() throws java.sql.SQLException
Attempt to establish a database connection.- Specified by:
getXAConnection
in interfacejavax.sql.XADataSource
- Returns:
- a Connection to the database
- Throws:
java.sql.SQLException
- if a database-access error occurs.
-
getXAConnection
public final javax.sql.XAConnection getXAConnection(java.lang.String user, java.lang.String password) throws java.sql.SQLException
Attempt to establish a database connection with the given user name and password.- Specified by:
getXAConnection
in interfacejavax.sql.XADataSource
- Parameters:
user
- the database user on whose behalf the Connection is being madepassword
- the user's password- Returns:
- a Connection to the database
- Throws:
java.sql.SQLException
- if a database-access error occurs.
-
update
protected void update()
UpdateBasicEmbeddedDataSource40.jdbcurl
from attributes set. Also clear the cached value ofra
.- Overrides:
update
in classBasicEmbeddedDataSource40
-
createXAConnection
private javax.sql.XAConnection createXAConnection(ResourceAdapter ra, java.lang.String user, java.lang.String password, boolean requestPassword) throws java.sql.SQLException
Instantiate and return an EmbedXAConnection from this instance of EmbeddedXADataSource.- Parameters:
ra
- The resource adapter to the databaseuser
- The user namepassword
- The passwordrequestPassword
-- Returns:
- An XA connection to the database
- Throws:
java.sql.SQLException
-
getResourceAdapter
public ResourceAdapter getResourceAdapter()
- Specified by:
getResourceAdapter
in interfaceEmbeddedXADataSourceInterface
- Returns:
- The cached
ResourceAdapter
instance for the underlying database
-
-