- All Implemented Interfaces:
Serializable,Wrapper,Referenceable,ObjectFactory,CommonDataSource,DataSource,XADataSource,org.apache.derby.iapi.jdbc.EmbeddedDataSourceInterface,org.apache.derby.iapi.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.
- 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:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionorg.apache.derby.iapi.jdbc.ResourceAdapterfinal XAConnectionAttempt to establish a database connection.final XAConnectiongetXAConnection(String user, String password) Attempt to establish a database connection with the given user name and password.Methods inherited from class org.apache.derby.jdbc.EmbeddedDataSource
getObjectInstance, getReferenceMethods inherited from class org.apache.derby.jdbc.BasicEmbeddedDataSource40
equals, 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, setUser, unwrapMethods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface javax.sql.CommonDataSource
getParentLoggerMethods inherited from interface javax.sql.DataSource
createConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriterMethods inherited from interface org.apache.derby.iapi.jdbc.EmbeddedDataSourceInterface
getAttributesAsPassword, getConnection, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getPassword, getShutdownDatabase, getUser, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setPassword, setShutdownDatabase, setUserMethods inherited from interface org.apache.derby.iapi.jdbc.EmbeddedXADataSourceInterface
createShardingKeyBuilderMethods inherited from interface java.sql.Wrapper
isWrapperFor, unwrapMethods inherited from interface javax.sql.XADataSource
createXAConnectionBuilder, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
-
Constructor Details
-
EmbeddedXADataSource
public EmbeddedXADataSource()no-arg constructor
-
-
Method Details
-
getXAConnection
Attempt to establish a database connection.- Specified by:
getXAConnectionin interfaceXADataSource- Returns:
- a Connection to the database
- Throws:
SQLException- if a database-access error occurs.
-
getXAConnection
Attempt to establish a database connection with the given user name and password.- Specified by:
getXAConnectionin interfaceXADataSource- Parameters:
user- the database user on whose behalf the Connection is being madepassword- the user's password- Returns:
- a Connection to the database
- Throws:
SQLException- if a database-access error occurs.
-
getResourceAdapter
public org.apache.derby.iapi.jdbc.ResourceAdapter getResourceAdapter()- Specified by:
getResourceAdapterin interfaceorg.apache.derby.iapi.jdbc.EmbeddedXADataSourceInterface- Returns:
- The cached
ResourceAdapterinstance for the underlying database
-