compact2, compact3

javax.sql

Interface CommonDataSource

All Known Subinterfaces:

ConnectionPoolDataSource ， DataSource ， XADataSource

public interface CommonDataSource

接口，定义它们之间的共同的方法 DataSource ， XADataSource和 ConnectionPoolDataSource 。

方法摘要

Modifier and Type	Method and Description
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类相关java.sql.DriverManager的日志记录器中。 创建DataSource对象时，日志写入器最初为空; 换句话说，默认是禁用日志记录。

结果

此数据源的日志写入程序，如果禁用日志记录，则为空

异常

SQLException - 如果发生数据库访问错误

从以下版本开始：

1.4

另请参见：

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
           throws SQLException

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

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

参数

out - 新的日志记录器 禁用日志记录，设置为null

异常

SQLException - 如果发生数据库访问错误

从以下版本开始：

1.4

另请参见：

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
              throws SQLException

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

参数

seconds - 数据源登录时间限制

异常

SQLException - 如果发生数据库访问错误。

从以下版本开始：

1.4

另请参见：

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
             throws SQLException

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

结果

数据源登录时间限制

异常

SQLException - 如果发生数据库访问错误。

从以下版本开始：

1.4

另请参见：

setLoginTimeout(int)

getParentLogger

Logger getParentLogger()
                throws SQLFeatureNotSupportedException

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

结果

该数据源的父记录器

异常

SQLFeatureNotSupportedException - 如果数据源不使用 java.util.logging

从以下版本开始：

1.7