tgbyte-activerecord-jdbc-adapter 1.2.2.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) 2006-2008 Nick Sieger <nick@nicksieger.com>
+Copyright (c) 2006-2008 Ola Bini <ola.bini@gmail.com>
+
+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.rdoc

@@ -0,0 +1,199 @@
+= Activerecord-jdbc-adapter
+
+activerecord-jdbc-adapter is a database adapter for Rails' ActiveRecord
+component that can be used with JRuby[http://www.jruby.org/]. It allows use of
+virtually any JDBC-compliant database with your JRuby on Rails application.
+
+== Databases
+
+Activerecord-jdbc-adapter provides full or nearly full support for:
+MySQL, PostgreSQL, SQLite3, Oracle, Microsoft SQL Server, DB2,
+FireBird, Derby, HSQLDB, H2, and Informix.
+
+Other databases will require testing and likely a custom configuration module.
+Please join the JRuby mailing-list[http://jruby.org/community] to help us discover
+support for more databases.
+
+== Using ActiveRecord JDBC
+
+=== Inside Rails
+
+To use activerecord-jdbc-adapter with JRuby on Rails:
+
+1. Choose the adapter you wish to gem install. The following pre-packaged
+adapters are available:
+
+  * base jdbc (<tt>activerecord-jdbc-adapter</tt>). Supports all available databases via JDBC, but requires you to download and manually install the database vendor's JDBC driver .jar file.
+  * mysql (<tt>activerecord-jdbcmysql-adapter</tt>)
+  * postgresql (<tt>activerecord-jdbcpostgresql-adapter</tt>)
+  * sqlite3 (<tt>activerecord-jdbcsqlite3-adapter</tt>)
+  * derby (<tt>activerecord-jdbcderby-adapter</tt>)
+  * hsqldb (<tt>activerecord-jdbchsqldb-adapter</tt>)
+  * h2 (<tt>activerecord-jdbch2-adapter</tt>)
+  * mssql (<tt>activerecord-jdbcmssql-adapter</tt>)
+
+2a. For Rails 3, if you're generating a new application, use the
+following command to generate your application:
+
+   jruby -S rails new sweetapp
+
+2b. Otherwise, you'll need to perform some extra configuration steps
+to prepare your Rails application for JDBC.
+
+If you're using Rails 3, you'll need to modify your Gemfile to use the
+activerecord-jdbc-adapter gem under JRuby. Change your Gemfile to look
+like the following (using sqlite3 as an example):
+
+    platforms :ruby do
+      gem 'sqlite3'
+    end
+
+    platforms :jruby do
+      gem 'jruby-openssl'
+      gem 'activerecord-jdbcsqlite3-adapter'
+    end
+
+If you're using Rails 2:
+
+    jruby script/generate jdbc
+
+3. Configure your database.yml in the normal Rails style. 
+
+Legacy configuration: If you use one of the convenience
+'activerecord-jdbcXXX-adapter' adapters, you can still put a 'jdbc'
+prefix in front of the database adapter name as below.
+
+    development:
+      adapter: jdbcmysql
+      username: blog
+      password:
+      hostname: localhost
+      database: weblog_development
+
+For other databases, you'll need to know the database driver class and
+URL. Example:
+
+    development:
+      adapter: jdbc
+      username: blog
+      password:
+      driver: com.mysql.jdbc.Driver
+      url: jdbc:mysql://localhost:3306/weblog_development
+
+   For JNDI data sources, you may simply specify the JNDI location as follows
+   (the adapter will be automatically detected):
+
+    production:
+      adapter: jdbc
+      jndi: jdbc/mysqldb
+
+   If you're really old school you might want to use ARJDBC with a DB2 on z/OS.
+
+    development:
+      adapter: jdbc
+      encoding: unicode
+      url: jdbc:db2j:net://mightyzoshost:446/RAILS_DBT1
+      driver: com.ibm.db2.jcc.DB2Driver
+      schema: DB2XB12
+      database: RAILS_DB1
+      tablespace: TSDE911
+      lob_tablespaces:
+        first_table: TSDE912
+      username: scott
+      password: lion
+
+=== Standalone, with ActiveRecord
+
+1. Install the gem with JRuby:
+
+    jruby -S gem install activerecord-jdbc-adapter
+
+If you wish to use the adapter for a specific database, you can
+install it directly and a driver gem will be installed as well:
+
+    jruby -S gem install activerecord-jdbcderby-adapter
+
+2. After this you can establish a JDBC connection like this:
+
+    ActiveRecord::Base.establish_connection(
+      :adapter => 'jdbcderby',
+      :database => "db/my-database"
+    )
+
+or like this (but requires that you manually put the driver jar on the classpath):
+
+    ActiveRecord::Base.establish_connection(
+      :adapter => 'jdbc',
+      :driver => 'org.apache.derby.jdbc.EmbeddedDriver',
+      :url => 'jdbc:derby:test_ar;create=true'
+    )
+
+== Extending AR-JDBC
+
+You can create your own extension to AR-JDBC for a JDBC-based database
+that core AR-JDBC does not support. We've created an example project
+for the Intersystems Cache database that you can examine as a
+template. See the project for more information at the following URL:
+
+  http://github.com/nicksieger/activerecord-cachedb-adapter
+
+== Getting the source
+
+The source for activerecord-jdbc-adapter is available using git.
+
+  git clone git://github.com/jruby/activerecord-jdbc-adapter.git
+
+== Feedback
+
+Please file bug reports at
+http://kenai.com/jira/browse/ACTIVERECORD_JDBC. If you're not sure if
+something's a bug, feel free to pre-report it on the mailing lists.
+
+== Project Info
+
+* Mailing Lists: http://jruby.org/community
+* Issues: https://github.com/jruby/activerecord-jdbc-adapter/issues
+* Source: git://github.com/jruby/activerecord-jdbc-adapter.git
+
+== Running AR-JDBC's Tests
+
+Drivers for 6 open-source databases are included. Provided you have
+MySQL installed, you can simply type <tt>jruby -S rake</tt> to run the
+tests. A database named <tt>weblog_development</tt> is needed
+beforehand with a connection user of "blog" and an empty password. You
+alse need to grant "blog" create privileges on
+'test_rake_db_create.*'.
+
+If you also have PostgreSQL available, those tests will be run if the
+`psql' executable can be found. Also ensure you have a database named
+<tt>weblog_development</tt> and a user named "blog" and an empty
+password.
+
+If you want rails logging enabled during these test runs you can edit 
+test/jdbc_common.rb and add the following line:
+
+require 'db/logger'
+
+== Running AR Tests
+
+To run the current AR-JDBC sources with ActiveRecord, just use the
+included "rails:test" task. Be sure to specify a driver and a path to
+the ActiveRecord sources.
+
+  jruby -S rake rails:test DRIVER=mysql RAILS=/path/activerecord_source_dir
+
+== Travis Build Status {<img src="https://secure.travis-ci.org/jruby/activerecord-jdbc-adapter.png"/>}[http://travis-ci.org/#!/jruby/activerecord-jdbc-adapter]
+
+== Authors
+
+This project was written by Nick Sieger <nick@nicksieger.com> and Ola Bini
+<olabini@gmail.com> with lots of help from the JRuby community.
+
+== License
+
+activerecord-jdbc-adapter is released under a BSD license. See the LICENSE file
+included with the distribution for details.
+
+Open-source driver gems for activerecord-jdbc-adapter are licensed under the
+same license the database's drivers are licensed. See each driver gem's
+LICENSE.txt file for details.

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rake/testtask'
+require 'rake/clean'
+CLEAN.include 'derby*', 'test.db.*','test/reports', 'test.sqlite3','lib/**/*.jar','manifest.mf', '*.log'
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+require 'bundler/setup'
+
+require File.expand_path('../test/helper', __FILE__)
+
+task :default => [:jar, :test]
+
+#ugh, bundler doesn't use tasks, so gotta hook up to both tasks.
+task :build => :jar
+task :install => :jar
+
+ADAPTERS = %w[derby h2 hsqldb mssql mysql postgresql sqlite3].map {|a| "tgbyte-activerecord-jdbc#{a}-adapter" }
+DRIVERS  = %w[derby h2 hsqldb jtds mysql postgres sqlite3].map {|a| "jdbc-#{a}" }
+
+def rake(args)
+  ruby "-S", "rake", *args
+end
+
+(ADAPTERS + DRIVERS).each do |adapter|
+  namespace adapter do
+
+    task :build do
+      Dir.chdir(adapter) do
+        rake "build"
+      end
+      cp FileList["#{adapter}/pkg/#{adapter}-*.gem"], "pkg"
+    end
+
+    # bundler handles install => build itself
+    task :install do
+      Dir.chdir(adapter) do
+        rake "install"
+      end
+    end
+
+    task :release do
+      Dir.chdir(adapter) do
+        rake "release"
+      end
+    end
+  end
+end
+
+desc "Release all adapters"
+task "all:release" => ["release", *ADAPTERS.map { |f| "#{f}:release" }]
+
+desc "Install all adapters"
+task "all:install" => ["install", *ADAPTERS.map { |f| "#{f}:install" }]
+
+desc "Build all adapters"
+task "all:build"   => ["build", *ADAPTERS.map { |f| "#{f}:build" }]
+
+task :filelist do
+  puts FileList['pkg/**/*'].inspect
+end

data/activerecord-jdbc-adapter.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'arjdbc/version'
+version = ArJdbc::Version::VERSION
+Gem::Specification.new do |s|
+  s.name        = "tgbyte-activerecord-jdbc-adapter"
+  s.version     = version
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Nick Sieger, Ola Bini and JRuby contributors"]
+  s.email       = %q{nick@nicksieger.com, ola.bini@gmail.com}
+  s.homepage = %q{https://github.com/tgbyte/activerecord-jdbc-adapter}
+  s.summary = %q{JDBC adapter for ActiveRecord, for use within JRuby on Rails.}
+  s.description = %q{activerecord-jdbc-adapter is a database adapter for Rails\' ActiveRecord
+component that can be used with JRuby[http://www.jruby.org/]. It allows use of
+virtually any JDBC-compliant database with your JRuby on Rails application.}
+  s.files         = `git ls-files`.split("\n").reject {|v| v =~ /^(activerecord-jdbc[^-]|jdbc-)/}
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.rdoc_options = ["--main", "README.txt", "-SHN", "-f", "darkfish"]
+  s.rubyforge_project = %q{jruby-extras}
+end
+

data/bench/bench_attributes.rb

@@ -0,0 +1,13 @@
+require File.dirname(__FILE__) + '/bench_model'
+
+puts "Widget.find(:first).attributes"
+Benchmark.bm do |make|
+  TIMES.times do
+    w = Widget.find(:first)
+    make.report do
+      10_000.times do
+        w.attributes # rails makes copy for every call
+      end
+    end
+  end
+end

data/bench/bench_attributes_new.rb

@@ -0,0 +1,14 @@
+require File.dirname(__FILE__) + '/bench_model'
+
+puts "w = Widget.find(:first); Widget.new(w.attributes)"
+Benchmark.bm do |make|
+  TIMES.times do
+    w = Widget.find(:first)
+    params = w.attributes
+    make.report do
+      10_000.times do
+        Widget.new(params)
+      end
+    end
+  end
+end

data/bench/bench_create.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/bench_model'
+
+puts "Widget.create"
+Benchmark.bm do |make|
+  TIMES.times do
+    make.report do
+      10_000.times do
+        Widget.create!(:name => "bench", :description => "Bench record")
+      end
+    end
+  end
+end

data/bench/bench_find_all.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/bench_model'
+
+puts "Widget.find(:all)"
+Benchmark.bm do |make|
+  TIMES.times do
+    make.report do
+      10_000.times do
+        Widget.find(:all)
+      end
+    end
+  end
+end

data/bench/bench_find_all_mt.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/bench_model'
+
+Benchmark.bm do |make|
+  TIMES.times do
+    make.report do
+      thrs = []
+      errs = 0
+      10.times do
+        thrs << Thread.new do
+          1000.times do
+            begin
+              Widget.find(:all)
+            rescue Exception => e
+              errs += 1
+              Widget.logger.warn e.to_s
+            end
+          end
+          Widget.clear_active_connections!
+        end
+      end
+      thrs.each {|t| t.join}
+      puts "errors: #{errs}" if errs > 0
+    end
+  end
+end

data/bench/bench_model.rb

@@ -0,0 +1,85 @@
+=begin
+
+* This scripts looks for an optional argv0 which is number of times to
+  execute the particular benchmark this file is getting required into. argv1
+  is an optional parameter which represents the number of rows to create.
+* Use ENV['LOGGER'] (=severe|warn|info|debug) to turn on the logger
+* Add ActiveRecord to load path to use a specific (non-gem version) for testing (e.g., edge).
+
++----------+------+-----+---------+-----------------+----------------+
+| Field       | Type         | Null | Key | Default | Extra          |
++-------------+--------------+------+-----+---------+----------------+
+| id          | int(11)      | NO   | PRI | NULL    | auto_increment |
+| name        | varchar(255) | YES  |     | NULL    |                |
+| description | text         | YES  |     | NULL    |                |
+| created_at  | datetime     | YES  |     | NULL    |                |
+| updated_at  | datetime     | YES  |     | NULL    |                |
++-------------+--------------+------+-----+---------+----------------+
+=end
+
+TIMES = (ARGV[0] || 5).to_i
+ROW_COUNT = (ARGV[1] || 10).to_i
+
+ENV["RAILS_ENV"] = "production"
+begin
+  print "Loading ActiveRecord w/o gems..."
+  require 'active_record'
+  require 'active_record/version'
+  puts "version #{ActiveRecord::VERSION::STRING}"
+rescue LoadError
+  puts "FAILED."
+  print "Loading ActiveRecord with gems..."
+  require 'rubygems'
+  gem 'activerecord'
+  puts "version #{Gem.loaded_specs['activerecord'].version.version}"
+  require 'active_record'
+end
+require 'benchmark'
+
+if defined?(RUBY_ENGINE) && RUBY_ENGINE == "jruby"
+  $LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+  $LOAD_PATH.unshift File.dirname(__FILE__) + '/../drivers/mysql/lib'
+  $LOAD_PATH.unshift File.dirname(__FILE__) + '/../adapters/mysql/lib'
+  require 'active_record/connection_adapters/jdbcmysql_adapter'
+end
+
+if ENV['LOGGER']
+  require 'logger'
+  ActiveRecord::Base.logger = Logger.new(File.expand_path(File.dirname(__FILE__) + "/debug.log"))
+  lvl = %(DEBUG INFO WARN ERROR FATAL).detect {|s| s =~ /#{ENV['LOGGER'].upcase}/}
+  ActiveRecord::Base.logger.level = lvl && Logger.const_get(lvl) || Logger::INFO
+else
+  ActiveRecord::Base.logger = Logger.new($stdout)
+  ActiveRecord::Base.logger.level = Logger::UNKNOWN
+end
+
+ActiveRecord::Base.establish_connection(
+  :adapter => "mysql",
+  :host => "localhost",
+  :username => "root",
+  :database => "ar_bench",
+  :pool => 10,
+  :wait_timeout => 0.5
+)
+
+class CreateWidgets < ActiveRecord::Migration
+  def self.up
+    create_table :widgets do |t|
+      t.string :name
+      t.text :description
+      t.timestamps
+    end
+  end
+end
+
+CreateWidgets.up unless ActiveRecord::Base.connection.tables.include?("widgets")
+
+class Widget < ActiveRecord::Base; end
+Widget.destroy_all if Widget.count > ROW_COUNT
+count = Widget.count
+while (count < ROW_COUNT)
+  Widget.create!(:name => "bench#{count}", :description => "Bench record#{count}")
+  count = Widget.count
+end
+
+ActiveRecord::Base.clear_active_connections!