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.FBWrappingDataSource pool =
new org.firebirdsql.pool.FBWrappingDataSource();
pool.setMaxPoolSize(5);
pool.setMinPoolSize(2);
pool.setMaxStatements(10);
pool.setMaxIdleTime(30 * 60 * 60);
pool.setDatabase("localhost/3050:C:/db/employee.gdb");
pool.setUser("SYSDBA");
pool.setPassword("masterkey");
// no step 4 as in previous example
// obtain a wrapped connection
Connection connection = pool.getConnection();
try {
// do something here...
} finally {
}
// release the connection back to pool
connection.close();
Illustration 2.11.: Example of instantiating and using the javax.sql.DataSource implementation
This class is called “wrapping” because it wraps the connection pool and
delegates all calls to the underlying implementation. As you can see, the code is
very similar to the Illustration 2.8, only few places are different. Please note, that
there is no longer Step 4, the wrapper does this automatically in
getConnection() method used in Step 5.
The javax.sql.XADataSource implementation
JDBC 2.0 specification introduced the javax.sql.XADataSource interface that
should be used to access connections that can participate in distributed
transactions with JTA-compatible transaction coordinator. This gives applications
possibility to use two-phase commit to synchronize multiple resource managers.
Jaybird 2.1 does not have separate class, but FBConnectionPoolDataSource also
implements the javax.sql.XADataSource interface. For information how to
instantiate this class please see Illustration 2.8.
Applications usually do not need to access the javax.sql.XADataSource directly,
this is task for a J2EE container. Chapter XXX contains more detailed description
of distributed transactions and contains code to access and manipulate connections
that participate in distributed transactions.
Chapter 2. Obtaining a connection 20