Package oracle.ucp.jdbc

Interface PoolXADataSource

  • All Superinterfaces:
    javax.sql.CommonDataSource, javax.sql.DataSource, PoolDataSource, java.sql.Wrapper, javax.sql.XADataSource
    All Known Implementing Classes:
    PoolXADataSourceImpl
    public interface PoolXADataSource
extends PoolDataSource, javax.sql.XADataSource
    A Universal Connection Pool-enabled XA data source. See PoolDataSource for standard data source and connection pool properties that are supported.
    See Also:
    PoolDataSource, UniversalConnectionPool

    • Method Detail

      • getXAConnection

        javax.sql.XAConnection getXAConnection()
                                throws java.sql.SQLException
        Obtains an XA connection from the embedded Universal Connection Pool instance. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.
        Specified by:
        getXAConnection in interface javax.sql.XADataSource
        Returns:
        An XAConnection object that can be used in a distributed transaction.
        Throws:
        java.sql.SQLException - if a database access error occurs.

      • getXAConnection

        javax.sql.XAConnection getXAConnection​(java.lang.String user,
                                       java.lang.String password)
                                throws java.sql.SQLException
        Obtains an XA connection from the embedded Universal Connection Pool instance, using the given user name and password. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.
        Specified by:
        getXAConnection in interface javax.sql.XADataSource
        Parameters:
        user - The database user on whose behalf the connection is being made.
        password - The user's password.
        Returns:
        An XAConnection object that can be used in a distributed transaction.
        Throws:
        java.sql.SQLException - if a database access error occurs.

      • getXAConnection

        javax.sql.XAConnection getXAConnection​(java.util.Properties labels)
                                throws java.sql.SQLException
        Obtains an XA connection from the embedded Universal Connection Pool instance, using the given connection labels. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.
        Parameters:
        labels - The requested connection labels.
        Returns:
        An XAConnection object, which represents a physical connection to a data source, that can be used in a distributed transaction.
        Throws:
        java.sql.SQLException - if a database access error occurs.

      • getXAConnection

        javax.sql.XAConnection getXAConnection​(java.lang.String username,
                                       java.lang.String password,
                                       java.util.Properties labels)
                                throws java.sql.SQLException
        Obtains an XA connection from the embedded Universal Connection Pool instance, using the given user name, password, and connection labels. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.
        Parameters:
        username - The database user on whose behalf the connection is being made.
        password - The user's password.
        labels - The requested connection labels.
        Returns:
        An XAConnection object that can be used in a distributed transaction.
        Throws:
        java.sql.SQLException - if a database access error occurs.

      • createXAConnectionBuilder

        UCPXAConnectionBuilder createXAConnectionBuilder()
        Creates a new XAConnectionBuilder instance.
        Specified by:
        createXAConnectionBuilder in interface javax.sql.XADataSource
        Returns:
        The XAConnectionBuilder instance that was created