JDBC API 为连接池提供了一个 客户端接口和一个 服务器端接口。客户端 接口是 javax.sql.DataSource， 应用代码通常用它来 获取一个池化的数据库连接。服务器端 接口是 javax.sql.ConnectionPoolDataSource， 大多数应用服务器将通过它与 PostgreSQL JDBC 驱动对接。

在应用服务器环境中，应用服务器的配置通常引用 PostgreSQL 的 ConnectionPoolDataSource 实现， 而应用组件代码通常获取由 应用服务器（而不是 PostgreSQL）提供的 DataSource 实现。

对于没有应用服务器的环境， PostgreSQL 提供了应用程序可以直接使用的两种 DataSource 实现。一种实现执行连接池化， 而另一种只是通过 DataSource 接口提供对数据库连接的 访问，不做任何池化。另外，这些实现不应在 应用服务器环境中使用，除非 应用服务器不支持 ConnectionPoolDataSource 接口。

PostgreSQL 为 JDBC 2 和 JDBC 3 各包含一个 ConnectionPoolDataSource 的实现， 如 表 31.1 所示。

两种实现使用相同的配置方案。 JDBC 要求 ConnectionPoolDataSource 通过 JavaBean 属性配置，如 表 31.2 所示， 因此每种属性都有相应的 get 和 set 方法。

许多应用服务器使用属性风格的语法来 配置这些属性，因此把属性作为一块文本输入并不罕见。如果 应用服务器提供单一区域来输入所有属性，它们可能 像这样列出：

serverName=localhost
databaseName=test
user=testuser
password=testpassword

或者，如果用分号而不是换行符作为分隔符，它可能 像这样：

serverName=localhost;databaseName=test;user=testuser;password=testpassword

PostgreSQL 为 JDBC 2 包含两种 DataSource 实现，为 JDBC 3 也包含两种，如 表 31.3 所示。 池化实现在客户端调用 close 方法时实际上并不 关闭连接，而是把连接归还到 一个可供其他客户端使用的空闲连接池中。 这避免了反复打开和关闭连接的任何开销， 并允许大量客户端共享少量数据库连接。

这里提供的池化数据源实现并不是 世界上功能最丰富的。举几个方面：连接直到 池本身关闭之前永远不会被关闭； 没有办法收缩池。而且，为默认配置用户之外的用户 请求的连接不会被池化。许多应用服务器 提供更高级的池化特性，并改用 ConnectionPoolDataSource 实现。

所有实现都使用相同的配置方案。 JDBC 要求 DataSource 通过 JavaBean 属性配置，如 表 31.4 所示， 因此每种属性都有相应的 get 和 set 方法。

池化实现需要一些额外的 配置属性，它们显示在 表 31.5 中。

例 31.9 展示了使用池化 DataSource 的典型应用代码的一个例子。

Jdbc3PoolingDataSource source = new Jdbc3PoolingDataSource();
source.setDataSourceName("A Data Source");
source.setServerName("localhost");
source.setDatabaseName("test");
source.setUser("testuser");
source.setPassword("testpassword");
source.setMaxConnections(10);

Connection con = null;
try {
    con = source.getConnection();
    // use connection
} catch (SQLException e) {
    // log error
} finally {
    if (con != null) {
        try { con.close(); } catch (SQLException e) {}
    }
}

所有 ConnectionPoolDataSource 和 DataSource 实现都可以存储 在 JNDI 中。对于非池化 实现，每次从 JNDI 检索该对象时都会 创建一个新实例，其设置与被存储的实例 相同。对于 池化实现，只要它可用（例如，不是从 JNDI 检索该池的另一个不同 JVM），就会检索到同一个实例，否则会 用相同的设置创建一个新实例。

在应用服务器环境中，通常存储在 JNDI 中的是应用服务器的 DataSource 实例，而不是 PostgreSQL 的 ConnectionPoolDataSource 实现。

在应用程序环境中，应用程序可以把 DataSource 存储在 JNDI 中，这样它就不必把对 DataSource 的引用提供给它可能需要 使用它的所有应用 组件。例 31.10 展示了这样的一个 例子。

Jdbc3PoolingDataSource source = new Jdbc3PoolingDataSource();
source.setDataSourceName("A Data Source");
source.setServerName("localhost");
source.setDatabaseName("test");
source.setUser("testuser");
source.setPassword("testpassword");
source.setMaxConnections(10);
new InitialContext().rebind("DataSource", source);

Connection con = null;
try {
    DataSource source = (DataSource)new InitialContext().lookup("DataSource");
    con = source.getConnection();
    // use connection
} catch (SQLException e) {
    // log error
} catch (NamingException e) {
    // DataSource wasn't found in JNDI
} finally {
    if (con != null) {
        try { con.close(); } catch (SQLException e) {}
    }
}