Jaybird 2.1 JDBC driver Java Programmer's Manual - Firebird

connection that the application wants to obtain, in our case it is a connection to a
Firebird database. Example of obtaining the connection is shown on Illustration
2.2.
package hello;
import java.sql.*;
public class HelloServer {
}
public static void main(String[] args) throws Exception {
}
Class.forName("org.firebirdsql.jdbc.FBDriver");
Connection connection = DriverManager.getConnection(
"jdbc:firebirdsql:localhost/3050:c:/db/employee.fdb",
"SYSDBA", "masterkey");
// do something here
Illustration 2.2: Simple example shows how to obtain JDBC connection.
The first line of this code is important – it tells JVM to load the Jaybird 2.1 JDBC
driver. According to JDBC specification, at this point driver registers itself in
java.sql.DriverManager and tells it for which protocol it is responsible for.
There are two ways to register JDBC driver:
• Possibility 1. The application loads the driver's class. The JDBC specification
requires that during class initialization the driver performs the registration
itself.
Class.forName("org.firebirdsql.jdbc.FBDriver");
• Possibility 2. The JDBC driver is listed in a jdbc.drivers system property.
For example in your ~/.hotjava/properties file you can specify following
line:
jdbc.drivers=foo.Driver:org.firebirdsql.jdbc.FBDriver
Alternatively you can specify the value of this property during JVM startup:
java
-Djdbc.drivers=org.firebirdsql.jdbc.FBDriver
-classpath jaybird-full-2.1.6.jar;C:/myproject/classes
my.company.SomeJavaExample
The second statement of the example tells the java.sql.DriverManager to open
database connection to the Firebird server running on the host where Java code is
executed, and the path to the database is c:/database/employee.fdb.
Database specification consists of the name of the server where the database
server resides, optionally you can specify a port to which the driver will connect
(by default port 3050 is used). The server name can be specified either using its IP
address (for example 192.168.0.5) or using its DNS name (for example fbserver.mycompany.com
or just fb-server).
After the server name and port, path to the database is specified. The format in
which the path is specified depends on the platform where the Firebird server
Chapter 2. Obtaining a connection 10