模块 java.sql
包 javax.sql

接口 PooledConnection

所有已知的子接口：
XAConnection
public interface PooledConnection
为连接池管理提供挂钩的对象。 PooledConnection 对象表示到数据源的物理连接。当应用程序完成连接时，连接可以回收而不是关闭，从而减少需要建立的连接数。

应用程序员不直接使用PooledConnection接口；相反，它由管理连接池的中间层基础设施使用。

当应用程序调用方法 DataSource.getConnection 时，它会返回一个 Connection 对象。如果正在进行连接池，那么 Connection 对象实际上是 PooledConnection 对象的句柄，这是一个物理连接。

连接池管理器，通常是应用程序服务，维护一个包含PooledConnection 个对象的池。如果池中有可用的 PooledConnection 对象，连接池管理器将返回一个 Connection 对象，它是该物理连接的句柄。如果没有 PooledConnection 对象可用，连接池管理器调用 ConnectionPoolDataSource 方法 getPoolConnection 来创建新的物理连接。实现 ConnectionPoolDataSource 的 JDBC 驱动程序创建一个新的 PooledConnection 对象并返回一个句柄。

当应用程序关闭连接时，它会调用 Connection 方法 close 。完成连接池时，连接池管理器会收到通知，因为它已使用 ConnectionPool 方法 addConnectionEventListener 将自己注册为 ConnectionEventListener 对象。连接池管理器停用 PooledConnection 对象的句柄并将 PooledConnection 对象返回到连接池，以便可以再次使用它。因此，当应用程序关闭其连接时，底层物理连接将被回收而不是被关闭。

如果连接池管理器包装或提供从对 PoolConnection.getConnection 的调用返回的逻辑句柄的代理，则当连接池管理器关闭或将 PooledConnection 返回到池以响应应用程序调用 Connection.close 时，池管理器必须执行以下操作之一:

  • 在逻辑 Connection 句柄上调用 endRequest
  • 在逻辑 Connection 句柄上调用 close

在连接池管理器调用PooledConnection 方法close 之前，物理连接不会关闭。通常调用此方法以有序关闭服务，或者如果发生致命错误导致连接不可用。

连接池管理器通常也是语句池管理器，维护一个包含 PreparedStatement 个对象的池。当应用程序关闭准备好的语句时，它会调用 PreparedStatement 方法 close 。当完成 Statement 池时，池管理器会收到通知，因为它已使用 ConnectionPool 方法 addStatementEventListener 将自己注册为 StatementEventListener 对象。因此，当应用程序关闭其 PreparedStatement 时，底层准备好的语句将被回收而不是被关闭。

自从：
1.4

  • 方法详情

    • getConnection

      Connection  getConnection() throws SQL异常
      创建并返回一个 Connection 对象，它是此 PooledConnection 对象表示的物理连接的句柄。当应用程序调用方法 DataSource.getConnection 并且没有 PooledConnection 对象可用时，连接池管理器调用此方法。有关详细信息，请参阅 interface description 。
      返回：
      一个 Connection 对象，它是这个 PooledConnection 对象的句柄
      抛出：
      SQLException - 如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自从：
      1.4

    • close

      void close() throws SQL异常
      关闭此 PooledConnection 对象代表的物理连接。应用程序永远不会直接调用此方法；它由连接池模块或管理器调用。

      有关详细信息，请参阅 interface description 。

      抛出：
      SQLException - 如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自从：
      1.4

    • addConnectionEventListener

      void addConnectionEventListener(ConnectionEventListener  listener)
      注册给定的事件监听器，以便在此 PooledConnection 对象上发生事件时通知它。
      参数：
      listener - 一个组件，通常是连接池管理器，它实现了 ConnectionEventListener 接口，希望在连接关闭或出现错误时得到通知
      参见：

    • removeConnectionEventListener

      void removeConnectionEventListener(ConnectionEventListener  listener)
      从组件列表中删除给定的事件监听器，当事件发生在此 PooledConnection 对象上时，这些监听器将被通知。
      参数：
      listener - 一个组件，通常是连接池管理器，它实现了 ConnectionEventListener 接口并作为监听器注册到这个 PooledConnection 对象
      参见：

    • addStatementEventListener

      void addStatementEventListener(StatementEventListener  listener)
      向这个 PooledConnection 对象注册一个 StatementEventListener。希望在连接创建的 PreparedStatement 关闭或检测到无效时收到通知的组件可以使用此方法向此 PooledConnection 对象注册一个 StatementEventListener。
      参数：
      listener - 实现 StatementEventListener 接口的组件，要注册到这个 PooledConnection 对象
      自从：
      1.6

    • removeStatementEventListener

      void removeStatementEventListener(StatementEventListener  listener)
      从组件列表中删除指定的 StatementEventListener，当驱动程序检测到 PreparedStatement 已关闭或无效时，将通知这些组件。
      参数：
      listener - 实现先前注册到此 PooledConnection 对象的 StatementEventListener 接口的组件
      自从：
      1.6