Configuring your OpenXava application to go against Firebird is very
simple, basically you have to install the JDBC driver for Firebird and
define correctly the datasource. You don't need to touch any code of your
Configuration for Firebird
We assume you have already
installed and running Firebird.
Download the JDBC driver for Firebird
Download the Firebird driver from here: https://firebirdsql.org/en/jdbc-driver/
You will download a file like this: Jaybird-3.0.6-JDK_1.8.zip
version numbers may vary). Uncompress it to find inside a file called jaybird-full-3.0.6.jar
(or so), this last file, the .jar, is the JDBC controller we're going to
Create a classpath variable in Eclipse
In order you can connect to Firebird from Eclipse we're going to declare a
classpath variable that points to the Firebird JDBC driver, so you can use
it in any project you need easily. For that, in Eclipse go to Window
> Preferences > Java > Build Path > Classpath Variables
where you can add the new variable:
You can call the variable
FIREBIRD_DRIVER instead of DB_DRIVER if your prefer. The path is the path
of the JDBC driver, in our case the path of jaybird-full-3.0.6.jar
we have just downloaded.
Add the DB_DRIVER variable to your Eclipse project
In the project you're going to use Firebird you have to add the variable
declared above. Click with right mouse button on your project and then
choose Properties > Java Build Path > Libraries:
With this we have the driver
available for the development environment.
Add the JDBC driver to the production Tomcat
the driver in production is much easier. Copy jaybird-full-3.0.6.jar
to the lib folder of your Tomcat. Done.
Adjust your datasource definition
For development edit web/META-INF/context.xml of your Eclipse
project, and for production edit conf/context.xml of your Tomcat
to adjust the datasource to point to Firebird, something like this:
<Resource name="jdbc/MyAppDS" auth="Container"
maxTotal="100" maxIdle="20" maxWaitMillis="10000"
The differences are the driverClassName
and the url. The final part of the url, c:/db/myapp.fdb
in this example, is the path to your Firebird database. Obviously, instead
of localhost you should put the address of the server that hosts
Firebird, and also put the correct username and password.
You don't need to touch the default
persistence unit of persistence.xml
), unless you use hibernate.dialect
property in which case just remove hibernate.dialect
However, you have to modify the junit
persistence unit to point to
<!-- JUnit Firebird -->
<property name="hibernate.connection.driver_class" value="org.firebirdsql.jdbc.FBDriver"/>
<property name="hibernate.connection.username" value="root"/>
<property name="hibernate.connection.password" value="ao49fmsk"/>
Adapt the username, password
and url to your Firebird configuration.