モジュール java.sql
パッケージ javax.sql

インタフェースCommonDataSource

  • 既知のすべてのサブインタフェース:
    ConnectionPoolDataSource, DataSource, XADataSource

    public interface CommonDataSource
    DataSourceXADataSource、およびConnectionPoolDataSourceに共通のメソッドを定義するインタフェースです。
    導入されたバージョン:
    1.6
    • メソッドの詳細

      • getLogWriter

        PrintWriter getLogWriter()
                          throws SQLException

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

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

        戻り値:
        このデータ・ソースのログ・ライター。ログの取得が無効の場合はnull
        例外:
        SQLException - データベース・アクセス・エラーが発生した場合
        関連項目:
        setLogWriter(java.io.PrintWriter)
      • setLogWriter

        void setLogWriter​(PrintWriter out)
                   throws SQLException

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

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

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

        void setLoginTimeout​(int seconds)
                      throws SQLException

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

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

        int getLoginTimeout()
                     throws SQLException
        データベースへの接続試行中に、このデータ・ソースが待機する最長時間(秒)を取得します。 値が0のとき、デフォルトのシステム・タイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。 DataSourceオブジェクトが作成されると、ログイン・タイムアウトは0に初期化されます。
        戻り値:
        データ・ソースのログイン制限時間
        例外:
        SQLException - データベース・アクセス・エラーが発生した場合。
        関連項目:
        setLoginTimeout(int)
      • getParentLogger

        Logger getParentLogger()
                        throws SQLFeatureNotSupportedException
        このデータ・ソースによって使用されるすべてのロガーの親ロガーを返します。 これはこのデータ・ソースによって使用されているすべてのロガーの上位ロガーであるルート・ロガーからもっとも遠いロガーになるはずです。 このロガーを構成すると、データ・ソースによって生成されたすべてのログ・メッセージに影響します。 最悪の場合、これがルートLoggerになる可能性があります。
        戻り値:
        このデータ・ソースの親ロガー
        例外:
        SQLFeatureNotSupportedException - データ・ソースがjava.util.loggingを使用しない場合
        導入されたバージョン:
        1.7
      • createShardingKeyBuilder

        default ShardingKeyBuilder createShardingKeyBuilder()
                                                     throws SQLException
        新しいShardingKeyBuilderインスタンスを作成
        実装要件:
        デフォルトの実装では、SQLFeatureNotSupportedExceptionがスローされます。
        戻り値:
        作成されたShardingKeyBuilderインスタンス
        例外:
        SQLException - ビルダーの作成中にエラーが発生した場合
        SQLFeatureNotSupportedException - ドライバがこのメソッドをサポートしていない場合
        導入されたバージョン:
        9
        関連項目:
        ShardingKeyBuilder