An HSQLDB driver for DataObjects.


This driver implements the DataObjects API for the HSQLDB relational database. This driver is currently provided only for JRuby.


An example of usage:

@connection ="hsqldb://employees")
@reader = @connection.create_command('SELECT * FROM users').execute_reader!

The Connection constructor should be passed either a DataObjects-style URL or JDBC-style URL:



  • JRuby 1.3.1 + (1.4+ recommended)
  • data_objects gem
  • do_jdbc gem (shared library)


To install the gem:

jruby -S gem install do_derby

To compile and install from source:

  • Install the Java Development Kit (provided if you are on a recent version of Mac OS X) from
  • Install a recent version of JRuby. Ensure jruby is in your PATH and/or you have configured the JRUBY_HOME environment variable to point to your JRuby installation.
  • Install data_objects and do_jdbc with jruby -S rake install.
  • Install this driver with jruby -S rake install.

For more information, see the HSQLDB driver wiki page:


Follow the above installation instructions. Additionally, you'll need:

  • rspec gem for running specs.
  • YARD gem for generating documentation.

See the DataObjects wiki for more comprehensive information:

To run specs:

jruby -S rake spec

To run specs without compiling extensions first:

jruby -S rake spec_no_compile

To run individual specs:

jruby -S rake spec SPEC=spec/connection_spec.rb


This code is licensed under an MIT (X11) License. Please see the accompanying LICENSE file.