Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

1
2
3
4
5
6
package hello;
import java.sql.*;
import javax.sql.*;
import org.firebirdsql.pool.*;
public class HelloConnectionPool {
}
public static void main(String[] args) throws Exception {
}
org.firebirdsql.pool.FBConnectionPoolDataSource pool =
new org.firebirdsql.pool.FBConnectionPoolDataSource();
pool.setMaxPoolSize(5);
pool.setMinPoolSize(2);
pool.setMaxStatements(10);
pool.setMaxIdleTime(30 * 60 * 60);
pool.setDatabase("localhost/3050:C:/db/employee.fdb");
pool.setUser("SYSDBA");
pool.setPassword("masterkey");
// obtain a physical connection to the database
PooledConnection pooledCon = pool.getPooledConnection();
// obtain a wrapped connection
Connection connection = pooledCon.getConnection();
try {
// do something here...
} finally {
}
// release the connection back to pool
connection.close();
Illustration 2.8.: Example of instantiating and using the javax.sql.ConnectionPoolDataSource
implementation
The code on Illustration 2.8 we perform the following steps:
1. Create a connection pool object. In this example we create instance
implementing the javax.sql.ConnectionPoolDataSource interface.
2. Now we specify the pooling properties: maximum of 5 physical connections,
with minimum of 2, and each connection will maintain a cache of 10 prepared
statements of the same type (i.e. with the same SQL). Connections in the pool
that are idle for more than half an hour (30 * 60 * 60 seconds) are closed
automatically.
3. After specifying the pooling properties we set the database connection
properties. In our case that is only database path, user name and password, but
also any other supported property can be set here.
4. Having configured the data source, we obtain the physical connection to the
database. Our data source implementation will check the internal connection
pool and will open a new physical connection to the database if the pool is
empty. An instance of javax.sql.PooledConnection represents a physical
connection to the database. Calling the PooledConnection.close() method
Chapter 2. Obtaining a connection 16