public class EmbeddedXADataSource extends EmbeddedDataSource implements org.apache.derby.jdbc.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.
Constructor and Description |
---|
EmbeddedXADataSource()
no-arg constructor
|
Modifier and Type | Method and Description |
---|---|
org.apache.derby.iapi.jdbc.ResourceAdapter |
getResourceAdapter() |
XAConnection |
getXAConnection()
Attempt to establish a database connection.
|
XAConnection |
getXAConnection(String user,
String password)
Attempt to establish a database connection with the given user
name and password.
|
getObjectInstance, getReference
equals, getAttributesAsPassword, 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, setUser, unwrap
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
getConnection, getConnection
getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter
isWrapperFor, unwrap
public final XAConnection getXAConnection() throws SQLException
getXAConnection
in interface XADataSource
SQLException
- if a database-access error occurs.public final XAConnection getXAConnection(String user, String password) throws SQLException
getXAConnection
in interface XADataSource
user
- the database user on whose behalf the Connection is being madepassword
- the user's passwordSQLException
- if a database-access error occurs.public org.apache.derby.iapi.jdbc.ResourceAdapter getResourceAdapter()
getResourceAdapter
in interface org.apache.derby.jdbc.EmbeddedXADataSourceInterface
ResourceAdapter
instance for the underlying
databaseApache Derby 10.11 API Documentation - Copyright © 2004,2014 The Apache Software Foundation. All Rights Reserved.