compact2, compact3

javax.sql

インタフェースXADataSource

すべてのスーパー・インタフェース:

CommonDataSource

public interface XADataSource
extends CommonDataSource

内部で使用されるXAConnectionオブジェクトのファクトリです。XADataSourceインタフェースを実装するオブジェクトは、一般に、Java Naming and Directory Interface™ (JNDI)を使用するネーム・サービスに登録されます。

XADataSourceの実装には引数なしのpublicコンストラクタが含まれている必要があります。

導入されたバージョン:

1.4

メソッドのサマリー

修飾子と型	メソッドと説明
XAConnection	getXAConnection() 分散トランザクションで使用可能な、物理データベース接続の確立を試みます。
XAConnection	getXAConnection(String user, String password) 指定されたユーザー名とパスワードを使用して、物理データベース接続の確立を試みます。

インタフェース javax.sql.CommonDataSourceから継承されたメソッド

getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

メソッドの詳細

getXAConnection

XAConnection getXAConnection()
                      throws SQLException

分散トランザクションで使用可能な、物理データベース接続の確立を試みます。

戻り値:

データ・ソースへの物理接続を表すXAConnectionオブジェクト。このオブジェクトは分散トランザクションで使用される

例外:

SQLException - データベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

SQLTimeoutException - ドライバが、setLoginTimeoutメソッドで指定されたタイムアウト値が経過したと判定し、少なくとも現在のデータベース接続の試みを取り消そうとしたとき

導入されたバージョン:

1.4

getXAConnection

XAConnection getXAConnection(String user,
                             String password)
                      throws SQLException

指定されたユーザー名とパスワードを使用して、物理データベース接続の確立を試みます。返される接続は、分散トランザクションで使用できます。

パラメータ:

user - その代理として接続が行われるデータベース・ユーザー

password - ユーザーのパスワード

戻り値:

データ・ソースへの物理接続を表すXAConnectionオブジェクト。このオブジェクトは分散トランザクションで使用される

例外:

SQLException - データベース・アクセス・エラーが発生した場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

SQLTimeoutException - ドライバが、setLoginTimeoutメソッドで指定されたタイムアウト値が経過したと判定し、少なくとも現在のデータベース接続の試みを取り消そうとしたとき

導入されたバージョン:

1.4