Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

81 lines (50 sloc) 2.063 kB

do_hsqldb

Description

An HSQLDB driver for DataObjects.

Features/Problems

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

Synopsis

An example of usage:

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

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

hsqldb://employees
jdbc:hsqldb:mem:test

Requirements

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

Install

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 http://java.sun.com
  • 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: http://wiki.github.com/datamapper/do/hsqldb.

Developers

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

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

See the DataObjects wiki for more comprehensive information: http://wiki.github.com/datamapper/do/jruby.

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 TEST=spec/connection_spec.rb

(Note that the rake task uses a TEST parameter, not SPEC. This is because the Rake::TestTask is used for executing the Bacon specs).

License

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

Jump to Line
Something went wrong with that request. Please try again.