Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

then name-value pairs separated with “&”. Code in Illustration 2.6 is equivalent to
the previous example.
import java.sql.*;
...
Class.forName("org.firebirdsql.jdbc.FBDriver");
Connection connection = DriverManager.getConnection(
"jdbc:firebirdsql:localhost/3050:C:/employee.gdb" +
"?encoding=UNICODE_FSS",
"SYSDBA",
"masterkey");
Illustration 2.5: Example of specifying extended properties in JDBC URL.
Obtaining a connection via javax.sql.DataSource
JDBC 2.0 specification introduced a new mechanism to obtain database
connection without requiring the application to know any specifics of the
underlying JDBC driver. The application is required to know a logical name under
which application can find an instance of the javax.sql.DataSource interface
using Java Naming and Directory Interface (JNDI). This is a common way to
obtain connections in web and application servers.
In order to obtain a connection via DataSource object, you can use code showed
on Illustration 2.6. This code assumes that you have correctly configured JNDI
properties. For more information about configuring JNDI please refer to the
documentation provided with your web or application server.
package hello;
import java.sql.*;
import javax.sql.*;
import javax.naming.*;
public class HelloServerJNDI {
}
public static void main(String[] args) throws Exception {
}
InitialContext ctx = new InitialContext();
DataSource ds = (DataSource)ctx.lookup("jdbc/SomeDB");
Connection connection = ds.getConnection();
try {
// do something here...
} finally {
connection.close();
}
Illustration 2.6: Typical way to obtain JDBC connection via JNDI.
Usually binding between the DataSource object and its JNDI name happens in
the configuration of your web or application server. However under some
circumstances (e.g. you are developing your own JNDI-enabled application
server/framework) you have to do this yourself. You can use the code snippet for
Chapter 2. Obtaining a connection 12