javax.sql
接口 ConnectionPoolDataSource

public interface ConnectionPoolDataSource

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

从以下版本开始：

1.4

方法摘要

int	getLoginTimeout() 检索此 ConnectionPoolDataSource 对象尝试连接到某一数据库时将等待的最长时间，以秒为单位。
PrintWriter	getLogWriter() 检索此 ConnectionPoolDataSource 对象的日志 writer。
PooledConnection	getPooledConnection() 尝试建立可用作入池连接的物理数据库连接。
PooledConnection	getPooledConnection(String user, String password) 尝试建立可用作入池连接的物理数据库连接。
void	setLoginTimeout(int seconds) 设置此 ConnectionPoolDataSource 对象尝试连接到某一数据库时将等待的最长时间，以秒为单位。
void	setLogWriter(PrintWriter out) 将此 ConnectionPoolDataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。

方法详细信息

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)