First somewhat working version. mssql + oracle + postgresql

Author: Elliot

.circleci/config.yml

@@ -0,0 +1,92 @@
+version: 2.1
+
+commands:
+  build_driver:
+    description: "package up a jdbc driver as a go sql driver"
+    parameters:
+      driver_name:
+        type: string
+      artifacts:
+        type: string
+        default: ""
+    steps:
+      - run: wrapper/scripts/wrap-<< parameters.driver_name >>.sh
+      - persist_to_workspace:
+          root: .
+          paths: 
+            - << parameters.driver_name >>/<< parameters.artifacts >>
+
+jobs:
+  linux:
+    working_directory: ~/work
+    docker:
+      - image: raonigabriel/graalvm-playground:19.0.0
+    environment: 
+      _JAVA_OPTIONS: "-XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap -Xms1000m -Xmx1436m -XX:MaxMetaspaceSize=1436m -XX:ParallelGCThreads=1 -XX:ConcGCThreads=1 -Djava.util.concurrent.ForkJoinPool.common.parallelism=2"
+    steps:
+      - checkout
+      - restore_cache:
+          key: gdbc-linux-{{ checksum "wrapper/pom.xml" }}
+      - build_driver:
+          driver_name: postgresql
+      - build_driver:
+          driver_name: mssql
+      - build_driver:
+          driver_name: oracle
+      - save_cache:
+          paths:
+            - ~/.m2
+          key: gdbc-linux-{{ checksum "wrapper/pom.xml" }}
+
+  mac:
+    working_directory: ~/work
+    macos:
+      xcode: "10.0.0"
+    steps:
+      - checkout
+      - restore_cache:
+          key: gdbc-mac-{{ checksum "wrapper/pom.xml" }}
+      - run: wrapper/setup-mac.sh
+      - build_driver:
+          driver_name: postgresql
+          artifacts: libgdbc-postgresql.dylib
+      - build_driver:
+          driver_name: mssql
+          artifacts: libgdbc-mssql.dylib
+      - build_driver:
+          driver_name: oracle
+          artifacts: libgdbc-oracle.dylib
+      - save_cache:
+          paths:
+            - ~/.m2
+          key: gdbc-mac-{{ checksum "wrapper/pom.xml" }}
+  
+  commit_drivers:
+    docker:
+      - image: circleci/golang:latest
+    steps:
+      - checkout
+      - attach_workspace:
+           at: .
+      - run: git config user.email "elliot@identitii.com"
+      - run: git config user.name "Elliot Shepherd (CI)"
+      - run: git status
+      - run: git add .
+      - run: git status
+      - run: git commit -m "[auto] update packaged drivers [skip ci]"
+      - run: git push --set-upstream origin ${CIRCLE_BRANCH}
+
+workflows:
+  version: 2
+  build:
+    jobs:
+      - linux
+      - mac
+      - approve_release:
+          type: approval
+          requires:
+            - linux
+            - mac
+      - commit_drivers:
+          requires:
+            - approve_release

.gitignore

@@ -1,4 +1,12 @@
 wrapper/target
 wrapper/.settings
 wrapper/.classpath
-wrapper/.project
+wrapper/.project
+\.vscode/
+examples/sqlx/sqlx
+\.dockercache
+wrapper-old/
+
+wrapper/graal\.tar\.gz
+
+wrapper/graalvm-ce-19\.1\.0/

.gitlab-ci.yml

@@ -0,0 +1,82 @@
+cache:
+  paths:
+    - .m2/
+
+variables:
+  MAVEN_OPTS: "-Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=WARN -Dmaven.repo.local=.m2"
+
+stages:
+  - build
+  - build_tests
+  - test
+
+mssql:
+  stage: build
+  image: raonigabriel/graalvm-playground:19.0.0
+  script: wrapper/scripts/wrap-mssql.sh
+  artifacts:
+    paths:
+      - mssql/
+
+oracle:
+  stage: build
+  image: raonigabriel/graalvm-playground:19.0.0
+  script: wrapper/scripts/wrap-oracle.sh
+  artifacts:
+    paths:
+      - oracle/
+
+postgresql:
+  stage: build
+  image: raonigabriel/graalvm-playground:19.0.0
+  script: wrapper/scripts/wrap-postgresql.sh
+  artifacts:
+    paths:
+      - postgresql/
+
+mssql_test:
+  stage: test
+  image: golang:1.12
+  services:
+    - name: registry.gitlab.com/identitii/gdbc/mssql:2017-CU12-ubuntu
+      alias: db
+  dependencies:
+    - mssql
+  variables:
+    ACCEPT_EULA: "Y"
+    SA_PASSWORD: yourStrong(!)Password
+    MSSQL_DB: test
+    MSSQL_USER: root
+    MSSQL_PASSWORD: yourStrong(!)Password
+    MSSQL_HOST: db
+  script: ./benchmark.sh mssql
+
+oracle_test:
+  stage: test
+  image: golang:1.12
+  services:
+    - name: registry.gitlab.com/identitii/gdbc/oracle:12c-r1
+      alias: db
+  dependencies:
+    - oracle
+  variables:
+    ORACLE_DB: xe
+    ORACLE_USER: GDBCUSER
+    ORACLE_PASSWORD: password
+    ORACLE_HOST: db
+  script: sleep 30 && ./benchmark.sh oracle
+
+postgresql_test:
+  stage: test
+  image: golang:1.12
+  services:
+    - name: postgres:latest
+      alias: db
+  dependencies:
+    - postgresql
+  variables:
+    POSTGRES_DB: test
+    POSTGRES_USER: root
+    POSTGRES_PASSWORD: password
+    POSTGRES_HOST: db
+  script: ./benchmark.sh postgresql

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2019 identiii Ltd.
+Copyright (c) 2019 identitii Ltd.
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

