public interface

XADataSource

implements CommonDataSource
javax.sql.XADataSource

Class Overview

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 InterfaceTM (JNDI).

Summary

Public Methods
abstract XAConnection getXAConnection()
Attempts to establish a physical database connection that can be used in a distributed transaction.
abstract XAConnection getXAConnection(String user, String password)
Attempts to establish a physical database connection, using the given user name and password.
[Expand]
Inherited Methods
From interface javax.sql.CommonDataSource

Public Methods

public abstract XAConnection getXAConnection ()

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

public abstract XAConnection getXAConnection (String user, String password)

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