Database Drivers page of the Tools|Enterprise Setup dialog box
This is a feature of JBuilder Professional and Enterprise.
Select Tools|Enterprise Setup to display the Enterprise Setup dialog box. Select the Database Drivers tab to display the Database Drivers page. Use this page to add a new database driver to JBuilder.
After installing a JDBC driver following the manufacturer's instructions, use the steps below to set it up in JBuilder.
Creating the .library and .config files
There are three steps to adding a database driver to JBuilder:
- Creating a library file which contains the driver's classes, typically a JAR file, and any other auxiliary files such as documentation and source.
- Deriving a .config file from the library file which JBuilder adds to its classpath at start-up.
- Adding the new library to your project, or to the Default project if you want it available for all new projects.
The first two steps can be accomplished from the Database Drivers page:
- Open JBuilder and choose Tools|Enterprise Setup. Click the Database Drivers tab which displays .config files for all the currently known database drivers.
- Click Add to add a new driver, then New to create a new library file for the driver. The library file is used to add the driver to the required libraries list for projects.
Note: You can also create a new library under Tools|Configure Libraries, but since you would then have to use Enterprise Setup to derive the .config file, it is simpler to do it all here.
- Type a name and select a location for the new file in the Create New Library dialog box.
- Click Add, and browse to the location of the driver. You can select the directory containing the driver and all it's support files, or you can select just the archive file for the driver. Either will work. JBuilder will extract the information it needs.
- Click OK to close the file browser. This displays the new library at the bottom of the library list and selects it.
- Click OK. JBuilder creates a new .library file in the JBuilder
/lib
directory with the name you specified (for example, InterClient.library
). It also returns you to the Database Drivers page which displays the name of the corresponding .config file in the list which will be derived from the library file (for example, InterClient.config
).
- Select the new .config file in the database driver list and click OK. This places the .config file in the JBuilder
/lib/ext
directory.
- Close and restart JBuilder so the changes to the database drivers will take effect, and the new driver will be put on the JBuilder classpath.
Important: If you make changes to the .library file after the .config file has been derived, you must re-generate the .config file using Enterprise Setup, then restart JBuilder.
Now that JBuilder can see the database driver, you must add the database driver library to the Required Libraries list in Project|Properties, or Project|Default Properties. See Adding the JDBC driver to projects.