Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/retrodaredevil/couchdb-java
A CouchDB Java library that is (mostly) uncoupled from any particular JSON library
https://github.com/retrodaredevil/couchdb-java
cloudant couchdb java java-8 java-library
Last synced: 23 days ago
JSON representation
A CouchDB Java library that is (mostly) uncoupled from any particular JSON library
- Host: GitHub
- URL: https://github.com/retrodaredevil/couchdb-java
- Owner: retrodaredevil
- License: mit
- Created: 2021-07-12T00:25:19.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-10T22:26:32.000Z (23 days ago)
- Last Synced: 2024-12-10T23:25:03.449Z (23 days ago)
- Topics: cloudant, couchdb, java, java-8, java-library
- Language: Java
- Homepage:
- Size: 300 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
### CouchDB Java
A CouchDB Java library that is (mostly) uncoupled from any particular JSON library.
There are many outdated CouchDB libraries, and some more up to date CouchDB libraries for Java. Some of these
libraries are tightly coupled to JSON libraries such as GSON or Jackson. This library uses Jackson internally,
but you can interact with this library using strings representing JSON values. The only library this library is tightly
coupled to is [Okio](https://github.com/square/okio), which is used in place of InputStreams in some places
This library encourages the use of immutable objects as much as possible and doesn't force you to put `_id` and `_rev`
on your objects like many other libraries do.
This library works great with Kotlin. Much of the code is annotated with annotations to denote nullability.
### Features
* Decoupled from JSON library
* Encourages use of immutable objects
* _id and _rev parameters are not required on your POJOs
* Password auth, cookie auth, and no auth support
* Uses OkHttp, but has possibility for many implementations using different HTTP libraries
* Checked exceptions (all inherit from CouchDbException)
* Integration tested! (This should mean fewer bugs in this library)
### Couchbase, Cloudant, PouchDB support
The primary goal of this project is to support CouchDB.
Many features of this library likely work fine with these others databases,
but it is not guaranteed to work.
### Using library:
```groovy
allprojects {
repositories {
maven { url 'https://www.jitpack.io' }
}
}
dependencies {
implementation "com.github.retrodaredevil:couchdb-java:$couchdbJavaVersion"
}
```
### Running Tests:
Running test and building:
```shell
./gradlew build
```
Running integration tests:
```shell
docker compose --file testing/docker-compose.yml pull
./gradlew integration
```
### Other CouchDB libraries for Java
* [Cloudant Java SDK](https://github.com/IBM/cloudant-java-sdk)
* Up to date
* Designed to fully support Cloudant and CouchDB
* Uses GSON internally, but GSON doesn't seem to be exposed to the public API.
* Tightly coupled to custom Document class
* [LightCouch](https://github.com/lightcouch/LightCouch)
* Uses GSON and is tightly coupled to GSON
* Uses inheritance rather than composition to support alternative HTTP libraries on Android
* [Ektorp](https://github.com/helun/Ektorp)
* Uses Jackson and is tightly coupled to Jackson
* Allows a single ObjectMapper to be configured for all serialization and deserialization
* Updating objects without `_id` and `_rev` on them is awkward
* [couchdb4j](https://github.com/mbreese/couchdb4j)