- すべてのスーパー・インタフェース:
CommonDataSource
XAConnectionオブジェクトのファクトリです。 XADataSourceインタフェースを実装するオブジェクトは、通常、Java Naming and Directory Interface (JNDI)を使用するネーミング・サービスに登録されます。
XADataSourceの実装には引数なしのpublicコンストラクタが含まれている必要があります。
- 導入されたバージョン:
- 1.4
-
メソッドのサマリー
修飾子と型メソッド説明default XAConnectionBuilder新しいXAConnectionBuilderインスタンスを作成intデータベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を取得します。このDataSourceオブジェクトのログ・ライターを取得します。分散トランザクションで使用可能な、物理データベース接続の確立を試みます。getXAConnection(String user, String password) 指定されたユーザー名とパスワードを使用して、物理データベース接続の確立を試みます。voidsetLoginTimeout(int seconds) データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を指定します。voidsetLogWriter(PrintWriter out) このDataSourceオブジェクトのログ・ライターをjava.io.PrintWriterオブジェクトに設定します。インタフェースjavax.sql.CommonDataSourceで宣言されたメソッド
createShardingKeyBuilder, getParentLogger
-
メソッドの詳細
-
getXAConnection
XAConnection getXAConnection() throws SQLException分散トランザクションで使用可能な、物理データベース接続の確立を試みます。- 戻り値:
- データ・ソースへの物理接続を表す
XAConnectionオブジェクト。このオブジェクトは分散トランザクションで使用される - 例外:
SQLException- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合SQLTimeoutException- ドライバが、setLoginTimeoutメソッドで指定されたタイムアウト値が経過したと判定し、少なくとも現在のデータベース接続の試みを取り消そうとしたとき- 導入されたバージョン:
- 1.4
-
getXAConnection
指定されたユーザー名とパスワードを使用して、物理データベース接続の確立を試みます。 返される接続は、分散トランザクションで使用できます。- パラメータ:
user- その代理として接続が行われるデータベース・ユーザーpassword- ユーザーのパスワード- 戻り値:
- データ・ソースへの物理接続を表す
XAConnectionオブジェクト。このオブジェクトは分散トランザクションで使用される - 例外:
SQLException- データベース・アクセス・エラーが発生した場合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない場合SQLTimeoutException- ドライバが、setLoginTimeoutメソッドで指定されたタイムアウト値が経過したと判定し、少なくとも現在のデータベース接続の試みを取り消そうとしたとき- 導入されたバージョン:
- 1.4
-
getLogWriter
PrintWriter getLogWriter() throws SQLExceptionこの
DataSourceオブジェクトのログ・ライターを取得します。ログ・ライターとは、このデータ・ソースに対するすべてのロギング・メッセージやトレース・メッセージの出力先となるキャラクタ出力ストリームのことです。 このオブジェクトのメソッドによって出力されたメッセージや、このオブジェクトが作成した他のオブジェクトのメソッドによって出力されたメッセージなども含まれます。 データ・ソース固有のログ・ライターに表示されたメッセージは、
java.sql.DriverManagerクラスに関連付けられたログ・ライターには出力されません。DataSourceオブジェクトが作成されると、ログ・ライターはnullに初期化されます。つまり、デフォルトではロギングは無効です。- 定義:
- インタフェース
CommonDataSource内のgetLogWriter - 戻り値:
- このデータ・ソースのログ・ライター。ログの取得が無効の場合はnull
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setLogWriter
void setLogWriter(PrintWriter out) throws SQLException この
DataSourceオブジェクトのログ・ライターをjava.io.PrintWriterオブジェクトに設定します。ログ・ライターとは、このデータ・ソースに対するすべてのロギング・メッセージやトレース・メッセージの出力先となるキャラクタ出力ストリームのことです。 このオブジェクトのメソッドによって出力されたメッセージや、このオブジェクトが作成した他のオブジェクトのメソッドによって出力されたメッセージなども含まれます。 データ・ソース固有のログ・ライターに表示されたメッセージは、
java.sql.DriverManagerクラスに関連付けられたログ・ライターには出力されません。DataSourceオブジェクトが作成されると、ログ・ライターはnullに初期化されます。つまり、デフォルトではロギングは無効です。- 定義:
- インタフェース
CommonDataSource内のsetLogWriter - パラメータ:
out- 新しいログ・ライター。ロギングを無効にする場合はnullに設定する- 例外:
SQLException- データベース・アクセス・エラーが発生した場合- 導入されたバージョン:
- 1.4
- 関連項目:
-
setLoginTimeout
void setLoginTimeout(int seconds) throws SQLException データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を指定します。 値が0のとき、デフォルトのシステム・タイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。
DataSourceオブジェクトが作成されると、ログイン・タイムアウトは0に初期化されます。- 定義:
- インタフェース
CommonDataSource内のsetLoginTimeout - パラメータ:
seconds- データ・ソースのログイン制限時間- 例外:
SQLException- データベース・アクセス・エラーが発生した場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
getLoginTimeout
int getLoginTimeout() throws SQLExceptionデータベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を取得します。 値が0のとき、デフォルトのシステム・タイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。DataSourceオブジェクトが作成されると、ログイン・タイムアウトは0に初期化されます。- 定義:
- インタフェース
CommonDataSource内のgetLoginTimeout - 戻り値:
- データ・ソースのログイン制限時間
- 例外:
SQLException- データベース・アクセス・エラーが発生した場合。- 導入されたバージョン:
- 1.4
- 関連項目:
-
createXAConnectionBuilder
default XAConnectionBuilder createXAConnectionBuilder() throws SQLException新しいXAConnectionBuilderインスタンスを作成- 実装要件:
- デフォルトの実装では、
SQLFeatureNotSupportedExceptionがスローされます。 - 戻り値:
- 作成されたXAConnectionBuilderインスタンス
- 例外:
SQLException- ビルダーの作成中にエラーが発生した場合SQLFeatureNotSupportedException- 運転手がシャーディングをサポートしていない場合- 導入されたバージョン:
- 9
- 関連項目:
-