sam / do fork watch download tarball
public
Rubygem
Description: DataObjects
Homepage: http://rubyforge.org/projects/dorb
Clone URL: git://github.com/sam/do.git 
Adding files to manifest for do_jdbc
Bernerd Schaefer (author)
Mon Jul 14 13:16:57 -0700 2008
commit  b51c5ae8443f09bf85544b3fe67de62df8d67d81
tree    4f3174cfdf602ec159f04c648e19c92903be841e
parent  5694103f5bdeee117f1a307f3206b99fde4d3960
do /
name age
history
message
file .gitignore Mon Jun 09 03:02:56 -0700 2008 Added README.markdown to repo root [myabc]
file README.markdown Mon Jun 09 03:02:56 -0700 2008 Added README.markdown to repo root [myabc]
file Rakefile Sat May 17 12:26:15 -0700 2008 Updated platform testing code to add mingw [myabc]
directory data_objects/ Mon Jul 14 12:59:04 -0700 2008 Adding hoe tasks to do/tasks to be shared by al... [Bernerd Schaefer]
directory do_derby/ Mon Jul 14 13:06:48 -0700 2008 Setting up do_derby for hoe [Bernerd Schaefer]
directory do_hsqldb/ Sun Jun 15 12:52:36 -0700 2008 Moved several HSQLDB-specific specs out of do_j... [myabc]
directory do_jdbc-support/ Mon Jul 14 13:16:57 -0700 2008 Adding files to manifest for do_jdbc [Bernerd Schaefer]
directory do_mysql/ Mon Jul 14 12:59:04 -0700 2008 Adding hoe tasks to do/tasks to be shared by al... [Bernerd Schaefer]
directory do_postgres/ Fri Jul 11 11:31:49 -0700 2008 Fixed logging_spec to use DataObjects::Connecti... [bernerdschaefer]
directory do_sqlite3/ Wed Jul 02 09:04:37 -0700 2008 Ported do_postgres timestamping to do_sqlite3 [bernerdschaefer]
directory jdbc_drivers/ Fri Jun 13 06:17:49 -0700 2008 Added H2, MySQL JDBC Drivers [myabc]
directory tasks/ Mon Jul 14 12:59:39 -0700 2008 Cleaning up hoe.rb [Bernerd Schaefer]
README.markdown

DataObjects README

DataObjects.rb is an attempt to rewrite existing Ruby database drivers to conform to one, standard interface.

At present, PostgreSQL, MySQL and SQLite drivers are available. More drivers are currently under development. If you feel like living on the edge, install and test drivers directly from this repository.

Introduction

To connect and send queries to databases, DataObjects relies on native extensions. Native extensions have been written in both C (for the Ruby MRI platform) and Java (for the JRuby platform). Individual drivers may include extensions for both Ruby MRI and JRuby, or one or the other.

C extensions have been written using according to each vendor API. Java drivers use the standard JDBC API. Although there are dialectical differences between the Java drivers, the JDBC API ensures a reasonable amount of commonality. As such, the Java extensions rely on a common do_jdbc_support gem, which wraps code that is common to all of the Java extensions.

Installation

To install a driver from the repository cd into the driver directory and use the provided rake install task to install for the default platform.

If a driver includes extensions for both MRI or JRuby platforms, you can be explicit about which platform you wish to install the extension for as follows:

rake install:mri
jruby -S rake install:jruby

Copyright and Licensing

Please see the copyright notices in each individual driver README or LICENSE file. Java-based drivers bundle JDBC driver JAR files, which may be provided under a license that is more restrictive than the MIT License used by the data_objects gem itself.