do_oracle 0.10.1-x86-mingw32

data/ChangeLog.markdown

@@ -0,0 +1,3 @@
+## 0.10.1 (unreleased, in git)
+
+Initial release.

data/INSTALL.markdown

@@ -0,0 +1,5 @@
+INSTALLATION
+============
+
+
+<http://blog.rayapps.com/2009/09/14/how-to-install-oracle-database-10g-on-mac-os-x-snow-leopard/>

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 - 2010 Yehuda Katz, Dirkjan Bussink, Raimonds Simanovskis
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,106 @@
+# do_oracle
+
+* <http://dataobjects.info>
+
+## Description
+
+An Oracle driver for DataObjects.
+
+## Features/Problems
+
+This driver implements the DataObjects API for the Oracle relational database.
+
+## Synopsis
+
+An example of usage:
+
+    @connection = DataObjects::Connection.new("oracle://employees")
+    @reader = @connection.create_command('SELECT * FROM users').execute_reader
+    @reader.next!
+
+In the future, the `Connection` constructor will be able to be passed either a
+DataObjects-style URL or JDBC style URL, when using do\_oracle on JRuby. However,
+this feature is not currently working reliably and is a known issue.
+
+## Requirements
+
+This driver is provided for the following platforms:
+ * Ruby MRI (1.8.6/7), 1.9: tested on Linux, Mac OS X and Windows platforms.
+ * JRuby 1.3.1 + (1.4+ recommended).
+ * Rubinius (experimental).
+
+Additionally you should have the following prerequisites:
+ * `data_objects` gem
+ * `do_jdbc` gem (shared library), if running on JRuby.
+
+## Install
+
+To install the gem:
+
+    gem install do_oracle
+
+To compile and install from source:
+
+* For MRI/Rubinius extensions:
+  * Install the `gcc` compiler. On OS X, you should install XCode tools. On
+    Ubuntu, run `apt-get install build-essential`.
+  * THESE INSTRUCTIONS ARE CURRENTLY INCOMPLETE!
+
+ * For JRuby extensions:
+   * 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`.
+
+ * Then, install this driver with `(jruby -S) rake install`.
+
+For more information, see the Oracle driver wiki page:
+<http://wiki.github.com/datamapper/do/oracle>.
+
+## 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 on installing and
+contributing to the JRuby-variant of this driver:
+<http://wiki.github.com/datamapper/do/jruby>.
+
+### install oracle jdbc driver in maven
+
+$ mvn install
+will produce an error and give you message like (maybe with a different version). please follow these instructions to install the
+
+  Try downloading the file manually from:
+      http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html
+
+  Then, install it using the command:
+      mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc14 -Dversion=10.2.0.3.0 -Dpackaging=jar -Dfile=/path/to/file
+
+  Alternatively, if you host your own repository you can deploy the file there:
+      mvn deploy:deploy-file -DgroupId=com.oracle -DartifactId=ojdbc14 -Dversion=10.2.0.3.0 -Dpackaging=jar -Dfile=/path/to/file -Durl=[url] -DrepositoryId=[id]
+
+### Specs
+
+To run specs:
+
+    rake spec
+
+To run specs without compiling extensions first:
+
+    rake spec_no_compile
+
+To run individual specs:
+
+    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.

data/Rakefile

@@ -0,0 +1,65 @@
+require 'pathname'
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+
+ROOT = Pathname(__FILE__).dirname.expand_path
+
+require ROOT + 'lib/do_oracle/version'
+
+JRUBY    = RUBY_PLATFORM =~ /java/
+IRONRUBY = defined?(RUBY_ENGINE) && RUBY_ENGINE == 'ironruby'
+WINDOWS  = Gem.win_platform? || (JRUBY && ENV_JAVA['os.name'] =~ /windows/i)
+SUDO     = WINDOWS ? '' : ('sudo' unless ENV['SUDOLESS'])
+BINARY_VERSION = '10.2.0.4.0'
+
+CLEAN.include(%w[ {tmp,pkg}/ **/*.{o,so,bundle,jar,log,a,gem,dSYM,obj,pdb,exp,DS_Store,rbc,db} ext/do_oracle/Makefile ext-java/target ])
+
+begin
+  gem 'jeweler', '~> 1.4'
+  require 'jeweler'
+
+  Jeweler::Tasks.new do |gem|
+    gem.name        = 'do_oracle'
+    gem.version     = DataObjects::Oracle::VERSION
+    gem.summary     = 'DataObjects Oracle Driver'
+    gem.description = 'Implements the DataObjects API for Oracle'
+    gem.platform    = Gem::Platform::RUBY
+    gem.files       = Dir['lib/**/*.rb', 'spec/**/*.rb', 'tasks/**/*.rake',
+                          'ext/**/*.{rb,c,h}', 'LICENSE', 'Rakefile',
+                          '*.{markdown,rdoc,txt,yml}']
+    gem.extra_rdoc_files = FileList['README*', 'ChangeLog*', 'INSTALL.markdown',
+                                    'LICENSE']
+    gem.test_files  = FileList['spec/**/*.rb']
+
+    # rake-compiler should generate gemspecs for other platforms (e.g. 'java')
+    # and modify dependencies and extensions appropriately
+    gem.extensions << 'ext/do_oracle/extconf.rb'
+
+    gem.add_dependency 'data_objects', DataObjects::Oracle::VERSION
+    gem.add_dependency 'ruby-oci8',    '~>2.0'
+
+    gem.add_development_dependency 'bacon',         '~>1.1'
+    gem.add_development_dependency 'rake-compiler', '~>0.7'
+
+    gem.has_rdoc = false
+    gem.rubyforge_project = 'dorb'
+    gem.authors     = [ 'Raimonds Simanovskis' ]
+    gem.email       = 'raimonds.simanovskis@gmail.com'
+  end
+
+  if JRUBY
+    Rake::Task['build'].clear_actions   if Rake::Task.task_defined?('build')
+    Rake::Task['install'].clear_actions if Rake::Task.task_defined?('install')
+    task :build => [ :java, :gem ]
+    task :install do
+      sh "#{Config::CONFIG['RUBY_INSTALL_NAME']} -S gem install pkg/do_oracle-#{DataObjects::Oracle::VERSION}-java.gem"
+    end
+  end
+
+  Jeweler::GemcutterTasks.new
+
+  FileList['tasks/**/*.rake'].each { |task| import task }
+rescue LoadError
+  puts 'Jeweler (or a dependency) not available. Install it with: gem install jeweler'
+end

data/ext/do_oracle/do_oracle.c

@@ -0,0 +1,903 @@
+#ifdef _WIN32
+#define do_int64 signed __int64
+#else
+#define do_int64 signed long long int
+#endif
+
+#include <ruby.h>
+#include <string.h>
+#include <math.h>
+#include <ctype.h>
+#include <time.h>
+
+#define ID_CONST_GET rb_intern("const_get")
+
+#define RUBY_STRING(char_ptr) rb_str_new2(char_ptr)
+#define TAINTED_STRING(name, length) rb_tainted_str_new(name, length)
+#define CONST_GET(scope, constant) (rb_funcall(scope, ID_CONST_GET, 1, rb_str_new2(constant)))
+#define ORACLE_CLASS(klass, parent) (rb_define_class_under(mOracle, klass, parent))
+#define DEBUG(value) data_objects_debug(value)
+#define RUBY_CLASS(name) rb_const_get(rb_cObject, rb_intern(name))
+
+#ifndef RSTRING_PTR
+#define RSTRING_PTR(s) (RSTRING(s)->ptr)
+#endif
+
+#ifndef RSTRING_LEN
+#define RSTRING_LEN(s) (RSTRING(s)->len)
+#endif
+
+#ifndef RARRAY_LEN
+#define RARRAY_LEN(a) RARRAY(a)->len
+#endif
+
+
+// To store rb_intern values
+static ID ID_NEW;
+static ID ID_NEW_DATE;
+static ID ID_LOGGER;
+static ID ID_DEBUG;
+static ID ID_LEVEL;
+static ID ID_TO_S;
+static ID ID_RATIONAL;
+
+static ID ID_NAME;
+
+static ID ID_NUMBER;
+static ID ID_VARCHAR2;
+static ID ID_CHAR;
+static ID ID_DATE;
+static ID ID_TIMESTAMP;
+static ID ID_TIMESTAMP_TZ;
+static ID ID_TIMESTAMP_LTZ;
+static ID ID_CLOB;
+static ID ID_BLOB;
+static ID ID_LONG;
+static ID ID_RAW;
+static ID ID_LONG_RAW;
+static ID ID_BFILE;
+static ID ID_BINARY_FLOAT;
+static ID ID_BINARY_DOUBLE;
+
+static ID ID_TO_A;
+static ID ID_TO_I;
+static ID ID_TO_S;
+static ID ID_TO_F;
+
+static ID ID_UTC_OFFSET;
+static ID ID_FULL_CONST_GET;
+
+static ID ID_PARSE;
+static ID ID_FETCH;
+static ID ID_TYPE;
+static ID ID_EXECUTE;
+static ID ID_EXEC;
+
+static ID ID_SELECT_STMT;
+static ID ID_COLUMN_METADATA;
+static ID ID_PRECISION;
+static ID ID_SCALE;
+static ID ID_BIND_PARAM;
+static ID ID_ELEM;
+static ID ID_READ;
+
+static ID ID_CLOSE;
+static ID ID_LOGOFF;
+
+static VALUE mExtlib;
+static VALUE mDO;
+static VALUE cDO_Quoting;
+static VALUE cDO_Connection;
+static VALUE cDO_Command;
+static VALUE cDO_Result;
+static VALUE cDO_Reader;
+
+static VALUE rb_cDate;
+static VALUE rb_cDateTime;
+static VALUE rb_cBigDecimal;
+static VALUE rb_cByteArray;
+
+static VALUE cOCI8;
+static VALUE cOCI8_Cursor;
+static VALUE cOCI8_BLOB;
+static VALUE cOCI8_CLOB;
+
+static VALUE mOracle;
+static VALUE cConnection;
+static VALUE cCommand;
+static VALUE cResult;
+static VALUE cReader;
+
+static VALUE eArgumentError;
+static VALUE eSQLError;
+static VALUE eConnectionError;
+static VALUE eDataError;
+
+static void data_objects_debug(VALUE string, struct timeval* start) {
+  struct timeval stop;
+  char *message;
+
+  char *query = RSTRING_PTR(string);
+  int length  = RSTRING_LEN(string);
+  char total_time[32];
+  do_int64 duration = 0;
+
+  VALUE logger = rb_funcall(mOracle, ID_LOGGER, 0);
+  int log_level = NUM2INT(rb_funcall(logger, ID_LEVEL, 0));
+
+  if (0 == log_level) {
+    gettimeofday(&stop, NULL);
+
+    duration = (stop.tv_sec - start->tv_sec) * 1000000 + stop.tv_usec - start->tv_usec;
+
+    snprintf(total_time, 32, "%.6f", duration / 1000000.0);
+    message = (char *)calloc(length + strlen(total_time) + 4, sizeof(char));
+    snprintf(message, length + strlen(total_time) + 4, "(%s) %s", total_time, query);
+    rb_funcall(logger, ID_DEBUG, 1, rb_str_new(message, length + strlen(total_time) + 3));
+    free(message);
+  }
+}
+
+static char * get_uri_option(VALUE query_hash, char * key) {
+  VALUE query_value;
+  char * value = NULL;
+
+  if(!rb_obj_is_kind_of(query_hash, rb_cHash)) { return NULL; }
+
+  query_value = rb_hash_aref(query_hash, RUBY_STRING(key));
+
+  if (Qnil != query_value) {
+    value = StringValuePtr(query_value);
+  }
+
+  return value;
+}
+
+/* ====== Time/Date Parsing Helper Functions ====== */
+static void reduce( do_int64 *numerator, do_int64 *denominator ) {
+  do_int64 a, b, c;
+  a = *numerator;
+  b = *denominator;
+  while ( a != 0 ) {
+    c = a; a = b % a; b = c;
+  }
+  *numerator = *numerator / b;
+  *denominator = *denominator / b;
+}
+
+// Generate the date integer which Date.civil_to_jd returns
+static int jd_from_date(int year, int month, int day) {
+  int a, b;
+  if ( month <= 2 ) {
+    year -= 1;
+    month += 12;
+  }
+  a = year / 100;
+  b = 2 - a + (a / 4);
+  return floor(365.25 * (year + 4716)) + floor(30.6001 * (month + 1)) + day + b - 1524;
+}
+
+// Creates a Rational for use as a Timezone offset to be passed to DateTime.new!
+static VALUE seconds_to_offset(do_int64 num) {
+  do_int64 den = 86400;
+  reduce(&num, &den);
+  return rb_funcall(rb_mKernel, ID_RATIONAL, 2, rb_ll2inum(num), rb_ll2inum(den));
+}
+
+static VALUE timezone_to_offset(int hour_offset, int minute_offset) {
+  do_int64 seconds = 0;
+
+  seconds += hour_offset * 3600;
+  seconds += minute_offset * 60;
+
+  return seconds_to_offset(seconds);
+}
+
+// Implementation using C functions
+
+static VALUE parse_date(VALUE r_value) {
+  VALUE time_array;
+  int year, month, day;
+  int jd, ajd;
+  VALUE rational;
+
+  if (rb_obj_class(r_value) == rb_cTime) {
+    time_array = rb_funcall(r_value, ID_TO_A, 0);
+    year = NUM2INT(rb_ary_entry(time_array, 5));
+    month = NUM2INT(rb_ary_entry(time_array, 4));
+    day = NUM2INT(rb_ary_entry(time_array, 3));
+
+    jd = jd_from_date(year, month, day);
+
+    // Math from Date.jd_to_ajd
+    ajd = jd * 2 - 1;
+    rational = rb_funcall(rb_mKernel, ID_RATIONAL, 2, INT2NUM(ajd), INT2NUM(2));
+
+    return rb_funcall(rb_cDate, ID_NEW_DATE, 3, rational, INT2NUM(0), INT2NUM(2299161));
+
+  } else if (rb_obj_class(r_value) == rb_cDate) {
+    return r_value;
+
+  } else if (rb_obj_class(r_value) == rb_cDateTime) {
+    rational = rb_iv_get(r_value, "@ajd");
+    return rb_funcall(rb_cDate, ID_NEW_DATE, 3, rational, INT2NUM(0), INT2NUM(2299161));
+    
+  } else {
+    // Something went terribly wrong
+    rb_raise(eDataError, "Couldn't parse date from class %s object", rb_obj_classname(r_value));
+  }
+}
+
+// Implementation using C functions
+
+static VALUE parse_date_time(VALUE r_value) {
+  VALUE ajd, offset;
+
+  VALUE time_array;
+  int year, month, day, hour, min, sec, hour_offset, minute_offset;
+  // int usec;
+  int jd;
+  do_int64 num, den;
+
+  long int gmt_offset;
+  int is_dst;
+
+  // time_t rawtime;
+  // struct tm * timeinfo;
+
+  // int tokens_read, max_tokens;
+
+  if (rb_obj_class(r_value) == rb_cDateTime) {
+    return r_value;
+  } else if (rb_obj_class(r_value) == rb_cTime) {
+    time_array = rb_funcall(r_value, ID_TO_A, 0);
+    year = NUM2INT(rb_ary_entry(time_array, 5));
+    month = NUM2INT(rb_ary_entry(time_array, 4));
+    day = NUM2INT(rb_ary_entry(time_array, 3));
+    hour = NUM2INT(rb_ary_entry(time_array, 2));
+    min = NUM2INT(rb_ary_entry(time_array, 1));
+    sec = NUM2INT(rb_ary_entry(time_array, 0));
+
+    is_dst = rb_ary_entry(time_array, 8) == Qtrue ? 3600 : 0;
+    gmt_offset = NUM2INT(rb_funcall(r_value, ID_UTC_OFFSET, 0 ));
+
+    if ( is_dst > 0 )
+      gmt_offset -= is_dst;
+
+    hour_offset = -(gmt_offset / 3600);
+    minute_offset = -(gmt_offset % 3600 / 60);
+
+    jd = jd_from_date(year, month, day);
+
+    // Generate ajd with fractional days for the time
+    // Extracted from Date#jd_to_ajd, Date#day_fraction_to_time, and Rational#+ and #-
+    num = (hour * 1440) + (min * 24);
+
+    // Modify the numerator so when we apply the timezone everything works out
+    num -= (hour_offset * 1440) + (minute_offset * 24);
+
+    den = (24 * 1440);
+    reduce(&num, &den);
+
+    num = (num * 86400) + (sec * den);
+    den = den * 86400;
+    reduce(&num, &den);
+
+    num = (jd * den) + num;
+
+    num = num * 2;
+    num = num - den;
+    den = den * 2;
+
+    reduce(&num, &den);
+
+    ajd = rb_funcall(rb_mKernel, ID_RATIONAL, 2, rb_ull2inum(num), rb_ull2inum(den));
+    offset = timezone_to_offset(hour_offset, minute_offset);
+
+    return rb_funcall(rb_cDateTime, ID_NEW_DATE, 3, ajd, offset, INT2NUM(2299161));
+  } else {
+    // Something went terribly wrong
+    rb_raise(eDataError, "Couldn't parse datetime from class %s object", rb_obj_classname(r_value));
+  }
+
+}
+
+static VALUE parse_time(VALUE r_value) {
+  if (rb_obj_class(r_value) == rb_cTime) {
+    return r_value;
+  } else {
+    // Something went terribly wrong
+    rb_raise(eDataError, "Couldn't parse time from class %s object", rb_obj_classname(r_value));
+  }  
+}
+
+static VALUE parse_boolean(VALUE r_value) {
+  if (TYPE(r_value) == T_FIXNUM || TYPE(r_value) == T_BIGNUM) {
+    return NUM2INT(r_value) >= 1 ? Qtrue : Qfalse;
+  } else if (TYPE(r_value) == T_STRING) {
+    char value = NIL_P(r_value) || RSTRING_LEN(r_value) == 0 ? '\0' : *(RSTRING_PTR(r_value));
+    return value == 'Y' || value == 'y' || value == 'T' || value == 't' ? Qtrue : Qfalse;
+  } else {
+    // Something went terribly wrong
+    rb_raise(eDataError, "Couldn't parse boolean from class %s object", rb_obj_classname(r_value));
+  }
+}
+
+/* ===== Typecasting Functions ===== */
+
+static VALUE infer_ruby_type(VALUE type, VALUE precision, VALUE scale) {
+  ID type_id = SYM2ID(type);
+  
+  if (type_id == ID_NUMBER)
+    return scale != Qnil && NUM2INT(scale) == 0 ?
+            (NUM2INT(precision) == 1 ? rb_cTrueClass : rb_cInteger) : rb_cBigDecimal;
+  else if (type_id == ID_VARCHAR2 || type_id == ID_CHAR || type_id == ID_CLOB || type_id == ID_LONG)
+    return rb_cString;
+  else if (type_id == ID_DATE)
+    // return rb_cDateTime;
+    // by default map DATE type to Time class as it is much faster than DateTime class
+    return rb_cTime;
+  else if (type_id == ID_TIMESTAMP || type_id == ID_TIMESTAMP_TZ || type_id == ID_TIMESTAMP_LTZ)
+    // return rb_cDateTime;
+    // by default map TIMESTAMP type to Time class as it is much faster than DateTime class
+    return rb_cTime;
+  else if (type_id == ID_BLOB || type_id == ID_RAW || type_id == ID_LONG_RAW || type_id == ID_BFILE)
+    return rb_cByteArray;
+  else if (type_id == ID_BINARY_FLOAT || type_id == ID_BINARY_DOUBLE)
+    return rb_cFloat;
+  else
+    return rb_cString;
+}
+
+static VALUE typecast(VALUE r_value, const VALUE type) {
+  VALUE r_data;
+  
+  if (type == rb_cInteger) {
+    return TYPE(r_value) == T_FIXNUM || TYPE(r_value) == T_BIGNUM ? r_value : rb_funcall(r_value, ID_TO_I, 0);
+
+  } else if (type == rb_cString) {
+    if (TYPE(r_value) == T_STRING)
+      return r_value;
+    else if (rb_obj_class(r_value) == cOCI8_CLOB)
+      return rb_funcall(r_value, ID_READ, 0);
+    else
+      return rb_funcall(r_value, ID_TO_S, 0);
+
+  } else if (type == rb_cFloat) {
+    return TYPE(r_value) == T_FLOAT ? r_value : rb_funcall(r_value, ID_TO_F, 0);
+
+  } else if (type == rb_cBigDecimal) {
+    VALUE r_string = TYPE(r_value) == T_STRING ? r_value : rb_funcall(r_value, ID_TO_S, 0);
+    return rb_funcall(rb_cBigDecimal, ID_NEW, 1, r_string);
+
+  } else if (type == rb_cDate) {
+    return parse_date(r_value);
+
+  } else if (type == rb_cDateTime) {
+    return parse_date_time(r_value);
+
+  } else if (type == rb_cTime) {
+    return parse_time(r_value);
+
+  } else if (type == rb_cTrueClass) {
+    return parse_boolean(r_value);
+
+  } else if (type == rb_cByteArray) {
+    if (rb_obj_class(r_value) == cOCI8_BLOB)
+      r_data = rb_funcall(r_value, ID_READ, 0);
+    else
+      r_data = r_value;
+    return rb_funcall(rb_cByteArray, ID_NEW, 1, r_data);
+
+  } else if (type == rb_cClass) {
+    return rb_funcall(mDO, ID_FULL_CONST_GET, 1, r_value);
+
+  // TODO: where are tests for this mapping?
+  } else if (type == rb_cObject) {
+    if (rb_obj_class(r_value) == cOCI8_CLOB)
+      return rb_marshal_load(rb_funcall(r_value, ID_READ, 0));
+    else
+      return rb_marshal_load(r_value);
+
+  } else if (type == rb_cNilClass) {
+    return Qnil;
+
+  } else {
+    if (rb_obj_class(r_value) == cOCI8_CLOB)
+      return rb_funcall(r_value, ID_READ, 0);
+    else
+      return r_value;
+  }
+
+}
+
+static VALUE typecast_bind_value(VALUE oci8_conn, VALUE r_value) {
+  VALUE r_class = rb_obj_class(r_value);
+  // replace nil value with '' as otherwise OCI8 cannot get bind variable type
+  // '' will be inserted as NULL by Oracle
+  if (NIL_P(r_value))
+    return RUBY_STRING("");
+  else if (r_class == rb_cString)
+    // if string is longer than 4000 characters then convert to CLOB
+    return RSTRING_LEN(r_value) <= 4000 ? r_value : rb_funcall(cOCI8_CLOB, ID_NEW, 2, oci8_conn, r_value);
+  else if (r_class == rb_cBigDecimal)
+    return rb_funcall(r_value, ID_TO_S, 1, RUBY_STRING("F"));
+  else if (r_class == rb_cTrueClass)
+    return INT2NUM(1);
+  else if (r_class == rb_cFalseClass)
+    return INT2NUM(0);
+  else if (r_class == rb_cByteArray)
+    return rb_funcall(cOCI8_BLOB, ID_NEW, 2, oci8_conn, r_value);
+  else if (r_class == rb_cClass)
+    return rb_funcall(r_value, ID_TO_S, 0);
+  else
+    return r_value;
+}
+
+/* ====== Public API ======= */
+static VALUE cConnection_dispose(VALUE self) {
+  VALUE oci8_conn = rb_iv_get(self, "@connection");
+
+  if (Qnil == oci8_conn)
+    return Qfalse;
+
+  rb_funcall(oci8_conn, ID_LOGOFF, 0);
+
+  rb_iv_set(self, "@connection", Qnil);
+
+  return Qtrue;
+}
+
+static VALUE cCommand_set_types(int argc, VALUE *argv, VALUE self) {
+  VALUE type_strings = rb_ary_new();
+  VALUE array = rb_ary_new();
+
+  int i, j;
+
+  for ( i = 0; i < argc; i++) {
+    rb_ary_push(array, argv[i]);
+  }
+
+  for (i = 0; i < RARRAY_LEN(array); i++) {
+    VALUE entry = rb_ary_entry(array, i);
+    if(TYPE(entry) == T_CLASS) {
+      rb_ary_push(type_strings, entry);
+    } else if (TYPE(entry) == T_ARRAY) {
+      for (j = 0; j < RARRAY_LEN(entry); j++) {
+        VALUE sub_entry = rb_ary_entry(entry, j);
+        if(TYPE(sub_entry) == T_CLASS) {
+          rb_ary_push(type_strings, sub_entry);
+        } else {
+          rb_raise(eArgumentError, "Invalid type given");
+        }
+      }
+    } else {
+      rb_raise(eArgumentError, "Invalid type given");
+    }
+  }
+
+  rb_iv_set(self, "@field_types", type_strings);
+
+  return array;
+}
+
+typedef struct {
+  VALUE self;
+  VALUE oci8_conn;
+  VALUE cursor;
+  VALUE statement_type;
+  VALUE args;
+  VALUE sql;
+  struct timeval start;
+} cCommand_execute_try_t;
+
+static VALUE cCommand_execute_try(cCommand_execute_try_t *arg);
+static VALUE cCommand_execute_ensure(cCommand_execute_try_t *arg);
+
+// called by Command#execute that is written in Ruby
+static VALUE cCommand_execute_internal(VALUE self, VALUE oci8_conn, VALUE sql, VALUE args) {
+  cCommand_execute_try_t arg;
+  arg.self = self;
+  arg.oci8_conn = oci8_conn;
+  arg.sql = sql;
+  // store start time before SQL parsing
+  gettimeofday(&arg.start, NULL);
+  arg.cursor = rb_funcall(oci8_conn, ID_PARSE, 1, sql);
+  arg.statement_type = rb_funcall(arg.cursor, ID_TYPE, 0);
+  arg.args = args;
+    
+  return rb_ensure(cCommand_execute_try, (VALUE)&arg, cCommand_execute_ensure, (VALUE)&arg);
+}
+
+// wrapper for simple SQL calls without arguments
+static VALUE execute_sql(VALUE oci8_conn, VALUE sql) {
+  return cCommand_execute_internal(Qnil, oci8_conn, sql, Qnil);
+}
+
+static VALUE cCommand_execute_try(cCommand_execute_try_t *arg) {
+  VALUE result = Qnil;
+  int insert_id_present;
+  
+  // no arguments given
+  if NIL_P(arg->args) {
+    result = rb_funcall(arg->cursor, ID_EXEC, 0);
+  // arguments given - need to typecast
+  } else {
+    insert_id_present = (!NIL_P(arg->self) && rb_iv_get(arg->self, "@insert_id_present") == Qtrue);
+
+    if (insert_id_present)
+      rb_funcall(arg->cursor, ID_BIND_PARAM, 2, RUBY_STRING(":insert_id"), INT2NUM(0));
+
+    int i;
+    VALUE r_orig_value, r_new_value;
+    for (i = 0; i < RARRAY_LEN(arg->args); i++) {
+      r_orig_value = rb_ary_entry(arg->args, i);
+      r_new_value = typecast_bind_value(arg->oci8_conn, r_orig_value);
+      if (r_orig_value != r_new_value)
+        rb_ary_store(arg->args, i, r_new_value);
+    }
+
+    result = rb_apply(arg->cursor, ID_EXEC, arg->args);
+
+    if (insert_id_present) {
+      VALUE insert_id = rb_funcall(arg->cursor, ID_ELEM, 1, RUBY_STRING(":insert_id"));
+      rb_iv_set(arg->self, "@insert_id", insert_id);
+    }
+  }
+
+  if (SYM2ID(arg->statement_type) == ID_SELECT_STMT)
+    return arg->cursor;
+  else {
+    return result;
+  }
+
+}
+
+static VALUE cCommand_execute_ensure(cCommand_execute_try_t *arg) {
+  if (SYM2ID(arg->statement_type) != ID_SELECT_STMT)
+    rb_funcall(arg->cursor, ID_CLOSE, 0);
+  // Log SQL and execution time
+  data_objects_debug(arg->sql, &(arg->start));
+  return Qnil;
+}
+
+static VALUE cConnection_initialize(VALUE self, VALUE uri) {
+  VALUE r_host, r_port, r_path, r_user, r_password;
+  VALUE r_query, r_time_zone;
+  char *non_blocking = NULL;
+  char *time_zone = NULL;
+  char set_time_zone_command[80];
+  
+  char *host = "localhost", *port = "1521", *path = NULL;
+  char *connect_string;
+  int connect_string_length;
+  VALUE oci8_conn;
+
+  r_user = rb_funcall(uri, rb_intern("user"), 0);
+  r_password = rb_funcall(uri, rb_intern("password"), 0);
+
+  r_host = rb_funcall(uri, rb_intern("host"), 0);
+  if ( Qnil != r_host && RSTRING_LEN(r_host) > 0) {
+    host = StringValuePtr(r_host);
+  }
+  
+  r_port = rb_funcall(uri, rb_intern("port"), 0);
+  if ( Qnil != r_port ) {
+    r_port = rb_funcall(r_port, ID_TO_S, 0);
+    port = StringValuePtr(r_port);
+  }
+  
+  r_path = rb_funcall(uri, rb_intern("path"), 0);
+  path = StringValuePtr(r_path);
+
+  // If just host name is specified then use it as TNS names alias
+  if ((r_host != Qnil && RSTRING_LEN(r_host) > 0) &&
+      (r_port == Qnil) &&
+      (r_path == Qnil || RSTRING_LEN(r_path) == 0)) {
+    connect_string = host;
+  // If database name is specified in path (in format "/database")
+  } else if (strlen(path) > 1) {
+    connect_string_length = strlen(host) + strlen(port) + strlen(path) + 4;
+    connect_string = (char *)calloc(connect_string_length, sizeof(char));
+    snprintf(connect_string, connect_string_length, "//%s:%s%s", host, port, path);
+  } else {
+    rb_raise(eConnectionError, "Database must be specified");
+  }
+
+  // oci8_conn = rb_funcall(cOCI8, ID_NEW, 3, r_user, r_password, RUBY_STRING(connect_string));
+  oci8_conn = rb_funcall(cConnection, rb_intern("oci8_new"), 3, r_user, r_password, RUBY_STRING(connect_string));
+
+  // Pull the querystring off the URI
+  r_query = rb_funcall(uri, rb_intern("query"), 0);
+
+  non_blocking = get_uri_option(r_query, "non_blocking");
+  // Enable non-blocking mode
+  if (non_blocking != NULL && strcmp(non_blocking, "true") == 0)
+    rb_funcall(oci8_conn, rb_intern("non_blocking="), 1, Qtrue);
+  // By default enable auto-commit mode
+  rb_funcall(oci8_conn, rb_intern("autocommit="), 1, Qtrue);
+  // Set prefetch rows to 100 to increase fetching performance SELECTs with many rows
+  rb_funcall(oci8_conn, rb_intern("prefetch_rows="), 1, INT2NUM(100));
+
+  // Set session time zone
+  // at first look for option in connection string
+  time_zone = get_uri_option(r_query, "time_zone");
+  // if no option specified then look in ENV['TZ']
+  if (time_zone == NULL) {
+    r_time_zone = rb_funcall(cConnection, rb_intern("ruby_time_zone"), 0);
+    if (!NIL_P(r_time_zone))
+      time_zone = StringValuePtr(r_time_zone);
+  }
+  if (time_zone) {
+    snprintf(set_time_zone_command, 80, "alter session set time_zone = '%s'", time_zone);
+    execute_sql(oci8_conn, RUBY_STRING(set_time_zone_command));
+  }
+  
+  execute_sql(oci8_conn, RUBY_STRING("alter session set nls_date_format = 'YYYY-MM-DD HH24:MI:SS'"));
+  execute_sql(oci8_conn, RUBY_STRING("alter session set nls_timestamp_format = 'YYYY-MM-DD HH24:MI:SS.FF'"));
+  execute_sql(oci8_conn, RUBY_STRING("alter session set nls_timestamp_tz_format = 'YYYY-MM-DD HH24:MI:SS.FF TZH:TZM'"));
+
+  rb_iv_set(self, "@uri", uri);
+  rb_iv_set(self, "@connection", oci8_conn);
+
+  return Qtrue;
+}
+
+static VALUE cCommand_execute_non_query(int argc, VALUE *argv[], VALUE self) {
+  VALUE affected_rows = rb_funcall2(self, ID_EXECUTE, argc, (VALUE *)argv);
+  if (affected_rows == Qtrue)
+    affected_rows = INT2NUM(0);
+
+  VALUE insert_id = rb_iv_get(self, "@insert_id");
+
+  return rb_funcall(cResult, ID_NEW, 3, self, affected_rows, insert_id);
+}
+
+static VALUE cCommand_execute_reader(int argc, VALUE *argv[], VALUE self) {
+  VALUE reader, query;
+  VALUE field_names, field_types;
+  VALUE column_metadata, column, column_name;
+  
+  int i;
+  int field_count;
+  int infer_types = 0;
+
+  VALUE cursor = rb_funcall2(self, ID_EXECUTE, argc, (VALUE *)argv);
+
+  if (rb_obj_class(cursor) != cOCI8_Cursor) {
+    rb_raise(eArgumentError, "\"%s\" is invalid SELECT query", StringValuePtr(query));
+  }
+
+  column_metadata = rb_funcall(cursor, ID_COLUMN_METADATA, 0);  
+  field_count = RARRAY_LEN(column_metadata);
+  // reduce field_count by 1 if RAW_RNUM_ is present as last column
+  // (generated by DataMapper to simulate LIMIT and OFFSET)
+  column = rb_ary_entry(column_metadata, field_count-1);
+  column_name = rb_funcall(column, ID_NAME, 0);
+  if (strncmp(RSTRING_PTR(column_name), "RAW_RNUM_", RSTRING_LEN(column_name)) == 0)
+    field_count--;
+
+  reader = rb_funcall(cReader, ID_NEW, 0);
+  rb_iv_set(reader, "@reader", cursor);
+  rb_iv_set(reader, "@field_count", INT2NUM(field_count));
+
+  field_names = rb_ary_new();
+  field_types = rb_iv_get(self, "@field_types");
+
+  if ( field_types == Qnil || 0 == RARRAY_LEN(field_types) ) {
+    field_types = rb_ary_new();
+    infer_types = 1;
+  } else if (RARRAY_LEN(field_types) != field_count) {
+    // Whoops...  wrong number of types passed to set_types.  Close the reader and raise
+    // and error
+    rb_funcall(reader, ID_CLOSE, 0);
+    rb_raise(eArgumentError, "Field-count mismatch. Expected %ld fields, but the query yielded %d", RARRAY_LEN(field_types), field_count);
+  }
+
+  for ( i = 0; i < field_count; i++ ) {
+    column = rb_ary_entry(column_metadata, i);
+    column_name = rb_funcall(column, ID_NAME, 0);
+    rb_ary_push(field_names, column_name);
+    if ( infer_types == 1 ) {
+      rb_ary_push(field_types,
+        infer_ruby_type(rb_iv_get(column, "@data_type"),
+          rb_funcall(column, ID_PRECISION, 0),
+          rb_funcall(column, ID_SCALE, 0))
+      );
+    }
+  }
+
+  rb_iv_set(reader, "@position", INT2NUM(0));
+  rb_iv_set(reader, "@fields", field_names);
+  rb_iv_set(reader, "@field_types", field_types);
+
+  rb_iv_set(reader, "@last_row", Qfalse);
+
+  return reader;
+}
+
+static VALUE cReader_close(VALUE self) {
+  VALUE cursor = rb_iv_get(self, "@reader");
+
+  if (Qnil == cursor)
+    return Qfalse;
+
+  rb_funcall(cursor, ID_CLOSE, 0);
+
+  rb_iv_set(self, "@reader", Qnil);
+  return Qtrue;
+}
+
+static VALUE cReader_next(VALUE self) {
+  VALUE cursor = rb_iv_get(self, "@reader");
+
+  int field_count;
+  int i;
+
+  if (Qnil == cursor || Qtrue == rb_iv_get(self, "@last_row"))
+    return Qfalse;
+
+  VALUE row = rb_ary_new();
+  VALUE field_types, field_type;
+  VALUE value;
+
+  VALUE fetch_result = rb_funcall(cursor, ID_FETCH, 0);
+  
+  if (Qnil == fetch_result) {
+    rb_iv_set(self, "@values", Qnil);
+    rb_iv_set(self, "@last_row", Qtrue);
+    return Qfalse;
+  }
+
+  field_count = NUM2INT(rb_iv_get(self, "@field_count"));
+  field_types = rb_iv_get(self, "@field_types");
+
+  for ( i = 0; i < field_count; i++ ) {
+    field_type = rb_ary_entry(field_types, i);
+    value = rb_ary_entry(fetch_result, i);
+    // Always return nil if the value returned from Oracle is null
+    if (Qnil != value) {
+      value = typecast(value, field_type);
+    }
+
+    rb_ary_push(row, value);
+  }
+
+  rb_iv_set(self, "@values", row);
+  return Qtrue;
+}
+
+static VALUE cReader_values(VALUE self) {
+
+  VALUE values = rb_iv_get(self, "@values");
+  if(values == Qnil) {
+    rb_raise(eDataError, "Reader not initialized");
+    return Qnil;
+  } else {
+    return values;
+  }
+}
+
+static VALUE cReader_fields(VALUE self) {
+  return rb_iv_get(self, "@fields");
+}
+
+static VALUE cReader_field_count(VALUE self) {
+  return rb_iv_get(self, "@field_count");
+}
+
+
+void Init_do_oracle() {
+  // rb_require("oci8");
+  rb_require("date");
+  rb_require("bigdecimal");
+
+  // Get references classes needed for Date/Time parsing
+  rb_cDate = CONST_GET(rb_mKernel, "Date");
+  rb_cDateTime = CONST_GET(rb_mKernel, "DateTime");
+  rb_cBigDecimal = CONST_GET(rb_mKernel, "BigDecimal");
+
+  rb_funcall(rb_mKernel, rb_intern("require"), 1, rb_str_new2("data_objects"));
+
+  ID_NEW = rb_intern("new");
+#ifdef RUBY_LESS_THAN_186
+  ID_NEW_DATE = rb_intern("new0");
+#else
+  ID_NEW_DATE = rb_intern("new!");
+#endif
+  ID_LOGGER = rb_intern("logger");
+  ID_DEBUG = rb_intern("debug");
+  ID_LEVEL = rb_intern("level");
+  ID_TO_S = rb_intern("to_s");
+  ID_RATIONAL = rb_intern("Rational");
+
+  ID_NAME = rb_intern("name");
+
+  ID_NUMBER = rb_intern("number");
+  ID_VARCHAR2 = rb_intern("varchar2");
+  ID_CHAR = rb_intern("char");
+  ID_DATE = rb_intern("date");
+  ID_TIMESTAMP = rb_intern("timestamp");
+  ID_TIMESTAMP_TZ = rb_intern("timestamp_tz");
+  ID_TIMESTAMP_LTZ = rb_intern("timestamp_ltz");
+  ID_CLOB = rb_intern("clob");
+  ID_BLOB = rb_intern("blob");
+  ID_LONG = rb_intern("long");
+  ID_RAW = rb_intern("raw");
+  ID_LONG_RAW = rb_intern("long_raw");
+  ID_BFILE = rb_intern("bfile");
+  ID_BINARY_FLOAT = rb_intern("binary_float");
+  ID_BINARY_DOUBLE = rb_intern("binary_double");
+
+  ID_TO_A = rb_intern("to_a");
+  ID_TO_I = rb_intern("to_i");
+  ID_TO_S = rb_intern("to_s");
+  ID_TO_F = rb_intern("to_f");
+  
+  ID_UTC_OFFSET = rb_intern("utc_offset");
+  ID_FULL_CONST_GET = rb_intern("full_const_get");
+  
+  ID_PARSE = rb_intern("parse");
+  ID_FETCH = rb_intern("fetch");
+  ID_TYPE = rb_intern("type");
+  ID_EXECUTE = rb_intern("execute");
+  ID_EXEC = rb_intern("exec");
+  
+  ID_SELECT_STMT = rb_intern("select_stmt");
+  ID_COLUMN_METADATA = rb_intern("column_metadata");
+  ID_PRECISION = rb_intern("precision");
+  ID_SCALE = rb_intern("scale");
+  ID_BIND_PARAM = rb_intern("bind_param");
+  ID_ELEM = rb_intern("[]");
+  ID_READ = rb_intern("read");
+  
+  ID_CLOSE = rb_intern("close");
+  ID_LOGOFF = rb_intern("logoff");
+  
+  // Get references to the Extlib module
+  mExtlib = CONST_GET(rb_mKernel, "Extlib");
+  rb_cByteArray = CONST_GET(mExtlib, "ByteArray");
+
+  // Get reference to OCI8 class
+  cOCI8 = CONST_GET(rb_mKernel, "OCI8");
+  cOCI8_Cursor = CONST_GET(cOCI8, "Cursor");
+  cOCI8_BLOB = CONST_GET(cOCI8, "BLOB");
+  cOCI8_CLOB = CONST_GET(cOCI8, "CLOB");
+
+  // Get references to the DataObjects module and its classes
+  mDO = CONST_GET(rb_mKernel, "DataObjects");
+  cDO_Quoting = CONST_GET(mDO, "Quoting");
+  cDO_Connection = CONST_GET(mDO, "Connection");
+  cDO_Command = CONST_GET(mDO, "Command");
+  cDO_Result = CONST_GET(mDO, "Result");
+  cDO_Reader = CONST_GET(mDO, "Reader");
+
+  // Top Level Module that all the classes live under
+  mOracle = rb_define_module_under(mDO, "Oracle");
+
+  eArgumentError = CONST_GET(rb_mKernel, "ArgumentError");
+  eSQLError = CONST_GET(mDO, "SQLError");
+  eConnectionError = CONST_GET(mDO, "ConnectionError");
+  eDataError = CONST_GET(mDO, "DataError");
+  // eOracleError = rb_define_class("OracleError", rb_eStandardError);
+
+  cConnection = ORACLE_CLASS("Connection", cDO_Connection);
+  rb_define_method(cConnection, "initialize", cConnection_initialize, 1);
+  rb_define_method(cConnection, "dispose", cConnection_dispose, 0);
+
+  cCommand = ORACLE_CLASS("Command", cDO_Command);
+  rb_define_method(cCommand, "set_types", cCommand_set_types, -1);
+  rb_define_method(cCommand, "execute_non_query", cCommand_execute_non_query, -1);
+  rb_define_method(cCommand, "execute_reader", cCommand_execute_reader, -1);
+  rb_define_method(cCommand, "execute_internal", cCommand_execute_internal, 3);
+
+  cResult = ORACLE_CLASS("Result", cDO_Result);
+
+  cReader = ORACLE_CLASS("Reader", cDO_Reader);
+  rb_define_method(cReader, "close", cReader_close, 0);
+  rb_define_method(cReader, "next!", cReader_next, 0);
+  rb_define_method(cReader, "values", cReader_values, 0);
+  rb_define_method(cReader, "fields", cReader_fields, 0);
+  rb_define_method(cReader, "field_count", cReader_field_count, 0);
+
+}