31.10. 连接池和数据源

31.10.1. 概述

JDBC API 为连接池提供了一个客户端和一个服务器端的接口。 客户端接口是 javax.sql.DataSource， 通常就是应用代码用来请求一个缓冲了的数据库连接的东西。 服务器接口是 javax.sql.ConnectionPoolDataSource， 通常是大多数应用服务器和 PostgreSQL JDBC 驱动打交道的接口。

在应用服务器环境里，应用服务器配置通常将指向 PostgreSQL ConnectionPoolDataSource 实现， 而应用组件代码将通常要求一个由应用服务器实现的 DataSource（不是由 PostgreSQL）。

在一个没有应用服务器的环境里，PostgreSQL 提供了两种应用可以直接使用的 DataSource 的实现。 一种实现执行连接池，另外一种只是简单的通过 DataSource 接口提供访问数据库的连接， 而不使用任何缓冲池。同样，这些实现不应该在一个应用服务器环境里使用， 除非应用服务器不支持 ConnectionPoolDataSource 接口。

31.10.2. 应用服务器：ConnectionPoolDataSource

PostgreSQL 包含了一个用于 JDBC 2 的 ConnectionPoolDataSource 的实现，以及一个用于 JDBC 3 的实现：如 Table 31-1 所示。

两种实现都使用了同样的配置模式。JDBC 要求一个 ConnectionPoolDataSource 通过 JavaBean 属性来实现， 在 Table 31-2 里显示， 因此每个这样的属性都存在获取和设置方法：

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

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

或者，如果使用分号而不是换行做分隔符，那么看起来像：

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

31.10.3. 应用：DataSource

PostgreSQL 包含两个用于 JDBC 2 的 DataSource，还有两个用于 JDBC 3的， 如 Table 31-3 所示。 连接池的实现在客户端调用 close 方法的时候实际上并不关闭连接， 而是把连接返回到一个可用连接的连接池中给其它客户端使用。 这样就避免了任何重复打开和关闭连接造成的开销，并且允许大量的客户端分享相对较少的数据库连接。

这里提供的连接池数据源实现并非世上特性最丰富的。 比如，连接在池本身关闭之前绝对不会关闭；而且也没有办法缩小连接池。 同样，非缺省配置的用户的连接请求无法如池。许多应用服务器提供更加高级的连接池特性，并且使用的是 ConnectionPoolDataSource 实现。

所有实现使用同样的配置模式。JDBC 要求 DataSource 通过 JavaBean 属性配置， 在 Table 31-4 里列出。 因此每种这个属性都有获取和设置属性的方法。

连接池实现要求一些额外的配置属性，它们在 Table 31-5 显示。

Example 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();
    // 使用连接
} catch (SQLException e) {
    // 记录错误
} finally {
    if (con != null) {
        try { con.close(); } catch (SQLException e) {}
    }
}

31.10.4. 数据源和 JNDI

所有 ConnectionPoolDataSource 和 DataSource 实现都可以存储在 JNDI 里。在非连接池的实现中， 每次从 JNDI 中检索对象都将创建一个新的实例， 带有和存储的实例同样的设置。对于连接池实现而言，同一个实例是在可得的情况下检索出来的（也就是说，没有其它 JVM 从 JNDI 中检索连接池），否则就创建同样设置的新的实例。

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

在应用服务器环境，应用可以在 JNDI 中存储 DataSource， 这样它就不用制作一个指向 DataSource 的引用提供给 所有可能需要的应用组件使用它。一个这方面的例子在 Example 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();
    // 使用连接
} catch (SQLException e) {
    // 记录错误
} catch (NamingException e) {
    // 在 JNDI 里没有找到 DataSource
} finally {
    if (con != null) {
        try { con.close(); } catch (SQLException e) {}
    }
}