CommonDataSource

public interface CommonDataSource

定义 DataSource、XADataSource 和 ConnectionPoolDataSource 之间通用方法的接口。

方法总结

方法详情

getLogWriter

PrintWriter getLogWriter() throws SQLException

检索此 DataSource 对象的日志写入器。

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

返回:

此数据源的日志编写器；如果禁用了日志记录，则为 null

Throws:

Since:

1.4

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

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

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

参数：

Throws:

Since:

1.4

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

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

参数：

Throws:

Since:

1.4

getLoginTimeout

int getLoginTimeout() throws SQLException

获取此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。 值为零表示超时是默认的系统超时，如果有的话； 否则，表示没有超时。 创建 DataSource 对象时，登录超时最初为零。

返回:

数据源登录时间限制

Throws:

Since:

1.4

getParentLogger

Logger getParentLogger() throws SQLFeatureNotSupportedException

返回此数据源使用的所有 Logger 的父 Logger。 这应该是距离根 Logger 最远的 Logger，根 Logger 仍然是该数据源使用的所有 Logger 的祖先。 配置此 Logger 将影响数据源生成的所有日志消息。 在最坏的情况下，这可能是根 Logger。

返回:

此数据源的父 Logger

Throws:

Since:

1.7