https://github.com/thheller/shadow-pgsql
PostgreSQL Client for the JVM
https://github.com/thheller/shadow-pgsql
Last synced: about 1 year ago
JSON representation
PostgreSQL Client for the JVM
- Host: GitHub
- URL: https://github.com/thheller/shadow-pgsql
- Owner: thheller
- License: epl-1.0
- Created: 2014-08-12T19:50:00.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2018-08-02T13:14:54.000Z (almost 8 years ago)
- Last Synced: 2025-02-28T06:30:46.034Z (over 1 year ago)
- Language: Java
- Homepage: https://github.com/thheller/shadow-pgsql
- Size: 227 KB
- Stars: 15
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# shadow-pgsql
WARNING: Stay away from this. Stick with JDBC, this was not worth the effort!
```
[thheller/shadow-pgsql "0.13.0"]
```
I need to write some docs ...
## A PostgreSQL Client for the JVM.
The standard interface in Java to talk to Postgres is the official JDBC-Driver. JDBC tries to
create a common Interface for Databases but not all SQL Databases are created equal. That
makes using Postgres-specific features rather cumbersome to use.
This library tries to provide a far simpler yet more powerful interface to the PostgreSQL Server.
### Requirements
JDK 8+, PostgreSQL 9+ (only tested against 9.1.2, 9.3.5, might work with older versions)
### Features
- Fully customizable Types via simple [Interface](https://github.com/thheller/shadow-pgsql/blob/master/src/java/shadow/pgsql/TypeHandler.java)
- Binary Format when supported by Type
### Status
- [Basic Types](https://github.com/thheller/shadow-pgsql/tree/master/src/java/shadow/pgsql/types) have been implemented.
- Query & Statement support
- Transactions with Savepoints
### TODO:
- more Types
- UTF-8 is hardcoded right now, things will go wrong if backend is not UTF-8
- Tests
- better Errors (Messages)
- Docs
- Auth Support (MD5, ...)
- Generics (didn't write any serious Java for over 10 years, need to learn Generics first)
- Cursor Support
- FunctionCall API
- Copy API
## Usage
Needs more docs, for now check what can hardly be called Tests.
- [Java](https://github.com/thheller/shadow-pgsql/blob/master/test/shadow/pgsql/BasicTest.java)
- [Clojure](https://github.com/thheller/shadow-pgsql/blob/master/test/shadow/pgsql_test.clj)
## License
Copyright © 2014 Thomas Heller
Distributed under the Eclipse Public License either version 1.0 or (at
your option) any later version.