java.io.Serializable, java.sql.Wrapper, javax.naming.Referenceable, javax.naming.spi.ObjectFactory, javax.sql.CommonDataSource, javax.sql.DataSource, javax.sql.XADataSource, EmbeddedDataSourceInterface, EmbeddedXADataSourceInterfaceEmbeddedXADataSource40public 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, unwrapcreateShardingKeyBuilder, getParentLoggercreateConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWritergetObjectInstance, getReferencegetAttributesAsPassword, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getPassword, getShutdownDatabase, getUser, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setPassword, setShutdownDatabase, setUserprivate static final long serialVersionUID
private transient ResourceAdapter ra
public final javax.sql.XAConnection getXAConnection()
throws java.sql.SQLException
getXAConnection in interface javax.sql.XADataSourcejava.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.XADataSourceuser - 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 BasicEmbeddedDataSource40private 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.SQLExceptionpublic ResourceAdapter getResourceAdapter()
getResourceAdapter in interface EmbeddedXADataSourceInterfaceResourceAdapter instance for the underlying
databaseApache Derby V10.14 Internals - Copyright © 2004,2018 The Apache Software Foundation. All Rights Reserved.