Module  java.sql
软件包  javax.sql

Interface CommonDataSource

  • All Known Subinterfaces:
    ConnectionPoolDataSource ， DataSource ， XADataSource 

    public interface CommonDataSource
    接口，定义它们之间的共同的方法 DataSource ， XADataSource和 ConnectionPoolDataSource 。
    从以下版本开始：
    1.6

    • 方法详细信息

      • getLogWriter

        PrintWriter getLogWriter​()
                  throws SQLException

        检索此DataSource对象的日志记录器。

        日志写入器是一个字符输出流，将为该数据源打印所有日志记录和跟踪消息。 这包括通过该对象的方法打印的消息，由该对象制造的其他对象的方法打印的消息等等。 打印到数据源特定日志记录器的消息不会打印到与java.sql.DriverManager类关联的日志记录器中。 创建DataSource对象时，日志写入器最初为空; 换句话说，默认是禁用日志记录。

        结果
        此数据源的日志写入程序，如果禁用日志记录，则为空
        异常
        SQLException - 如果发生数据库访问错误
        另请参见：
        setLogWriter(java.io.PrintWriter)

      • setLogWriter

        void setLogWriter​(PrintWriter out)
           throws SQLException

        将此DataSource对象的日志写入器设置为给定的java.io.PrintWriter对象。

        日志写入器是一个字符输出流，将为该数据源打印所有日志记录和跟踪消息。 这包括通过该对象的方法打印的消息，由该对象制造的其他对象的方法打印的消息等等。 打印到数据源特定日志记录器的消息不会打印到与java.sql.DriverManager类相关联的日志记录器中。 当创建DataSource对象时，日志写入器最初为空; 换句话说，默认是禁用日志记录。

        参数
        out - 新的日志记录器 禁用日志记录，设置为null
        异常
        SQLException - 如果发生数据库访问错误
        另请参见：
        getLogWriter()

      • setLoginTimeout

        void setLoginTimeout​(int seconds)
              throws SQLException

        设置该数据源在尝试连接到数据库时将等待的最长时间（秒）。 值为零表示超时是默认的系统超时，如果有的话; 否则，它指定没有超时。 当创建一个DataSource对象时，登录超时最初为零。

        参数
        seconds - 数据源登录时间限制
        异常
        SQLException - 如果发生数据库访问错误。
        另请参见：
        getLoginTimeout()

      • getLoginTimeout

        int getLoginTimeout​()
             throws SQLException
        获取此数据源在尝试连接到数据库时可以等待的最长时间（秒）。 值为零表示超时是默认的系统超时，如果有的话; 否则，这意味着没有超时。 当创建一个DataSource对象时，登录超时最初为零。
        结果
        数据源登录时间限制
        异常
        SQLException - 如果发生数据库访问错误。
        另请参见：
        setLoginTimeout(int)

      • getParentLogger

        Logger getParentLogger​()
                throws SQLFeatureNotSupportedException
        返回此数据源使用的所有日志记录器的父记录器。 这应该是距离根记录器最远的记录器，该记录器仍然是此数据源使用的所有记录器的祖先。 配置此记录器将影响数据源生成的所有日志消息。 在最坏的情况下，这可能是根记录器。
        结果
        该数据源的父记录器
        异常
        SQLFeatureNotSupportedException - 如果数据源不使用 java.util.logging
        从以下版本开始：
        1.7

      • createShardingKeyBuilder

        default ShardingKeyBuilder createShardingKeyBuilder​()
                                             throws SQLException
        创建一个新的 ShardingKeyBuilder实例
        实现要求：
        默认实现将抛出一个 SQLFeatureNotSupportedException 。
        结果
        已创建的ShardingKeyBuilder实例
        异常
        SQLException - 如果创建构建器发生错误
        SQLFeatureNotSupportedException - 如果驱动程序不支持此方法
        从以下版本开始：
        9
        另请参见：
        ShardingKeyBuilder