https://github.com/imrafaelmerino/mongo-values
This library provides codecs for seamless integration between json-values and BSON, abstracting conversions between BSON types and their `JsValue` equivalents (e.g., `BsonType.STRING` → `JsStr`). It includes a `BsonReader` and `BsonWriter` to handle encoding/decoding effortlessly.
https://github.com/imrafaelmerino/mongo-values
bson immutability java json json-values mongodb persistent-data-structure
Last synced: 5 months ago
JSON representation
This library provides codecs for seamless integration between json-values and BSON, abstracting conversions between BSON types and their `JsValue` equivalents (e.g., `BsonType.STRING` → `JsStr`). It includes a `BsonReader` and `BsonWriter` to handle encoding/decoding effortlessly.
- Host: GitHub
- URL: https://github.com/imrafaelmerino/mongo-values
- Owner: imrafaelmerino
- Created: 2024-08-28T08:58:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-23T21:52:35.000Z (about 1 year ago)
- Last Synced: 2025-05-19T10:16:59.470Z (7 months ago)
- Topics: bson, immutability, java, json, json-values, mongodb, persistent-data-structure
- Language: Java
- Homepage:
- Size: 13.5 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
Awesome Lists containing this project
README
[](https://www.buymeacoffee.com/imrafaelmerino)
[](https://search.maven.org/artifact/com.github.imrafaelmerino/mongo-values/2.0.0/jar)
- [Introduction](#intro)
- [Requirements](#requirements)
- [Installation](#inst)
It provides a set of codecs to work with [json-values](https://github.com/imrafaelmerino/json-values)
The codecs abstract the processes of going from BSON to JsValue and the other way around by providing
a BsonReader and a BsonWriter.
Please find below the supported BSON types and their json-value equivalents:
```java
Map> map = new HashMap<>();
map.put(BsonType.NULL, JsNull.class);
map.put(BsonType.ARRAY, JsArray.class);
map.put(BsonType.BINARY, JsBinary.class);
map.put(BsonType.BOOLEAN, JsBool.class);
map.put(BsonType.DATE_TIME, JsInstant.class);
map.put(BsonType.DOCUMENT, JsObj.class);
map.put(BsonType.DOUBLE, JsDouble.class);
map.put(BsonType.INT32, JsInt.class);
map.put(BsonType.INT64, JsLong.class);
map.put(BsonType.DECIMAL128, JsBigDec.class);
map.put(BsonType.STRING, JsStr.class);
```
A CodecRegistry contains a set of Codec instances that are accessed according to the Java classes
that they encode from and decode to
Just register the registry **JsValuesRegistry**, which contains the necessary codecs, and
when defining the collection, specify the generic type **JsObj**.
You can use the MongoDB API **without doing any kind of conversion between BSON and JsObj**:
``` java
import com.mongodb.ConnectionString;
import com.mongodb.MongoClientSettings;
import mongovalues.JsValuesRegistry;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import jsonvalues.JsObj
ConnectionString connString = ???;
MongoClientSettings settings =
MongoClientSettings.builder()
.applyConnectionString(connString)
.codecRegistry(JsValuesRegistry.INSTANCE)
.build();
MongoClient mongoClient = result = MongoClients.create(settings);
MongoCollection collection = mongoClient.getCollection("db","collection");
```
- For versions prior to 1.0.0, json-values requires Java 8 or later. Please note that only fixes are accepted for these
versions.
- For versions starting from 1.0.0 and beyond, json-values mandates Java 17 or later.
To include json-values in your project, add the corresponding dependency to your build tool based on your Java version:
For Java 8 or higher:
```xml
com.github.imrafaelmerino
mongo-values
0.9.6
```
For Java 17 or higher:
```xml
com.github.imrafaelmerino
mongo-values
1.0.3
```
For Java 21 or higher:
```xml
com.github.imrafaelmerino
mongo-values
2.0.0
```
Choose the appropriate version according to your Java runtime.