Module java.sql

Package javax.sql

Interface CommonDataSource

已知的所有子接口:

ConnectionPoolDataSource, DataSource, XADataSource

       public interface CommonDataSource
      

定义了在DataSource、XADataSource和ConnectionPoolDataSource之间共同的方法的接口。

自版本:

1.6

Method Summary

Modifier and Type	Method	Description
default ShardingKeyBuilder	createShardingKeyBuilder()	创建一个新的ShardingKeyBuilder实例
int	getLoginTimeout()	获取此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。
PrintWriter	getLogWriter()	检索此DataSource对象的日志记录器。
Logger	getParentLogger()	返回此数据源使用的所有日志记录器的父记录器。
void	setLoginTimeout(int seconds)	设置此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。
void	setLogWriter(PrintWriter out)	将此DataSource对象的日志记录器设置为给定的java.io.PrintWriter对象。

Method Details

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
            

设置此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。如果值为零，则指定超时时间为默认系统超时时间（如果有）；否则，指定没有超时时间。创建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