Java javax.sql 接口 ConnectionPoolDataSource（JDK5）

所有类

javax.sql
接口 ConnectionPoolDataSource

public interface ConnectionPoolDataSource

PooledConnection 对象的工厂。实现此接口的对象通常在基于 Java^TM Naming and Directory Interface (JNDI) 的命名服务中注册。

从以下版本开始：

1.4

getPooledConnection

PooledConnection getPooledConnection()
                                     throws SQLException

尝试建立可用作入池连接的物理数据库连接。

返回：

PooledConnection 对象，该对象是到此 ConnectionPoolDataSource 对象表示的数据库的物理连接

抛出：

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

getPooledConnection

PooledConnection getPooledConnection(String user,
                                     String password)
                                     throws SQLException

尝试建立可用作入池连接的物理数据库连接。

参数：

user - 为其建立连接的数据库用户

password - 用户的密码

返回：

PooledConnection 对象，该对象是到此 ConnectionPoolDataSource 对象表示的数据库的物理连接

抛出：

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

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

检索此 ConnectionPoolDataSource 对象的日志 writer。

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

返回：

此 ConnectionPoolDataSource 对象的日志 writer；如果禁用记录，则返回 null

抛出：

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

另请参见：

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
                  throws SQLException

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

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

参数：

out - 新的日志 writer；或者为 null，表示禁用记录

抛出：

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

另请参见：

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

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

参数：

seconds - 数据源登录超时值

抛出：

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

另请参见：

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException

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

返回：

数据源登录超时值

抛出：

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

另请参见：

setLoginTimeout(int)