jdbc 0.1.1-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 69bedbae4b303c6012ca4f3d78129a649c0c06c7
+  data.tar.gz: b37d77323e4f7bc6abb01dd784d660e7d0e5ff78
+SHA512:
+  metadata.gz: 19fc18118b3de10225daa97d8278fef83357184cf627d9e3ebd0644aea9ae519576986e0c4c2f726dbf6d5a36e1e785dba25afb15338276822dd86c16dd6d2e3
+  data.tar.gz: 4eb87016ece80757b34e4d3e3066d96d4dc2b52ff24a77b67b5273fd35e4223d75cd129f9e9de6e005921db307dd6396fac40ba558b2418f2cbc5f19ef208735

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.irbrc

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift("lib")
+require "jdbc"

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,48 @@
+AllCops:
+  TargetRubyVersion: 2.3
+
+Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Max: 32
+  Exclude:
+    - "spec/**/*.rb"
+
+Metrics/ClassLength:
+  Max: 120
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/MethodLength:
+  Max: 12
+
+Style/AndOr:
+  EnforcedStyle: conditionals
+
+Style/Encoding:
+  EnforcedStyle: when_needed
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/IndentHash:
+  Enabled: false
+
+Style/PercentLiteralDelimiters:
+  PreferredDelimiters:
+    "%i": "[]"
+    "%I": "[]"
+    "%w": "[]"
+    "%W": "[]"
+
+Style/RedundantSelf:
+  Enabled: false
+
+Style/SignalException:
+  Enabled: true
+  EnforcedStyle: semantic
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+## 0.1.1
+
+* fixed SQL parsing when parentheses present around bindings
+
+## 0.1.0
+
+* initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at ja AT jestem DOT tw. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Dockerfile

