java.io.Serializable
, java.sql.Wrapper
, javax.naming.Referenceable
, javax.naming.spi.ObjectFactory
, javax.sql.CommonDataSource
, javax.sql.DataSource
, javax.sql.XADataSource
, EmbeddedDataSourceInterface
, EmbeddedXADataSourceInterface
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.
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 | 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 | Description |
---|---|
EmbeddedXADataSource() |
no-arg constructor
|
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() |
Update
BasicEmbeddedDataSource40.jdbcurl from attributes set. |
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
createShardingKeyBuilder, getParentLogger
createConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
getObjectInstance, getReference
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
- java.sql.SQLException
public ResourceAdapter getResourceAdapter()
getResourceAdapter
in interface EmbeddedXADataSourceInterface
ResourceAdapter
instance for the underlying
databaseApache Derby V10.14 Internals - Copyright © 2004,2018 The Apache Software Foundation. All Rights Reserved.