模块  java.sql
软件包  javax.sql

Interface ConnectionPoolDataSource

  • All Superinterfaces:
    CommonDataSource

    public interface ConnectionPoolDataSourceextends CommonDataSource
    一个工厂为PooledConnection对象。 实现此接口的对象通常将使用基于Java™命名和目录接口(JNDI)的命名服务进行注册。
    从以下版本开始:
    1.4
    • 方法详细信息

      • getPooledConnection

        PooledConnection getPooledConnection()                              throws SQLException
        尝试建立可用作池连接的物理数据库连接。
        结果
        PooledConnection对象,是此 ConnectionPoolDataSource对象表示的数据库的物理连接
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • getPooledConnection

        PooledConnection getPooledConnection​(String user,                                     String password)                              throws SQLException
        尝试建立可用作池连接的物理数据库连接。
        参数
        user - 代表其进行连接的数据库用户
        password - 用户的密码
        结果
        PooledConnection对象,它是此 ConnectionPoolDataSource对象表示的数据库的物理连接
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • getLogWriter

        PrintWriter getLogWriter()                  throws SQLException

        检索此DataSource对象的日志DataSource

        日志写入程序是一个字符输出流,将打印此数据源的所有日志记录和跟踪消息。 这包括由此对象的方法打印的消息,由此对象生成的其他对象的方法打印的消息,等等。 打印到特定于数据源的日志写入程序的消息不会打印到与java.sql.DriverManager类关联的日志写入java.sql.DriverManager 创建DataSource对象时,日志DataSource器最初为null; 换句话说,默认情况下禁用日志记录。

        Specified by:
        getLogWriterCommonDataSource
        结果
        此数据源的日志编写器,如果禁用日志记录,则为null
        异常
        SQLException - 如果发生数据库访问错误
        从以下版本开始:
        1.4
        另请参见:
        CommonDataSource.setLogWriter(java.io.PrintWriter)
      • setLogWriter

        void setLogWriter​(PrintWriter out)           throws SQLException

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

        日志写入程序是一个字符输出流,将打印此数据源的所有日志记录和跟踪消息。 这包括由此对象的方法打印的消息,由此对象生成的其他对象的方法打印的消息,等等。 打印到特定于数据源的日志写入程序的消息不会打印到与java.sql.DriverManager类关联的日志写入java.sql.DriverManager 创建DataSource对象时,日志DataSource器最初为null; 换句话说,默认情况下禁用日志记录。

        Specified by:
        setLogWriter ,界面 CommonDataSource
        参数
        out - 新的日志out ; 要禁用日志记录,请设置为null
        异常
        SQLException - 如果发生数据库访问错误
        从以下版本开始:
        1.4
        另请参见:
        CommonDataSource.getLogWriter()
      • setLoginTimeout

        void setLoginTimeout​(int seconds)              throws SQLException

        设置此数据源在尝试连接到数据库时将等待的最长时间(以秒为单位)。 值为零指定超时是默认系统超时(如果有); 否则,它指定没有超时。 创建DataSource对象时,登录超时最初为零。

        Specified by:
        setLoginTimeout在界面 CommonDataSource
        参数
        seconds - 数据源登录时间限制
        异常
        SQLException - 如果发生数据库访问错误。
        从以下版本开始:
        1.4
        另请参见:
        CommonDataSource.getLoginTimeout()
      • getLoginTimeout

        int getLoginTimeout()             throws SQLException
        获取此数据源在尝试连接到数据库时可以等待的最长时间(以秒为单位)。 值为零表示超时是默认系统超时(如果有); 否则,表示没有超时。 创建DataSource对象时,登录超时最初为零。
        Specified by:
        getLoginTimeout在界面 CommonDataSource
        结果
        数据源登录时间限制
        异常
        SQLException - 如果发生数据库访问错误。
        从以下版本开始:
        1.4
        另请参见:
        CommonDataSource.setLoginTimeout(int)