@@ -0,0 +1,13 @@
+FROM jruby:9.1.7.0-jre-alpine
+
+RUN apk --update --no-cache add git openssh-client && \
+    gem install bundler && \
+    mkdir /jdbc
+
+WORKDIR /jdbc
+
+COPY jdbc.gemspec Gemfile Gemfile.lock ./
+
+RUN bundle
+
+COPY . ./

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,103 @@
+PATH
+  remote: .
+  specs:
+    jdbc (0.1.1-java)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.3.0)
+    coderay (1.1.1)
+    concurrent-ruby (1.0.5-java)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    dry-configurable (0.6.1)
+      concurrent-ruby (~> 1.0)
+    dry-container (0.6.0)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 0.1, >= 0.1.3)
+    dry-core (0.2.4)
+      concurrent-ruby (~> 1.0)
+    dry-equalizer (0.2.0)
+    dry-logic (0.4.1)
+      dry-container (~> 0.2, >= 0.2.6)
+      dry-core (~> 0.2)
+      dry-equalizer (~> 0.2)
+    dry-types (0.9.4)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 0.1)
+      dry-container (~> 0.3)
+      dry-core (~> 0.2, >= 0.2.1)
+      dry-equalizer (~> 0.2)
+      dry-logic (~> 0.4, >= 0.4.0)
+      inflecto (~> 0.0.0, >= 0.0.2)
+    dry-validation (0.10.5)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 0.1, >= 0.1.3)
+      dry-core (~> 0.2, >= 0.2.1)
+      dry-equalizer (~> 0.2)
+      dry-logic (~> 0.4, >= 0.4.0)
+      dry-types (~> 0.9, >= 0.9.0)
+    ffi (1.9.17-java)
+    hucpa (0.2.2-java)
+      dry-validation (~> 0.10)
+    inflecto (0.0.2)
+    jdbc-postgres (9.4.1206)
+    json (2.0.3-java)
+    method_source (0.8.2)
+    parser (2.4.0.0)
+      ast (~> 2.2)
+    powerpack (0.1.1)
+    pry (0.10.4-java)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+      spoon (~> 0.0)
+    rainbow (2.2.1)
+    rake (12.0.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    rubocop (0.47.1)
+      parser (>= 2.3.3.1, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    ruby-progressbar (1.8.1)
+    simplecov (0.13.0)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    spoon (0.0.6)
+      ffi
+    unicode-display_width (1.1.3)
+
+PLATFORMS
+  java
+
+DEPENDENCIES
+  bundler (~> 1.14)
+  hucpa (~> 0)
+  jdbc!
+  jdbc-postgres (~> 9.4)
+  pry (~> 0)
+  rake (~> 12.0)
+  rspec (~> 3.5)
+  rubocop (~> 0)
+  simplecov (~> 0)
+
+BUNDLED WITH
+   1.14.5

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Tomek Wałkuski
+
+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.md

@@ -0,0 +1,246 @@
+# JDBC
+
+[![Code Climate](https://codeclimate.com/github/tomekw/jdbc/badges/gpa.svg)](https://codeclimate.com/github/tomekw/jdbc) [![Gem Version](https://badge.fury.io/rb/jdbc.svg)](https://badge.fury.io/rb/jdbc) [![CircleCI](https://circleci.com/gh/tomekw/jdbc.svg?style=svg)](https://circleci.com/gh/tomekw/jdbc)
+
+JDBC meets JRuby.
+
+Please note the project supports only JRuby (tested with 9.1.7.0+) on Java 8.
+
+The public API is subject to change before version `1.0.0`.
+
+The library is in the alpha state. It has been tested only with the `PostgreSQL` database, only basic queries and commands were tested.
+Please raise issues if any of your use cases is not working and I will be very happy to help!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "jdbc"
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install jdbc
+
+## Public API
+
+| Method                        | Description                                 | Returned value                                              |
+| ----------------------------- | ------------------------------------------- | ----------------------------------------------------------- |
+| `command(sql, bindings = {})` | `INSERT`s, `UPDATE`s, `DELETE`s, etc. calls | Depending on the driver, either full record or primary keys |
+| `ddl(sql, bindings = {})`     | `CREATE TABLES`s, `ADD INDEX`es, etc. calls | `true` or driver exception                                  |
+| `query(sql, bindings = {})`   | `SELECT`s, etc. calls                       | Ruby `Array` of `Hashes`                                    |
+
+## Usage
+
+Install the database driver, for PostgreSQL:
+
+```ruby
+gem "jdbc-postgres"
+```
+
+Load the the database driver if needed, for PostgreSQL:
+
+```ruby
+require "jdbc/postgres"
+Jdbc::Postgres.load_driver
+```
+
+Configure the connection pool:
+
+```ruby
+gem "hucpa"
+```
+
+```ruby
+require "hucpa"
+
+# Using the adapter option
+options = {
+  adapter: :postgresql,
+  database_name: "jdbc",
+  password: "jdbc",
+  server_name: "postgres",
+  username: "jdbc"
+}
+
+# Using the jdbc_url option
+options = {
+  jdbc_url: "jdbc:postgresql://postgres/jdbc",
+  password: "jdbc",
+  username: "jdbc"
+}
+
+connection_pool = Hucpa::ConnectionPool.new(options)
+
+gateway = JDBC::Gateway.new(connection_pool: connection_pool)
+```
+
+Query for records:
+
+```ruby
+gateway.query("SELECT * FROM things")
+=> [
+  {
+    id: 1,
+    name: "Foo",
+    created_at: Time.parse("2017-02-01 10:20:45")
+  },
+  {
+    id: 2,
+    name: "Bar",
+    created_at: Time.parse("2017-02-01 10:21:47")
+  }
+]
+```
+
+Query bindings can be provided:
+
+```ruby
+gateway.query("SELECT * FROM things WHERE name = :name", name: "Foo")
+=> [
+  {
+    id: 1,
+    name: "Foo",
+    created_at: Time.parse("2017-02-01 10:20:45")
+  }
+]
+```
+
+Optionally, bindings can be annotated with a [JDBC type](#jdbc-types).
+It is in fact required when value can be `nil`:
+
+```ruby
+gateway.query("SELECT * FROM things WHERE name = :name:VARCHAR OR (name IS NULL AND :name:VARCHAR IS NULL)", name: nil)
+=> [
+  {
+    id: 3,
+    name: nil,
+    created_at: Time.parse("2017-02-02 10:20:45")
+  }
+]
+```
+
+Pass commands:
+
+```ruby
+gateway.command("INSERT INTO things (name, created_at) VALUES (:name, :created_at)", name: "Foo", created_at: Time.parse("2017-02-02 10:20:45"))
+=> [
+  {
+    id: 4,
+    name: "Foo",
+    created_at: Time.parse("2017-02-02 10:20:45")
+  }
+]
+```
+
+```ruby
+gateway.command("UPDATE things SET name = :name WHERE id < :id", name: "Bar", id: 2)
+=> [
+  {
+    id: 1,
+    name: "Bar",
+    created_at: Time.parse("2017-02-02 10:20:45")
+  }
+]
+```
+
+```ruby
+gateway.command("DELETE FROM things WHERE id = :id", id: 1)
+=> [
+  {
+    id: 1,
+    name: "Bar",
+    created_at: Time.parse("2017-02-02 10:20:45")
+  }
+]
+```
+
+Invoke DDL calls:
+
+```ruby
+gateway.ddl("CREATE INDEX name_idx ON things(name)")
+=> true
+```
+
+Close the connection pool:
+
+```ruby
+connection_pool.close
+```
+
+## (Known) things that won't work (yet)
+
+* groupping SQL queries / commands in transactions
+
+## JDBC types
+
+* `ARRAY`
+* `BIGINT`
+* `BINARY`
+* `BIT`
+* `BLOB`
+* `BOOLEAN`
+* `CHAR`
+* `CLOB`
+* `DATALINK`
+* `DATE`
+* `DECIMAL`
+* `DISTINCT`
+* `DOUBLE`
+* `FLOAT`
+* `INTEGER`
+* `JAVA_OBJECT`
+* `LONGNVARCHAR`
+* `LONGVARBINARY`
+* `LONGVARCHAR`
+* `NCHAR`
+* `NCLOB`
+* `NULL`
+* `NUMERIC`
+* `NVARCHAR`
+* `OTHER`
+* `REAL`
+* `REF`
+* `REF_CURSOR`
+* `ROWID`
+* `SMALLINT`
+* `SQLXML`
+* `STRUCT`
+* `TIME`
+* `TIME_WITH_TIMEZONE`
+* `TIMESTAMP`
+* `TIMESTAMP_WITH_TIMEZONE`
+* `TINYINT`
+* `VARBINARY`
+* `VARCHAR`
+
+## Development
+
+Build the Docker image:
+
+    $ docker-compose build
+
+Create services:
+
+    $ docker-compose create
+
+Run specs:
+
+    $ docker-compose run --rm app rspec spec
+
+Run console:
+
+    $ docker-compose run --rm app irb
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/tomekw/jdbc. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+load "lib/tasks/ci.rake"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new(:rubocop)
+
+task default: :spec

data/circle.yml

@@ -0,0 +1,17 @@
+machine:
+  services:
+    - docker
+
+database:
+  override:
+    - psql -U ubuntu -c "CREATE USER jdbc WITH SUPERUSER PASSWORD 'jdbc'"
+    - psql -U ubuntu -c "CREATE DATABASE jdbc OWNER jdbc"
+
+dependencies:
+  override:
+    - docker build --rm=false -t tomekw/jdbc .
+
+test:
+  override:
+    - docker run --net=host --env DATABASE_HOST=localhost --rm tomekw/jdbc rubocop
+    - docker run --net=host --env DATABASE_HOST=localhost --rm tomekw/jdbc rspec spec

data/docker-compose.yml

@@ -0,0 +1,22 @@
+version: "2"
+services:
+  app:
+    build: .
+    depends_on:
+      - postgres
+    environment:
+      JRUBY_OPTS: --debug
+    volumes:
+      - .:/jdbc
+      - ${HOME}/.ssh:/root/.ssh:ro
+      - ${HOME}/.gem:/root/.gem:rw
+  postgres:
+    environment:
+      POSTGRES_USER: jdbc
+      POSTGRES_PASSWORD: jdbc
+    image: postgres:9.6.2
+    volumes:
+      - postgres:/var/lib/postgresql/data
+volumes:
+  postgres:
+    driver: local

data/jdbc.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name = "jdbc"
+  spec.version = "0.1.1"
+  spec.authors = ["Tomek Wałkuski"]
+  spec.email = "ja@jestem.tw"
+
+  spec.summary = "JDBC meets JRuby"
+  spec.homepage = "https://github.com/tomekw/jdbc"
+  spec.license = "MIT"
+
+  spec.platform = "java"
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.require_paths = %w[lib]
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "hucpa", "~> 0"
+  spec.add_development_dependency "jdbc-postgres", "~> 9.4"
+  spec.add_development_dependency "pry", "~> 0"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.5"
+  spec.add_development_dependency "rubocop", "~> 0"
+  spec.add_development_dependency "simplecov", "~> 0"
+end

data/lib/jdbc.rb

@@ -0,0 +1,15 @@
+require "jdbc/action"
+require "jdbc/coercions"
+require "jdbc/column"
+require "jdbc/command"
+require "jdbc/ddl"
+require "jdbc/gateway"
+require "jdbc/prepared_statement_builder"
+require "jdbc/query"
+require "jdbc/result_set_meta_data"
+require "jdbc/result_set_transformer"
+require "jdbc/sql_parser"
+require "jdbc/uuid"
+
+module JDBC
+end

data/lib/jdbc/action.rb

@@ -0,0 +1,32 @@
+module JDBC
+  class Action
+    def initialize(connection:, sql:, bindings:)
+      @connection = connection
+      @sql = sql
+      @bindings = bindings
+    end
+
+    def run
+      ResultSetTransformer.new(result_set: result_set).transform
+    ensure
+      result_set&.close
+      statement&.close
+    end
+
+    private
+
+    attr_reader :connection, :sql, :bindings
+
+    def parsed_sql
+      @parsed_sql ||= SqlParser.new(sql: sql, bindings: bindings).parse
+    end
+
+    def jdbc_sql
+      parsed_sql.first
+    end
+
+    def binding_values
+      parsed_sql.last
+    end
+  end
+end

data/lib/jdbc/coercions.rb

@@ -0,0 +1,18 @@
+module JDBC
+  module Coercions
+    def identity
+      @identity ||= ->(value) { value }
+    end
+    module_function :identity
+
+    def to_s
+      @to_s ||= ->(value) { value.to_s }
+    end
+    module_function :to_s
+
+    def to_time
+      @to_time ||= ->(value) { Time.parse(value.to_s) }
+    end
+    module_function :to_time
+  end
+end

data/lib/jdbc/column.rb

@@ -0,0 +1,21 @@
+module JDBC
+  class Column
+    attr_reader :index, :label, :jdbc_type
+
+    def initialize(index:, label:, jdbc_type:)
+      @index = index
+      @label = label
+      @jdbc_type = jdbc_type
+    end
+
+    def coerce_proc
+      Coercions.public_send(COERCIONS_MAP.fetch(jdbc_type, :identity))
+    end
+
+    COERCIONS_MAP = {
+      uuid: :to_s,
+      timestamp: :to_time
+    }.freeze
+    private_constant :COERCIONS_MAP
+  end
+end

data/lib/jdbc/command.rb

@@ -0,0 +1,21 @@
+module JDBC
+  class Command < Action
+    private
+
+    def result_set
+      @result_set ||=
+        begin
+          statement.execute_update
+          statement.get_generated_keys
+        end
+    end
+
+    def statement
+      @statement ||= PreparedStatementBuilder.for_command(
+        connection: connection,
+        jdbc_sql: jdbc_sql,
+        binding_values: binding_values
+      )
+    end
+  end
+end

data/lib/jdbc/ddl.rb

@@ -0,0 +1,21 @@
+module JDBC
+  class DDL < Action
+    def run
+      result_set.zero?
+    end
+
+    private
+
+    def result_set
+      @result_set ||= statement.execute_update
+    end
+
+    def statement
+      @statement ||= PreparedStatementBuilder.for_query(
+        connection: connection,
+        jdbc_sql: jdbc_sql,
+        binding_values: binding_values
+      )
+    end
+  end
+end

data/lib/jdbc/gateway.rb

@@ -0,0 +1,22 @@
+module JDBC
+  class Gateway
+    def initialize(connection_pool:)
+      @connection_pool = connection_pool
+    end
+
+    %w[Command DDL Query].each do |action_name|
+      define_method(action_name.downcase) do |sql, bindings = {}|
+        connection_pool.with_connection do |connection|
+          JDBC
+            .const_get(action_name)
+            .new(connection: connection, sql: sql, bindings: bindings)
+            .run
+        end
+      end
+    end
+
+    private
+
+    attr_reader :connection_pool
+  end
+end

data/lib/jdbc/prepared_statement_builder.rb

@@ -0,0 +1,89 @@
+module JDBC
+  class PreparedStatementBuilder
+    def initialize(statement:, binding_values:)
+      @statement = statement
+      @binding_values = binding_values
+    end
+
+    def self.for_command(connection:, jdbc_sql:, binding_values:)
+      new(
+        statement: connection.prepare_statement(jdbc_sql, java.sql.Statement::RETURN_GENERATED_KEYS),
+        binding_values: binding_values
+      ).build
+    end
+
+    def self.for_query(connection:, jdbc_sql:, binding_values:)
+      new(
+        statement: connection.prepare_statement(jdbc_sql),
+        binding_values: binding_values
+      ).build
+    end
+
+    def build
+      binding_values.each_with_index do |(value, type), index|
+        method_name, method_parameters = ParameterSetter.new(
+          index: index,
+          value: value,
+          type: type
+        ).build
+
+        statement.public_send(method_name, *method_parameters)
+      end
+
+      statement
+    end
+
+    private
+
+    attr_reader :statement, :binding_values
+
+    class ParameterSetter
+      def initialize(index:, value:, type:)
+        @index = index
+        @value = value
+        @type = type
+      end
+
+      def build
+        [method_name, method_parameters]
+      end
+
+      private
+
+      attr_reader :index, :value, :type
+
+      def method_name
+        value.nil? ? :set_null : :set_object
+      end
+
+      def method_parameters
+        if value.nil?
+          [parameter_index, jdbc_type || java.sql.Types::NULL]
+        else
+          [parameter_index, java_value, jdbc_type].compact
+        end
+      end
+
+      def parameter_index
+        index + 1
+      end
+
+      def jdbc_type
+        type ? java.sql.Types.const_get(type) : nil
+      end
+
+      def uuid_value
+        @uuid_value ||= UUID.new(value)
+      end
+
+      def java_value
+        if uuid_value.valid?
+          uuid_value
+        else
+          value
+        end.to_java
+      end
+    end
+    private_constant :ParameterSetter
+  end
+end

data/lib/jdbc/query.rb

@@ -0,0 +1,17 @@
+module JDBC
+  class Query < Action
+    private
+
+    def result_set
+      @result_set ||= statement.execute_query
+    end
+
+    def statement
+      @statement ||= PreparedStatementBuilder.for_query(
+        connection: connection,
+        jdbc_sql: jdbc_sql,
+        binding_values: binding_values
+      )
+    end
+  end
+end

data/lib/jdbc/result_set_meta_data.rb

@@ -0,0 +1,29 @@
+module JDBC
+  class ResultSetMetaData
+    def initialize(result_set:)
+      @result_set = result_set
+    end
+
+    def parse
+      columns_range.map do |index|
+        Column.new(
+          index: index,
+          label: meta_data.get_column_label(index).to_sym,
+          jdbc_type: meta_data.get_column_type_name(index).to_sym
+        )
+      end
+    end
+
+    private
+
+    attr_reader :result_set
+
+    def meta_data
+      @meta_data ||= result_set.meta_data
+    end
+
+    def columns_range
+      1..meta_data.column_count
+    end
+  end
+end

data/lib/jdbc/result_set_transformer.rb

@@ -0,0 +1,26 @@
+module JDBC
+  class ResultSetTransformer
+    def initialize(result_set:)
+      @result_set = result_set
+    end
+
+    def transform
+      [].tap do |results|
+        while result_set.next
+          results << meta_data.each_with_object({}) do |column, record|
+            record[column.label] =
+              column.coerce_proc.call(result_set.get_object(column.index))
+          end
+        end
+      end
+    end
+
+    private
+
+    attr_reader :result_set
+
+    def meta_data
+      @meta_data ||= ResultSetMetaData.new(result_set: result_set).parse
+    end
+  end
+end

data/lib/jdbc/sql_parser.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+module JDBC
+  class SqlParser
+    def initialize(sql:, bindings:)
+      @sql = sql
+      @bindings = bindings
+    end
+
+    def parse
+      fail ArgumentError, sql_binding_mismatch_msg if sql_binding_mismatch?
+
+      [jdbc_sql, binding_values]
+    end
+
+    private
+
+    attr_reader :sql, :bindings
+
+    JAVA_SQL_TYPES = %w[
+      ARRAY
+      BIGINT
+      BINARY
+      BIT
+      BLOB
+      BOOLEAN
+      CHAR
+      CLOB
+      DATALINK
+      DATE
+      DECIMAL
+      DISTINCT
+      DOUBLE
+      FLOAT
+      INTEGER
+      JAVA_OBJECT
+      LONGNVARCHAR
+      LONGVARBINARY
+      LONGVARCHAR
+      NCHAR
+      NCLOB
+      NULL
+      NUMERIC
+      NVARCHAR
+      OTHER
+      REAL
+      REF
+      REF_CURSOR
+      ROWID
+      SMALLINT
+      SQLXML
+      STRUCT
+      TIME
+      TIME_WITH_TIMEZONE
+      TIMESTAMP
+      TIMESTAMP_WITH_TIMEZONE
+      TINYINT
+      VARBINARY
+      VARCHAR
+    ].freeze
+    private_constant :JAVA_SQL_TYPES
+
+    COLON = ":"
+    private_constant :COLON
+
+    EMPTY_STRING = ""
+    private_constant :EMPTY_STRING
+
+    NONE = "(none)"
+    private_constant :NONE
+
+    JOIN_COMMA = ", "
+    private_constant :JOIN_COMMA
+
+    LEFT_PAREN = "("
+    private_constant :LEFT_PAREN
+
+    RIGHT_PAREN = ")"
+    private_constant :RIGHT_PAREN
+
+    PIPE = "|"
+    private_constant :PIPE
+
+    QUESTION_MARK = "?"
+    private_constant :QUESTION_MARK
+
+    SQL_TAGS_REGEX = /(?:[\s\(]):(\w+)(?::(#{JAVA_SQL_TYPES.join(PIPE)}))?(?:[\s,;\)]|\z)/
+    private_constant :SQL_TAGS_REGEX
+
+    TAG_CLEANUP_REGEX = /#{COLON}(#{JAVA_SQL_TYPES.reverse.join(PIPE)})?/
+    private_constant :TAG_CLEANUP_REGEX
+
+    def binding_names
+      @binding_names ||= bindings.keys.map(&:to_sym)
+    end
+
+    def binding_values
+      sql_tags.each_with_object([]) do |(tag, type), values|
+        values << [bindings.fetch(tag)].flatten.map { |value| [value, type] }
+      end.flatten(1)
+    end
+
+    def sql_tag_names
+      @sql_tag_names ||= sql_tags.map(&:first)
+    end
+
+    def sql_tags
+      @sql_tags ||= sql.scan(SQL_TAGS_REGEX).map do |(tag, type)|
+        [tag.to_sym, type]
+      end
+    end
+
+    def replace_sql_tags_regex
+      @replace_sql_tags_regex ||= /:(#{sql_tags.map { |t| t.compact.join(COLON) }.join(PIPE) })/
+    end
+
+    def jdbc_sql
+      sql_tags.empty? ? sql : parsed_sql
+    end
+
+    def parsed_sql
+      sql.gsub(replace_sql_tags_regex) do |tag|
+        tag_name = tag.gsub(TAG_CLEANUP_REGEX, EMPTY_STRING).to_sym
+        tag_value = bindings.fetch(tag_name)
+
+        if tag_value.is_a?(Array)
+          LEFT_PAREN + tag_value.map { QUESTION_MARK }.join(JOIN_COMMA) + RIGHT_PAREN
+        else
+          QUESTION_MARK
+        end
+      end
+    end
+
+    def sql_binding_mismatch?
+      binding_names.sort != sql_tag_names.uniq.sort
+    end
+
+    def sql_binding_mismatch_msg
+      given = binding_names.join(", ")
+      expected = sql_tag_names.join(", ")
+
+      given_msg = given.empty? ? NONE : given
+      expected_msg = expected.empty? ? NONE : expected
+
+      "SQL query bindings mismatch, given: #{given_msg}, expected: #{expected_msg}"
+    end
+  end
+end

data/lib/jdbc/uuid.rb

@@ -0,0 +1,22 @@
+module JDBC
+  class UUID
+    def initialize(value)
+      @value = value.to_s
+    end
+
+    def to_java
+      java.util.UUID.from_string(value)
+    end
+
+    def valid?
+      !UUID_REGEX.match(value).nil?
+    end
+
+    private
+
+    attr_reader :value
+
+    UUID_REGEX = /^[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i
+    private_constant :UUID_REGEX
+  end
+end

data/lib/tasks/ci.rake

@@ -0,0 +1,8 @@
+require "rubocop/rake_task"
+
+namespace :ci do
+  RuboCop::RakeTask.new(:rubocop)
+
+  desc "Run all CI checks"
+  task run: %i[rubocop spec]
+end

metadata

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification
+name: jdbc
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: java
+authors:
+- Tomek Wałkuski
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2017-02-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  name: bundler
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: hucpa
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.4'
+  name: jdbc-postgres
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.4'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: pry
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  name: rake
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  name: rspec
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: rubocop
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  name: simplecov
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email: ja@jestem.tw
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".irbrc"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- circle.yml
+- docker-compose.yml
+- jdbc.gemspec
+- lib/jdbc.rb
+- lib/jdbc/action.rb
+- lib/jdbc/coercions.rb
+- lib/jdbc/column.rb
+- lib/jdbc/command.rb
+- lib/jdbc/ddl.rb
+- lib/jdbc/gateway.rb
+- lib/jdbc/prepared_statement_builder.rb
+- lib/jdbc/query.rb
+- lib/jdbc/result_set_meta_data.rb
+- lib/jdbc/result_set_transformer.rb
+- lib/jdbc/sql_parser.rb
+- lib/jdbc/uuid.rb
+- lib/tasks/ci.rake
+homepage: https://github.com/tomekw/jdbc
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project:
+rubygems_version: 2.6.8
+signing_key:
+specification_version: 4
+summary: JDBC meets JRuby
+test_files: []