javax.sql
接口 CommonDataSource

所有已知子接口：

ConnectionPoolDataSource, DataSource, XADataSource

public interface CommonDataSource

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

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

获取此 DataSource 对象的日志 writer。

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

返回：

此数据源的日志 writer；如果禁用日志记录，则返回 null

抛出：

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

从以下版本开始：

1.4

另请参见：

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
                  throws SQLException

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

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

参数：

out - 新的日志 writer；如果要禁用日志记录，则设置为 null

抛出：

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

从以下版本开始：

1.4

另请参见：

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

设置此数据源试图连接到某一数据库时将等待的最长时间，以秒为单位。值为 0 表示超时值为默认的系统超时值（如果有）；否则它表示不存在超时值。创建 DataSource 对象时，登录超时值最初为 0。

参数：

seconds - 数据源登录超时值

抛出：

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

从以下版本开始：

1.4

另请参见：

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException

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

返回：

数据源登录超时值

抛出：

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

从以下版本开始：

1.4

另请参见：

setLoginTimeout(int)