README.md

@@ -1,25 +1,108 @@
-(VERY MUCH WIP - This doesn't work yet)
+
+
+<img src="logo.png" width="25%" align="right"/>
 
 # GDBC - Golang JDBC Driver Wrapper
 
-## What?
-Allows you to load and use Java database drivers from go.
+[![CircleCI](https://img.shields.io/circleci/build/github/identitii/gdbc.svg?token=59c033cd63c3d550c1a21cd6bc3bef5023a09c5a)](https://circleci.com/gh/identitii/gdbc/tree/master)
+[![Godoc](http://img.shields.io/badge/godoc-reference-blue.svg?style=flat)](https://godoc.org/github.com/identitii/gdbc) 
+[![license](http://img.shields.io/badge/license-MIT-red.svg?style=flat)](https://raw.githubusercontent.com/identitii/gdbc/master/LICENSE)
+
+Load and use JDBC Java database drivers from go. Without Java.
+
+## IMPORTANT NOTES:
+ - This is VERY MUCH WIP - it 'works' but has barely been tested/benchmarked. PRs/bug reports/feature requests gratefully received.
+ - This repository will change. Do not rely on it yet. Compatibility is not guaranteed.
+ - Very likely the drivers will be split into their own modules or repos.
+
+
+### Supported Drivers
+
+More may be supported, but these are the ones we package, test, and distribute.
+
+- Microsoft SQL Server (mssql)
+  - com.microsoft.sqlserver:mssql-jdbc:7.3.0.jre8-preview
+- Oracle DB (oracle)
+  - com.oracle:ojdbc6:12.1.0.1
+- PostgreSQL (postgresql)
+  - org.postgresql:postgresql:42.2.5.jre6
+
+### Usage
+
+Import oracle, mssql, or postgresql driver.
+
+```golang
+import _ "github.com/identitii/gdbc/oracle"
+```
+
+Use `gdbc-(oracle|mssql|postgresql)` as the driver name, and pass in the JDBC connection string (which is passed straight through to the driver)
+
+```golang
+pool, err = sql.Open("gdbc-oracle", "jdbc:oracle:thin:user/password@host:1521:sid")
+```
+
+When starting your application, it will look for the compiled driver shared library in the current directory (@executable_path)
+e.g. libgdbc-postgresql.dylib on mac, or libgdbc-postgresql.so on linux.
+
+So either put the file in the current directory, or tell it where to find it like this...
+
+```bash
+DYLD_LIBRARY_PATH="path/to/the/shared/library" go run main.go
+```
+
+### Benchmarks
+
+The one tiny benchmark so far has these GDBC drivers about 30% faster than the pure go drivers on mac, and about 30% slower than the pure go drivers on linux.
+ 
+### How is this done?
+
+GraalVM to package the java driver as a native library, then CGO to communicate with it.
+
+### Why is this done?
+
+Because there are some databases that don't have or have incomplete or unsupported go drivers. 
+
+Initially started in order to get a fully featured oracle driver.
+
+Also because it is fun.
+
+### TODO
+
+ - [ ] Find trusted maven repositories to download drivers
+ - [ ] Transaction isolation level config via driver
+ - [ ] Distribute binary drivers (.dylib and .so, and .dll?) via separate repositories
+ - [x] Cut down the binary size from 120mb to something slightly more reasonable. (done: now 30mb)
+   - [x] Get rid of -H:IncludeResources=".*"
+ - [ ] Extend test suite, find existing suite?
+ - [ ] Test memory usage/leaking
+ - [x] Linux builds
+ - [ ] Windows builds (waiting on graalvm support)
+ - [x] CI/CD
+ - [ ] Implement further interfaces 
+   - [x] sql/driver.Pinger
+   - [ ] sql/driver.RowsColumnTypeDatabaseTypeName
+   - [ ] sql/driver.RowsColumnTypeLength
+   - [ ] sql/driver.RowsColumnTypeNullable
+   - [ ] sql/driver.RowsColumnTypePrecisionScale
+   - [ ] sql/driver.NamedValueChecker
+ - [x] Allow driver specific extensions
+   - [ ] Oracle continuous query notification - https://docs.oracle.com/database/121/JJDBC/dbchgnf.htm#JJDBC28815
+
+#### Drivers
+ - [ ] sqlite? ("org.sqlite.JDBC" "jdbc:sqlite::memory:" "SELECT 1;")
+
+### Who Created This
 
-## How?
-Uses GraalVM to compile the driver as a native library, then CGO to communicate with it.
+<img src="https://identitii.com/wp-content/uploads/2018/12/logo_onwh.svg" width="25%">
 
-## Why?
-Because there are some databases that don't have go drivers.
+We're a fintech startup based in Sydney, Australia. 
 
-## Why really?
-Because it's fun.
+Find this project interesting? Why not come work with us.
 
-## When?
-This is a side project, so it may take a while.
+https://identitii.com/careers/
 
-## Who?
+### Thanks
 
-identitii. We're a fintech startup in Sydney. 
-If this kind of thing excites you, come work for us.
+https://github.com/japettyjohn/go-jdbc, which itself is partly based on https://github.com/xoba/goutil
 
-https://identitii.com/careers/
+gopher logo by Mario Furmanczyk (mfurmanc on fiverr)