org.apache.derby.jdbc
Class EmbeddedXADataSource
java.lang.Object
org.apache.derby.jdbc.ReferenceableDataSource
org.apache.derby.jdbc.EmbeddedDataSource
org.apache.derby.jdbc.EmbeddedXADataSource
- All Implemented Interfaces:
- javax.sql.DataSource, javax.naming.spi.ObjectFactory, javax.naming.Referenceable, java.io.Serializable, javax.sql.XADataSource
- public class EmbeddedXADataSource
- extends EmbeddedDataSource
- implements javax.sql.XADataSource
EmbeddedXADataSource is Derby's 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 3.0 - Java 2 - JDK 1.4, J2SE 5.0
- JDBC 2.0 - Java 2 - JDK 1.2,1.3
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:
- Serialized Form
Method Summary |
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. |
Methods inherited from class org.apache.derby.jdbc.EmbeddedDataSource |
equals, getAttributesAsPassword, getConnection, getConnection, getConnectionAttributes, getCreateDatabase, getShutdownDatabase, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setShutdownDatabase |
Methods inherited from class org.apache.derby.jdbc.ReferenceableDataSource |
getDatabaseName, getDataSourceName, getDescription, getLoginTimeout, getLogWriter, getObjectInstance, getPassword, getReference, getUser, setDatabaseName, setDataSourceName, setDescription, setLoginTimeout, setLogWriter, setPassword, setUser |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface javax.sql.XADataSource |
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter |
Methods inherited from interface javax.sql.DataSource |
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter |
EmbeddedXADataSource
public EmbeddedXADataSource()
- no-arg constructor
getXAConnection
public final javax.sql.XAConnection getXAConnection()
throws java.sql.SQLException
- Attempt to establish a database connection.
- Specified by:
getXAConnection
in interface javax.sql.XADataSource
- Returns:
- a Connection to the database
- Throws:
java.sql.SQLException
- if a database-access error occurs.
getXAConnection
public final javax.sql.XAConnection getXAConnection(java.lang.String user,
java.lang.String password)
throws java.sql.SQLException
- Attempt to establish a database connection with the given user
name and password.
- Specified by:
getXAConnection
in interface javax.sql.XADataSource
- Parameters:
user
- the database user on whose behalf the Connection is being madepassword
- the user's password
- Returns:
- a Connection to the database
- Throws:
java.sql.SQLException
- if a database-access error occurs.
Apache Derby 10.1 API Documentation - Copyright © 1997,2005 The Apache Software Foundation or its licensors, as applicable.