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.
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.
Modifier and Type | Field and Description |
---|---|
private ResourceAdapter |
ra
A cached link to the database, set up with the first connection is
made.
|
private static long |
serialVersionUID |
attributesAsPassword, connectionAttributes, createDatabase, databaseName, dataSourceName, description, driver, jdbcurl, loginTimeout, shutdownDatabase
Constructor and Description |
---|
EmbeddedXADataSource()
no-arg constructor
|
Modifier and Type | Method and 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()
Update
BasicEmbeddedDataSource40.jdbcurl from attributes set. |
getObjectInstance, getReference
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
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
getAttributesAsPassword, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getPassword, getShutdownDatabase, getUser, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setPassword, setShutdownDatabase, setUser
private static final long serialVersionUID
private transient ResourceAdapter ra
public final javax.sql.XAConnection getXAConnection() throws java.sql.SQLException
getXAConnection
in interface javax.sql.XADataSource
java.sql.SQLException
- if a database-access error occurs.public final javax.sql.XAConnection getXAConnection(java.lang.String user, java.lang.String password) throws java.sql.SQLException
getXAConnection
in interface javax.sql.XADataSource
user
- the database user on whose behalf the Connection is being madepassword
- the user's passwordjava.sql.SQLException
- if a database-access error occurs.protected void update()
BasicEmbeddedDataSource40.jdbcurl
from attributes set.
Also clear the cached value of ra
.update
in class BasicEmbeddedDataSource40
private javax.sql.XAConnection createXAConnection(ResourceAdapter ra, java.lang.String user, java.lang.String password, boolean requestPassword) throws java.sql.SQLException
ra
- The resource adapter to the databaseuser
- The user namepassword
- The passwordrequestPassword
- @false
if original call is from a
no-argument constructor, otherwise true
java.sql.SQLException
public ResourceAdapter getResourceAdapter()
getResourceAdapter
in interface EmbeddedXADataSourceInterface
ResourceAdapter
instance for the underlying
databaseApache Derby V10.13 Internals - Copyright © 2004,2016 The Apache Software Foundation. All Rights Reserved.