Package oracle.jdbc.xa.client

Class OracleXADataSource

  • All Implemented Interfaces:
    java.io.Serializable, java.sql.Wrapper, javax.naming.Referenceable, javax.sql.CommonDataSource, javax.sql.ConnectionPoolDataSource, javax.sql.DataSource, javax.sql.XADataSource, OracleCommonDataSource, OracleConnectionPoolDataSource, OracleDataSource, OracleXADataSource, oracle.jdbc.diagnostics.Diagnosable, oracle.jdbc.diagnostics.PropertyChangeListener, oracle.jdbc.internal.Monitor, oracle.jdbc.replay.internal.OracleConnectionPoolDataSource, oracle.jdbc.replay.internal.OracleDataSource, oracle.jdbc.replay.internal.OracleXADataSource, OracleConnectionPoolDataSource, OracleDataSource, OracleXADataSource
    Direct Known Subclasses:
    OracleXADataSourceImpl
    public class OracleXADataSource
extends OracleXADataSource
    A factory for XAConnection objects. An object that implements the XADataSource interface is typically registered with a JNDI service provider.

    For optimization purposes, we implemented 2 versions of OracleXADataSource: one for client, and one for server when used in Java Stored Procedures and in EJB. The server-version is only available in 8.1.6 and post-8.1.6 backends. This one is the implementation of OracleXADataSource for client-side usage and works for both pre- and post-8.1.6 RMs.

    The following example illustrates the use of this data source to create a JDBC XAConnection: 

      
    oracle.jdbc.xa.client.OracleXADataSource oxads =
      new oracle.jdbc.xa.client.OracleXADataSource();
    oxads.setURL("jdbc:oracle:thin:@//dbhost:dbport/dbservice");
    oxads.setUser("User");
    oxads.setPassword("Passwd");
    oxads.setConnectionProperty("connProp1", "value1");
    oxads.setConnectionProperty("connProp2", "value2");
 
    javax.sql.XAConnection xaconn = oxads.getXAConnection();

    See Also:
    Serialized Form

    • Constructor Detail

      • OracleXADataSource

        public OracleXADataSource()
                   throws java.sql.SQLException
        Create an OracleXADataSource instance.

        Throws:
        java.sql.SQLException - if error occurs while creating an object

    • Method Detail

      • getXAConnection

        public javax.sql.XAConnection getXAConnection()
                                       throws java.sql.SQLException
        Attempt to establish a database connection.

        Specified by:
        getXAConnection in interface OracleXADataSource
        Specified by:
        getXAConnection in interface javax.sql.XADataSource
        Specified by:
        getXAConnection in class OracleXADataSource
        Returns:
        an Connection to the database
        Throws:
        java.sql.SQLException - if a database-access error occurs.

      • getXAConnection

        public javax.sql.XAConnection getXAConnection​(java.lang.String userName,
                                              java.lang.String passwd)
                                       throws java.sql.SQLException
        Attempt to establish a database connection.

        Specified by:
        getXAConnection in interface OracleXADataSource
        Specified by:
        getXAConnection in interface javax.sql.XADataSource
        Specified by:
        getXAConnection in class OracleXADataSource
        Parameters:
        userName - the database user on whose behalf the Connection is made
        passwd - the user's password
        Returns:
        an XAConnection encapsulating a connection to the database
        Throws:
        java.sql.SQLException - if a database-access error occurs.

      • getXAConnection

        public javax.sql.XAConnection getXAConnection​(OracleXAConnectionBuilderImpl builder)
                                       throws java.sql.SQLException
        Throws:
        java.sql.SQLException