31.10. 接続プールとデータソース

31.10.1. 概要

JDBC API には、接続プール用のクライアントインタフェースおよびサーバインタフェースが用意されています。クライアントインタフェースは javax.sql.DataSource です。これは通常、アプリケーションコードがプールされたデータベース接続を取得するために使用します。サーバインタフェースは javax.sql.ConnectionPoolDataSource で、ほとんどのアプリケーションサーバはこれを使用して PostgreSQL JDBC ドライバとのインタフェースをとります。

アプリケーションサーバ環境では、アプリケーションサーバ構成は通常 PostgreSQL ConnectionPoolDataSource の実装を参照し、アプリケーションコンポーネントコードは通常、アプリケーションサーバ (PostgreSQL ではなく) が提供する DataSource 実装を獲得します。

アプリケーションサーバを使用しない環境では、PostgreSQL は、アプリケーションが直接使用できる DataSource を 2 つ実装しています。1 つの実装が接続プールを実行し、もう 1 つの実装はプールは行わずに DataSource インタフェースを介して単にデータベース接続へのアクセスを提供します。繰り返しますが、これらの実装は、アプリケーションサーバがConnectionPoolDataSource インタフェースをサポートしていない場合を除き、アプリケーションサーバ環境で使用すべきではありません 。

31.10.2. アプリケーションサーバ: ConnectionPoolDataSource

PostgreSQL は、表31-1 に示すように、JDBC 2 用と JDBC 3 用に ConnectionPoolDataSource をそれぞれ 1 つずつ実装しています。

どちらの実装も同じ構成スキーマを使用しています。JDBC では ConnectionPoolDataSource を 表31-2 に示すようにJavaBeanプロパティを使用して構成する必要があります。したがってこれらのプロパティのそれぞれに get メソッドと set メソッドができます。

多くのアプリケーションサーバは、プロパティ形式の構文を使用してこれらのプロパティを構成するので、プロパティをテキストのブロックとして入力することはめずらしくありません。アプリケーションサーバが、単一の全プロパティ入力領域を提供している場合、以下のように列挙されます。

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

改行の代わりにセミコロンが使用される場合は以下にようになります。

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

31.10.3. アプリケーション: DataSource

表31-3に示すように、PostgreSQLは、JDBC2用とJDBC3用にDataSourceをそれぞれ2つずつ実装しています。 クライアントがcloseメソッドを呼び出すと、プールの実装は実際に接続を閉じるのではなく、その接続を使用可能な接続のプールに返して他のクライアントが使用できるようにします。 これにより、接続を何度もオープンしクローズすることによるオーバヘッドをなくすとともに、多数のクライアントが少数のデータベース接続を共有することが可能になります。

このプールデータソース実装は、世の中で最も優れた機能であるとは言えません。例えば、接続はプール自体が閉じるまでは決して閉ざされないので、プールを縮小することができません。また、デフォルトで構成されたユーザ以外のユーザによって要求された接続はプールされません。多くのアプリケーションサーバではより高度なプール機能を提供しており、替わりとして ConnectionPoolDataSource 実装を使用しています。

すべての実装で同じ構成スキーマを使用しています。表31-4 に示すように JDBC では DataSource を JavaBean プロパティを使用して構成する必要があります。したがってこれらのプロパティのそれぞれに 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();
    // 接続を使用する
} catch (SQLException e) {
    // エラーのログを取る
} finally {
    if (con != null) {
        try { con.close(); } catch (SQLException e) {}
    }
}

31.10.4. データソースとJNDI

ConnectionPoolDataSource および DataSource の実装はすべて、JNDI に格納することができます。非プール実装の場合、JNDI からオブジェクトが抽出される度に、格納済みのインスタンスと同じ設定の新しいインスタンスが作成されます。プール実装については、同じインスタンスが使用可能であればそのインスタンスが抽出され（異なる JVM が JNDI からプールを抽出するのではなく）、使用可能でない場合は、同じ設定で新しいインスタンスが作成されます。

アプリケーションサーバ環境では、アプリケーションサーバの DataSource インスタンスは通常 PostgreSQL ConnectionPoolDataSource 実装ではなく、JNDI に格納されます。

アプリケーション環境では、アプリケーションは JNDI に DataSource を格納する場合があります。こうすることにより、アプリケーションは、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();
    // 接続を使用する
} catch (SQLException e) {
    // エラーのログを取る
} catch (NamingException e) {
    // JNDI内にDataSourceが見つからない
} finally {
    if (con != null) {
        try { con.close(); } catch (SQLException e) {}
    }
}