javax.sql

Interface XADataSource

  • All Superinterfaces:
    CommonDataSource 

    public interface XADataSource
extends CommonDataSource
    A factory for XAConnection objects that is used internally. An object that implements the XADataSource interface is typically registered with a naming service that uses the Java Naming and Directory Interface™ (JNDI).

    An implementation of XADataSource must include a public no-arg constructor.

    Since:
    1.4

    • Method Detail

      • getXAConnection

        XAConnection getXAConnection()
                      throws SQLException
        Attempts to establish a physical database connection that can be used in a distributed transaction.
        Returns:
        an XAConnection object, which represents a physical connection to a data source, that can be used in a distributed transaction
        Throws:
        SQLException - if a database access error occurs
        SQLFeatureNotSupportedException - if the JDBC driver does not support this method
        SQLTimeoutException - when the driver has determined that the timeout value specified by the setLoginTimeout method has been exceeded and has at least tried to cancel the current database connection attempt
        Since:
        1.4

      • getXAConnection

        XAConnection getXAConnection(String user,
                             String password)
                      throws SQLException
        Attempts to establish a physical database connection, using the given user name and password. The connection that is returned is one that can be used in a distributed transaction.
        Parameters:
        user - the database user on whose behalf the connection is being made
        password - the user's password
        Returns:
        an XAConnection object, which represents a physical connection to a data source, that can be used in a distributed transaction
        Throws:
        SQLException - if a database access error occurs
        SQLFeatureNotSupportedException - if the JDBC driver does not support this method
        SQLTimeoutException - when the driver has determined that the timeout value specified by the setLoginTimeout method has been exceeded and has at least tried to cancel the current database connection attempt
        Since:
        1.4