compact2, compact3

javax.sql

インタフェースCommonDataSource

既知のすべてのサブインタフェース:

ConnectionPoolDataSource、DataSource、XADataSource

public interface CommonDataSource

DataSource、XADataSource、およびConnectionPoolDataSourceに共通のメソッドを定義するインタフェースです。

メソッドのサマリー

修飾子と型	メソッドと説明
int	getLoginTimeout() データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を取得します。
PrintWriter	getLogWriter() このDataSourceオブジェクトのログ・ライターを取得します。
Logger	getParentLogger() このデータ・ソースによって使用されるすべてのロガーの親ロガーを返します。
void	setLoginTimeout(int seconds) データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を指定します。
void	setLogWriter(PrintWriter out) このDataSourceオブジェクトのログ・ライターをjava.io.PrintWriterオブジェクトに設定します。

メソッドの詳細

getLogWriter

PrintWriter getLogWriter()
                  throws SQLException

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

ログ・ライターとは、このデータ・ソースに対するすべてのロギング・メッセージやトレース・メッセージの出力先となるキャラクタ出力ストリームのことです。このオブジェクトのメソッドによって出力されたメッセージや、このオブジェクトが作成した他のオブジェクトのメソッドによって出力されたメッセージなども含まれます。データ・ソース固有のログ・ライターに表示されたメッセージは、java.sql.DriverManagerクラスに関連付けられたログ・ライターには出力されません。DataSourceオブジェクトが作成されると、ログ・ライターはnullに初期化されます。つまり、デフォルトではロギングは無効です。

戻り値:

このデータ・ソースのログ・ライター。ログの取得が無効の場合はnull

例外:

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

導入されたバージョン:

1.4

関連項目:

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
           throws SQLException

このDataSourceオブジェクトのログ・ライターをjava.io.PrintWriterオブジェクトに設定します。

ログ・ライターとは、このデータ・ソースに対するすべてのロギング・メッセージやトレース・メッセージの出力先となるキャラクタ出力ストリームのことです。このオブジェクトのメソッドによって出力されたメッセージや、このオブジェクトが作成した他のオブジェクトのメソッドによって出力されたメッセージなども含まれます。データ・ソース固有のログ・ライターに表示されたメッセージは、java.sql.DriverManagerクラスに関連付けられたログ・ライターには出力されません。DataSourceオブジェクトが作成されると、ログ・ライターはnullに初期化されます。つまり、デフォルトではロギングは無効です。

パラメータ:

out - 新しいログ・ライター。ロギングを無効にする場合はnullに設定する

例外:

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

導入されたバージョン:

1.4

関連項目:

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
              throws SQLException

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

パラメータ:

seconds - データ・ソースのログイン制限時間

例外:

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

導入されたバージョン:

1.4

関連項目:

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
             throws SQLException

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

戻り値:

データ・ソースのログイン制限時間

例外:

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

導入されたバージョン:

1.4

関連項目:

setLoginTimeout(int)

getParentLogger

Logger getParentLogger()
                throws SQLFeatureNotSupportedException

このデータ・ソースによって使用されるすべてのロガーの親ロガーを返します。これはこのデータ・ソースによって使用されているすべてのロガーの上位ロガーであるルート・ロガーからもっとも遠いロガーになるはずです。このロガーを構成すると、データ・ソースによって生成されたすべてのログ・メッセージに影響します。最悪の場合、これがルートLoggerになる可能性があります。

戻り値:

このデータ・ソースの親ロガー

例外:

SQLFeatureNotSupportedException - データ・ソースがjava.util.loggingを使用しない場合

導入されたバージョン:

1.7