activerecord-jdbc-adapter-ficoh 1.3.21-java

data/LICENSE.txt

@@ -0,0 +1,25 @@
+Copyright (c) 2012-2014 Karol Bucek <self@kares.org>
+Copyright (c) 2006-2012 Nick Sieger <nick@nicksieger.com>
+Copyright (c) 2006-2008 Ola Bini <ola.bini@gmail.com>
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice, this
+  list of conditions and the following disclaimer in the documentation and/or
+  other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,277 @@
+# ActiveRecord JDBC Adapter
+
+[![Gem Version](https://badge.fury.io/rb/activerecord-jdbc-adapter.png)][7]
+
+ActiveRecord-JDBC-Adapter (AR-JDBC) is a database adapter for Rails'
+*ActiveRecord* component that can be used with [JRuby][0]. It allows use of
+virtually any JDBC-compliant database with your JRuby on Rails application.
+
+We do support *ActiveRecord* **3.x** and **4.x** (also **2.3** is still expected
+to work) from a single code base. AR-JDBC needs JRuby 1.7.x or 9K (we recommend
+using the latest and greatest of versions) thus Java >= **1.6** is mandatory.
+
+
+**This README and master targets AR-JDBC 1.4.0 (pre-release) please use the
+[1-3-stable](https://github.com/jruby/activerecord-jdbc-adapter/tree/1-3-stable)
+branch for current stable 1.3.x releases.**
+
+The next release 1.4 aims to concentrate on internal refactoring and optimization.
+We're going to be (slowly) dropping support for all of Rails < 3.2, unless there
+is demand for these. In which case we kindly hope to receive PRs.
+
+## Databases
+
+ActiveRecord-JDBC-Adapter provides (built-in) full or nearly full support for:
+**MySQL** (and **MariaDB**), **PostgreSQL**, **SQLite3**, **Oracle**, **DB2**,
+*MS-SQL** (SQL Server), **Firebird**, **Derby**, **HSQLDB**, **H2**, and **Informix**.
+
+Even if you're database product is not listed, there are 3rd party gems built on
+top of AR-JDBC to handle different data-sources, [search][8] at the usual places.
+
+## Using ActiveRecord JDBC
+
+### Inside Rails
+
+To use AR-JDBC with JRuby on Rails:
+
+1. Choose the adapter (base is usually fine), the following are pre-packaged :
+
+  - Base JDBC (`activerecord-jdbc-adapter`) - supports all available databases
+    via JDBC (Java's unified DB interface), but requires you to setup a JDBC
+    driver (which with most open-source drivers means adding another gem to your
+    *Gemfile* e.g. `gem 'jdbc-mysql'` just like on MRI), for drivers not packed
+    as gems just add the required jars to the class-path
+  - MySQL (`activerecord-jdbcmysql-adapter`)
+  - PostgreSQL (`activerecord-jdbcpostgresql-adapter`)
+  - SQLite3 (`activerecord-jdbcsqlite3-adapter`)
+  - Derby (`activerecord-jdbcderby-adapter`)
+  - HSQLDB (`activerecord-jdbchsqldb-adapter`)
+  - H2 (`activerecord-jdbch2-adapter`)
+  - MSSQL (`activerecord-jdbcmssql-adapter`) - uses the OSS jTDS driver which
+    might have issues with the latest SQLServer (but should work using the
+    Microsoft JDBC Driver for SQL Server - we recommend using version 4.0)
+    **NOTE:** [jTDS](http://jtds.sourceforge.net/) seems no longer maintained,
+    if you're run into issues consider using the official (proprietary) driver.
+
+2a. If you're generating a new Rails application, run the usual :
+
+    jruby -S rails new sweetapp
+
+2b. Otherwise, you might need to perform some extra configuration steps
+to prepare your Rails application for JDBC.
+
+You'll need to modify your *Gemfile* to use the *activerecord-jdbc-adapter* gem
+(or one of the helper gems) under JRuby. Change your *Gemfile* to look something
+like the following :
+
+```ruby
+gem 'mysql2', platform: :ruby
+gem 'jdbc-mysql', platform: :jruby
+gem 'activerecord-jdbc-adapter', platform: :jruby
+```
+
+3. Configure your *database.yml* in the normal Rails style :
+
+```yml
+development:
+  adapter: mysql2 # or mysql
+  database: blog_development
+  username: blog
+  password: 1234
+```
+
+**Legacy Configuration:** If you use one of the *activerecord-jdbcxxx-adapter*
+gems, you can still put a 'jdbc' prefix in front of the database adapter name,
+e.g. `adapter: jdbcmysql` but it's no longer recommended on Rails >= 3.0
+
+For plain JDBC database configurations, you'll need to know the database driver
+class and URL (do not forget to put the driver .jar(s) on the class-path) e.g. :
+
+```yml
+development:
+  adapter: jdbc
+  driver: org.apache.hadoop.hive.jdbc.HiveDriver
+  url: jdbc:hive://localhost:10004/default
+```
+
+**NOTE:** please do not confuse the `:url` setting with the one introduced in
+ActiveRecord 4.1, we've been using it for a long time with AR-JDBC and for now
+should work just fine the "jdbc:xxx" way (passed to the driver directly) ...
+
+For JNDI data sources, you may simply specify the JNDI location as follows, it's
+recommended to use the same adapter: setting as one would configure when using
+"bare" (JDBC) connections e.g. :
+
+```yml
+production:
+  adapter: postgresql
+  jndi: jdbc/PostgreDS
+  # be aware that by default AR defaults to pool: 5
+  # there are (unofficial) ways of avoiding AR's pooling
+  # one such would be: ActiveRecord::Bogacs::FalsePool
+```
+
+**NOTE:** any other settings such as *database:*, *username:*, *properties:* make
+no difference since everything is already configured on the data source end.
+
+Most data-sources will provide you with connection pooling, but ActiveRecord uses
+an internal pool (with a default size of 5) as well, thus you need to be careful
+to configure both pools wisely to handle your requirements. If you'd like to
+"disable" AR's built-in pool try : https://github.com/kares/activerecord-bogacs
+
+JDBC driver specific properties might be set if you use an URL to specify the DB
+or preferably using the *properties:* syntax :
+
+```yml
+production:
+  adapter: mysql
+  username: blog
+  password: blog
+  url: "jdbc:mysql://localhost:3306/blog?profileSQL=true"
+  properties: # specific to com.mysql.jdbc.Driver
+    socketTimeout:  60000
+    connectTimeout: 60000
+```
+
+If you're really old school you might want to use AR-JDBC with a DB2 on z/OS :
+
+```yml
+development:
+  adapter: db2
+  url: jdbc:db2j:net://mightyzoshost:446/RAILS_DBT1
+  schema: DB2XB12
+  database: RAILS_DB1
+  tablespace: TSDE911
+  lob_tablespaces:
+    first_table: TSDE912
+  username: business
+  password: machines
+  # default driver used is :
+  #driver: com.ibm.db2.jcc.DB2Driver
+  # NOTE: AS400 support is deprecated since 1.4 in favor
+  # of the standalone activerecord-jdbcas400-adapter gem
+```
+
+More information on (configuring) AR-JDBC might be found on our [wiki][5].
+
+### Standalone with ActiveRecord
+
+Once the setup is made (see below) you can establish a JDBC connection like this
+(e.g. for `activerecord-jdbcderby-adapter`):
+
+```ruby
+ActiveRecord::Base.establish_connection adapter: 'derby', database: 'db/my-db'
+```
+
+#### Using Bundler
+
+Proceed as with Rails; specify `gem 'activerecord'` in your Bundle along with the
+chosen JDBC adapter (or driver), sample *Gemfile* for MySQL :
+
+```ruby
+gem 'activerecord', '~> 3.2.18'
+gem 'activerecord-jdbcmysql-adapter' # or :
+# gem 'mysql2', :platform => :mri # C-driver
+# gem 'activerecord-jdbc-adapter', :platform => :jruby
+# gem 'jdbc-mysql', :platform => :jruby # J-driver
+```
+
+When you `require 'bundler/setup'` everything will be set up for you as expected.
+
+You do not need to use the 'helper' *activerecord-jdbcxxx-adapter* gem we provide
+but than should make sure an appropriate JDBC driver is available at runtime, in
+that case simply setup your *Gemfile* as:
+
+```ruby
+gem 'activerecord', '~> 4.1.6'
+gem 'activerecord-jdbc-adapter', '~> 1.3', platform: :jruby
+# e.g. for PostgreSQL you'll probably add :
+# gem 'pg', platform: :mri
+# gem 'jdbc-postgres', platform: :jruby
+```
+
+#### Without Bundler
+
+Install the needed gems with JRuby, for example:
+
+    gem install activerecord -v "~> 3.2"
+    gem install activerecord-jdbc-adapter --ignore-dependencies
+
+If you wish to use the adapter for a specific database, you can install it
+directly and the (jdbc-) driver gem (dependency) will be installed as well:
+
+    jruby -S gem install activerecord-jdbcderby-adapter
+
+Your program should include:
+
+```ruby
+require 'active_record'
+require 'activerecord-jdbc-adapter' if defined? JRUBY_VERSION
+# or in case you're using the pre-packaged adapter gem :
+require 'activerecord-jdbcderby-adapter' if defined? JRUBY_VERSION
+```
+
+## 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 [cachedb-adapter project][4] for more information.
+
+## Source
+
+The source for activerecord-jdbc-adapter is available using git:
+
+    git clone git://github.com/jruby/activerecord-jdbc-adapter.git
+
+**You will need to have JDK 7+ to compile the native JRuby extension part.**
+
+**NOTE:** Currently, one also needs to make sure to install all of the gem's
+[development dependencies][10] to make sure the compilation `javac` task does
+found it's dependent (Java) classes.
+
+Please note that the project manages multiple gems from a single repository,
+if you're using *Bundler* >= 1.2 it should be able to locate all gemspecs from
+the git repository. Sample *Gemfile* for running with (MySQL) master:
+
+```ruby
+gem 'activerecord-jdbc-adapter', :github => 'jruby/activerecord-jdbc-adapter'
+```
+
+## Getting Involved
+
+Please read our [CONTRIBUTING](CONTRIBUTING.md) & [RUNNING_TESTS](RUNNING_TESTS.md)
+guides for starters. You can always help us by maintaining AR-JDBC's [wiki][5].
+
+## Feedback
+
+Please report bugs at our [issue tracker][3]. If you're not sure if something's
+a bug, feel free to pre-report it on the [mailing lists][1] or ask on the #JRuby
+IRC channel on http://freenode.net/ (try [web-chat][6]).
+
+## Authors
+
+This project was originally written by [Nick Sieger](http://github.com/nicksieger)
+and [Ola Bini](http://github.com/olabini) with lots of help from the community.
+Polished 3.x compatibility and 4.x support (since AR-JDBC >= 1.3.0) was managed by
+[Karol Bucek](http://github.com/kares) among other fellow JRuby-ists.
+
+## License
+
+ActiveRecord-JDBC-Adapter is open-source released under the BSD/MIT license.
+See [LICENSE.txt](LICENSE.txt) included with the distribution for details.
+
+Open-source driver gems within AR-JDBC's sources are licensed under the same
+license the database's drivers are licensed. See each driver gem's LICENSE.txt.
+
+[0]: http://www.jruby.org/
+[1]: http://jruby.org/community
+[2]: http://github.com/jruby/activerecord-jdbc-adapter/blob/master/activerecord-jdbcmssql-adapter
+[3]: https://github.com/jruby/activerecord-jdbc-adapter/issues
+[4]: http://github.com/nicksieger/activerecord-cachedb-adapter
+[5]: https://github.com/jruby/activerecord-jdbc-adapter/wiki
+[6]: https://webchat.freenode.net/?channels=#jruby
+[7]: http://badge.fury.io/rb/activerecord-jdbc-adapter
+[8]: http://rubygems.org/search?query=activerecord-jdbc
+[9]: https://github.com/jruby/activerecord-jdbc-adapter/wiki/Migrating-from-1.3.x-to-1.4.0
+[10]: https://github.com/jruby/activerecord-jdbc-adapter/blob/master/activerecord-jdbc-adapter.gemspec

data/RUNNING_TESTS.md

@@ -0,0 +1,88 @@
+
+## Running AR-JDBC's Tests
+
+Most DB specific unit tests hide under the **test/db** directory, the files
+included in the *test* directory are mostly shared test modules and helpers.
+
+Rake tasks are loaded from **rakelib/02-test-rake**, most adapters have a
+corresponding test_[adapter] task e.g. `rake test_sqlite3` that run against DB.
+To check all available (test related) tasks simply `rake -T | grep test`.
+
+If the adapter supports creating a database it will try to do so automatically
+(most embed databases such as SQLite3) for some adapters (MySQL, PostgreSQL) we
+do this auto-magically (see the `rake db:create` tasks), but otherwise you'll
+need to setup a database dedicated for tests (using the standard tools that come
+with your DB installation).
+
+Connection parameters: database, host etc. can usually be changed from the shell
+`env` for adapters where there might be no direct control over the DB
+instance/configuration, e.g. for Oracle (by looking at **test/db/oracle.rb**)
+one might adapt the test database configuration using :
+```
+export ORACLE_HOST=192.168.1.2
+export ORACLE_USER=SAMPLE
+export ORACLE_PASS=sample
+export ORACLE_SID=MAIN
+```
+
+Tests are by default run against the "current" ActiveRecord version locked down
+by Bundler, however since we usually do support more versions from a single code
+base run those with the (appraisal) provided task e.g. for MySQL :
+
+    rake appraisal:rails32 test_mysql TEST=test/db/mysql/rake_test.rb
+
+Observe the **TEST** variable used to specify a single file to be used to resolve
+test cases, you pick tests by matching their names as well using **TESTOPTS** :
+
+    rake appraisal:rails40 test_postgres TESTOPTS="--name=/integer/"
+
+This of course also works when running the "plain" test (no appraisal:xxx) task.
+
+Since 1.3.0 we also support prepared statements, these are off by default (AR)
+but one can easily run tests with prepared statements enabled using env vars :
+
+    rake test_derby PS=true # or PREPARED_STATEMENTS=true
+
+To run tests against specific Rails version, make sure that the all
+required gems are installed. This can be checked by directly running
+the rake task. For eg., for Rails 4.2 :
+
+    rake appraisal:rails42
+
+If the required gems are not present, bundler will give error and will
+ask to do bundle install. This bundle install must be done with the
+Gemfile against which we are running tests. So in this case, bundle
+install can be done using :
+
+    BUNDLE_GEMFILE=gemfiles/rails42.gemfile bundle install
+
+### ActiveRecord (Rails) Tests
+
+It's very desirable to pass all unit tests from ActiveRecord's own test suite.
+Unfortunately it's been a while since we have accomplished that, luckily a lot
+of failures are artificial (and would require tweaks at the Rails repo itself),
+others simply need quality time spent to get them in shape and address issues.
+
+First make sure you have the ActiveRecord (Rails) sources cloned locally :
+
+    git clone git://github.com/rails/rails.git
+
+To run the AR-JDBC's sources agains AR tests, use the **rails:test** task, be
+sure to specify a **DRIVER** and the **RAILS** sources path on the file system :
+
+    jruby -S rake rails:test DRIVER=derby RAILS=path/to/rails_source_dir
+
+There's even tasks for Rails built-in adapters e.g. `rake rails:test_mysql`
+
+You will likely only be able to run the Rails suite against the latest (stable)
+ActiveRecord ~> version we support (check the *Gemfile.lock*) e.g. for
+**activerecord (3.2.x)** you want to **git checkout 3-2-stable** branch.
+
+We strive to not stub and include native (MRI) test required artefacts into
+(non-test) code e.g. the `Mysql` module, instead put that into **test/rails**.
+
+[![Build Status][0]](http://travis-ci.org/#!/jruby/activerecord-jdbc-adapter)
+
+Happy Testing!
+
+[0]: https://secure.travis-ci.org/jruby/activerecord-jdbc-adapter.png

data/Rakefile

@@ -0,0 +1,298 @@
+require 'rubygems' unless defined? Gem
+
+require 'rake/clean'
+
+CLEAN.include 'derby*', 'test.db.*', '*test.sqlite3', 'test/reports'
+CLEAN.include 'MANIFEST.MF', '*.log'
+
+task :default => :jar # RubyGems extention will do a bare `rake' e.g. :
+# jruby" -rubygems /opt/local/rvm/gems/jruby-1.7.16@jdbc/gems/rake-10.3.2/bin/rake
+#   RUBYARCHDIR=/opt/local/rvm/gems/jruby-1.7.16@jdbc/gems/activerecord-jdbc-adapter-1.4.0.dev/lib
+#   RUBYLIBDIR=/opt/local/rvm/gems/jruby-1.7.16@jdbc/gems/activerecord-jdbc-adapter-1.4.0.dev/lib
+#
+# under Bundler it points those DIRs to an empty one where only built extensions are stored :
+# jruby -rubygems /opt/local/rvm/gems/jruby-1.7.19@temp/gems/rake-10.4.2/bin/rake
+#   RUBYARCHDIR=/opt/local/rvm/gems/jruby-1.7.19@temp/bundler/gems/extensions/universal-java-1.7/1.9/activerecord-jdbc-adapter-472b5fddba43
+#   RUBYLIBDIR=/opt/local/rvm/gems/jruby-1.7.19@temp/bundler/gems/extensions/universal-java-1.7/1.9/activerecord-jdbc-adapter-472b5fddba43
+#
+# javac -target 1.6 -source 1.6 -Xlint:unchecked -g -cp
+#   "/opt/local/rvm/rubies/jruby-1.7.19/lib/jruby.jar:
+#    /opt/local/maven-repo/mysql/mysql-connector-java/5.1.33/mysql-connector-java-5.1.33.jar:
+#    /opt/local/maven-repo/org/postgresql/postgresql/9.4-1200-jdbc4/postgresql-9.4-1200-jdbc4.jar"
+#   -d /tmp/d20150417-32100-7mb1bk src/java/arjdbc/ArJdbcModule.java ...
+
+
+base_dir = Dir.pwd
+gem_name = 'activerecord-jdbc-adapter'
+gemspec_path = File.expand_path('activerecord-jdbc-adapter.gemspec', File.dirname(__FILE__))
+gemspec = lambda do
+  @_gemspec_ ||= Dir.chdir(File.dirname(__FILE__)) do
+    Gem::Specification.load(gemspec_path)
+  end
+end
+built_gem_path = lambda do
+  Dir[File.join(base_dir, "#{gem_name}-*.gem")].sort_by{ |f| File.mtime(f) }.last
+end
+current_version = lambda { gemspec.call.version }
+rake = lambda { |task| ruby "-S", "rake", task }
+
+# NOTE: avoid Bundler loading due native extension building!
+
+desc "Build #{gem_name} gem into the pkg directory."
+task :build => :jar do
+  sh("gem build -V '#{gemspec_path}'") do
+    gem_path = built_gem_path.call
+    file_name = File.basename(gem_path)
+    FileUtils.mkdir_p(File.join(base_dir, 'pkg'))
+    FileUtils.mv(gem_path, 'pkg')
+    puts "\n#{gem_name} #{current_version.call} built to 'pkg/#{file_name}'"
+  end
+end
+
+desc "Build and install #{gem_name} gem into system gems."
+task :install => :build do
+  gem_path = built_gem_path.call
+  sh("gem install '#{gem_path}' --local") do |ok|
+    raise "Couldn't install gem, run `gem install #{gem_path}' for more detailed output" unless ok
+    puts "\n#{gem_name} (#{current_version.call}) installed"
+  end
+end
+
+task 'release:do' => 'build:adapters' do
+  ENV['RELEASE'] == 'true' # so that .gemspec is built with adapter_java.jar
+  Rake::Task['build'].invoke
+
+  version = current_version.call; version_tag = "v#{version}"
+
+  sh("git diff --no-patch --exit-code") { |ok| fail "git working dir is not clean" unless ok }
+  sh("git diff-index --quiet --cached HEAD") { |ok| fail "git index is not clean" unless ok }
+
+  sh "git tag -a -m \"AR-JDBC #{version}\" #{version_tag}"
+  branch = `git rev-parse --abbrev-ref HEAD`.strip
+  puts "releasing from (current) branch #{branch.inspect}"
+  sh "for gem in `ls pkg/*-#{version}.gem`; do gem push $gem; done" do |ok|
+    sh "git push origin #{branch} --tags" if ok
+  end
+end
+
+task 'release:push' do
+  sh "for gem in `ls pkg/*-#{current_version.call}.gem`; do gem push $gem; done"
+end
+
+ADAPTERS = %w[derby h2 hsqldb mssql mysql postgresql sqlite3].map { |a| "activerecord-jdbc#{a}-adapter" }
+DRIVERS  = %w[derby h2 hsqldb jtds mysql postgres sqlite3].map { |a| "jdbc-#{a}" }
+TARGETS = ( ADAPTERS + DRIVERS )
+
+ADAPTERS.each do |target|
+  namespace target do
+    task :build do
+      version = current_version.call
+      Dir.chdir(target) { rake.call "build" }
+      cp FileList["#{target}/pkg/#{target}-#{version}.gem"], "pkg"
+    end
+  end
+end
+DRIVERS.each do |target|
+  namespace target do
+    task :build do
+      Dir.chdir(target) { rake.call "build" }
+      cp FileList["#{target}/pkg/#{target}-*.gem"], "pkg"
+    end
+  end
+end
+TARGETS.each do |target|
+  namespace target do
+    task :install do
+      Dir.chdir(target) { rake.call "install" }
+    end
+    task :release do
+      Dir.chdir(target) { rake.call "release" }
+    end
+  end
+end
+
+# DRIVERS
+
+desc "Build drivers"
+task "build:drivers" => DRIVERS.map { |name| "#{name}:build" }
+task "drivers:build" => 'build:drivers'
+
+desc "Install drivers"
+task "install:drivers" => DRIVERS.map { |name| "#{name}:install" }
+task "drivers:install" => 'install:drivers'
+
+# ADAPTERS
+
+desc "Build adapters"
+task "build:adapters" => [ 'build' ] + ADAPTERS.map { |name| "#{name}:build" }
+task "adapters:build" => 'build:adapters'
+
+desc "Install adapters"
+task "install:adapters" => [ 'install' ] + ADAPTERS.map { |name| "#{name}:install" }
+task "adapters:install" => 'install:adapters'
+
+# ALL
+
+task "build:all" => [ 'build' ] + TARGETS.map { |name| "#{name}:build" }
+task "all:build" => 'build:all'
+task "install:all" => [ 'install' ] + TARGETS.map { |name| "#{name}:install" }
+task "all:install" => 'install:all'
+
+require 'rake/testtask'
+
+begin
+  require 'appraisal'
+rescue LoadError; end
+
+# native JRuby extension (adapter_java.jar) compilation :
+
+if defined? JRUBY_VERSION
+  jar_file = 'lib/arjdbc/jdbc/adapter_java.jar'; CLEAN << jar_file
+  desc "Compile the native (Java) extension."
+  task :jar => jar_file
+
+  namespace :jar do
+    task :force do
+      rm jar_file if File.exist?(jar_file)
+      Rake::Task['jar'].invoke
+    end
+  end
+
+  #directory classes = 'pkg/classes'; CLEAN << classes
+
+  file jar_file => FileList[ 'src/java/**/*.java' ] do
+    source = target = '1.6'; debug = true
+    args = [ '-Xlint:unchecked' ]
+
+    get_driver_jars_local = lambda do |*args|
+      driver_deps = args.empty? ? [ :Postgres, :MySQL ] : args
+      driver_jars = []
+      driver_deps.each do |name|
+        driver_jars << Dir.glob("jdbc-#{name.to_s.downcase}/lib/*.jar").sort.last
+      end
+      if driver_jars.empty? # likely on a `gem install ...'
+        # NOTE: we're currently assuming jdbc-xxx (compile) dependencies are
+        # installed, they are declared as gemspec.development_dependencies !
+        # ... the other option is to simply `mvn prepare-package'
+        driver_deps.each do |name|
+          #require "jdbc/#{name.to_s.downcase}"
+          #driver_jars << Jdbc.const_get(name).driver_jar
+          # thanks Bundler for mocking RubyGems completely :
+          #spec = Gem::Specification.find_by_name("jdbc-#{name.to_s.downcase}")
+          #driver_jars << Dir.glob(File.join(spec.gem_dir, 'lib/*.jar')).sort.last
+          gem_name = "jdbc-#{name.to_s.downcase}"; matched_gem_paths = []
+          Gem.paths.path.each do |path|
+            base_path = File.join(path, "gems/")
+            Dir.glob(File.join(base_path, "*")).each do |gem_path|
+              if gem_path.sub(base_path, '').start_with?(gem_name)
+                matched_gem_paths << gem_path
+              end
+            end
+          end
+          if gem_path = matched_gem_paths.sort.last
+            driver_jars << Dir.glob(File.join(gem_path, 'lib/*.jar')).sort.last
+          end
+        end
+      end
+      driver_jars
+    end
+
+    get_driver_jars_maven = lambda do
+      require 'jar_dependencies'
+
+      requirements = gemspec.call.requirements
+      match_driver_jars = lambda do
+        matched_jars = []
+        gemspec.call.requirements.each do |requirement|
+          if match = requirement.match(/^jar\s+([\w\-\.]+):([\w\-]+),\s+?([\w\.\-]+)?/)
+            matched_jar = Jars.send :to_jar, match[1], match[2], match[3], nil
+            matched_jar = File.join( Jars.home, matched_jar )
+            matched_jars << matched_jar if File.exists?( matched_jar )
+          end
+        end
+        matched_jars
+      end
+
+      driver_jars = match_driver_jars.call
+      if driver_jars.size < requirements.size
+        if (ENV['JARS_SKIP'] || ENV_JAVA['jars.skip']) == 'true'
+          warn "jar resolving skipped, extension might not compile"
+        else
+          require 'jars/installer'
+          ENV['JARS_QUIET'] = 'true'
+          puts "resolving jar dependencies to build extension (should only happen once) ..."
+          installer = Jars::Installer.new( gemspec_path )
+          installer.install_jars( false )
+
+          driver_jars = match_driver_jars.call
+        end
+      end
+
+      driver_jars
+    end
+
+    if ENV['RUBYARCHDIR'] || ENV['BUILD_EXT_MAVEN'] == 'true'
+      driver_jars = get_driver_jars_maven.call
+    else
+      driver_jars = get_driver_jars_local.call
+    end
+
+    classpath = []
+    [ 'java.class.path', 'sun.boot.class.path' ].each do |key|
+      classpath += ENV_JAVA[key].split(File::PATH_SEPARATOR).find_all { |jar| jar =~ /jruby/i }
+    end
+    #classpath += ENV_JAVA['java.class.path'].split(File::PATH_SEPARATOR)
+    #classpath += ENV_JAVA['sun.boot.class.path'].split(File::PATH_SEPARATOR)
+
+    classpath += driver_jars
+    classpath = classpath.compact.join(File::PATH_SEPARATOR)
+
+    source_files = FileList[ 'src/java/**/*.java' ]
+
+    require 'tmpdir'
+
+    Dir.mktmpdir do |classes_dir|
+      # Cross-platform way of finding an executable in the $PATH.
+      # Thanks to @mislav
+      which = lambda do |cmd|
+        exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+        ENV['PATH'].split(File::PATH_SEPARATOR).map do |path|
+          exts.map { |ext| File.join(path, "#{cmd}#{ext}") }
+        end.flatten.select{|f| File.executable? f}.first
+      end
+
+      unless javac = which.call('javac')
+        warn "could not find javac, please make sure it's on the PATH"
+      end
+      javac = "#{javac} -target #{target} -source #{source} #{args.join(' ')}"
+      javac << " #{debug ? '-g' : ''}"
+      javac << " -cp \"#{classpath}\" -d #{classes_dir} #{source_files.join(' ')}"
+      sh(javac) do |ok|
+        raise 'could not build .jar extension - compilation failure' unless ok
+      end
+
+      # class_files = FileList["#{classes_dir}/**/*.class"].gsub("#{classes_dir}/", '')
+      # avoid environment variable expansion using backslash
+      # class_files.gsub!('$', '\$') unless windows?
+      # args = class_files.map { |path| [ "-C #{classes_dir}", path ] }.flatten
+      args = [ '-C', "#{classes_dir}/ ." ] # args = class_files
+
+      jar_path = jar_file
+      if ext_lib_dir = ENV['RUBYLIBDIR']
+        jar_path = File.join(ext_lib_dir, File.basename(jar_file))
+      end
+
+      unless jar = which.call('jar')
+        warn "could not find jar tool, please make sure it's on the PATH"
+      end
+      sh("#{jar} cf #{jar_path} #{args.join(' ')}") do |ok|
+        raise 'could not build .jar extension - packaging failure' unless ok
+      end
+      cp jar_path, jar_file if ext_lib_dir # NOTE: hopefully RG won't mind?!
+    end
+  end
+else
+  task :jar do
+    puts "please run `rake jar' under JRuby to re-compile the native (Java) extension"
+  end
+end