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类关联的写日志。当一个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

从以下版本开始：

一点七