JavaTM 2 Platform
Standard Ed. 5.0

javax.sql
インタフェース XADataSource


public interface XADataSource

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

導入されたバージョン:
1.4

メソッドの概要
 int getLoginTimeout()
          データソースへの接続試行中に、このデータソースが待機する最長時間 (秒) を設定します。
 PrintWriter getLogWriter()
          この XADataSource オブジェクトのログライターを取得します。
 XAConnection getXAConnection()
          分散トランザクションで使用可能な、物理データベース接続の確立を試みます。
 XAConnection getXAConnection(String user, String password)
          指定されたユーザ名とパスワードを使用して、物理データベース接続の確立を試みます。
 void setLoginTimeout(int seconds)
          データソースへの接続試行中に、このデータソースが待機する最長時間 (秒) を指定します。
 void setLogWriter(PrintWriter out)
          この XADataSource オブジェクトのログライターを java.io.PrintWriter オブジェクトに設定します。
 

メソッドの詳細

getXAConnection

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

戻り値:
データソースへの物理接続を表す XAConnection オブジェクト。このオブジェクトは分散トランザクションで使用される
例外:
SQLException - データベースアクセスエラーが発生した場合

getXAConnection

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

パラメータ:
user - その代理として接続が行われるデータベースユーザ
password - ユーザのパスワード
戻り値:
データソースへの物理接続を表す XAConnection オブジェクト。このオブジェクトは分散トランザクションで使用される
例外:
SQLException - データベースアクセスエラーが発生した場合

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

この XADataSource オブジェクトのログライターを取得します。

戻り値:
このデータソースのログライター。ログライターが設定されていない場合は、ログの取得が無効であることを表す null
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
                  throws SQLException
この XADataSource オブジェクトのログライターを java.io.PrintWriter オブジェクトに設定します。

ログライターとは、この XADataSource オブジェクトのすべてのログおよびトレースメッセージの出力先キャラクタ出力ストリームのことです。このオブジェクトのメソッドによるメッセージや、このオブジェクトが作成したほかのオブジェクトによるメッセージなども含まれます。データソースに固有のログライターに出力されたメッセージは、java.sql.DriverManager クラスに関連付けられたログライターには出力されません。データソースオブジェクトが作成されると、ログライターは null に初期化されます。

パラメータ:
out - 新しいログライター。ログの取得を無効にするには null に設定する
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

データソースへの接続試行中に、このデータソースが待機する最長時間 (秒) を指定します。値が 0 のとき、デフォルトのシステムタイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。データソースオブジェクトが作成されると、ログインタイムアウトは 0 に初期化されます。

パラメータ:
seconds - データソースのログイン制限時間
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException
データソースへの接続試行中に、このデータソースが待機する最長時間 (秒) を設定します。値が 0 のとき、デフォルトのシステムタイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを指定します。データソースオブジェクトが作成されると、ログインタイムアウトは 0 に初期化されます。

戻り値:
この XADataSource オブジェクトによるログインの制限時間を表す秒数。タイムアウトの制限がない場合や、デフォルトのシステムタイムアウトである場合は 0
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setLoginTimeout(int)

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。