https://github.com/pmlopes/vertx-bson-codec
BSON EventBus for Vert.x
https://github.com/pmlopes/vertx-bson-codec
Last synced: 9 months ago
JSON representation
BSON EventBus for Vert.x
- Host: GitHub
- URL: https://github.com/pmlopes/vertx-bson-codec
- Owner: pmlopes
- Created: 2012-11-29T11:33:15.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2020-09-06T12:03:52.000Z (almost 6 years ago)
- Last Synced: 2025-08-14T08:53:24.630Z (10 months ago)
- Language: Java
- Size: 10.5 MB
- Stars: 29
- Watchers: 7
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
vertx-bson-codec
===================
[](https://travis-ci.org/pmlopes/vertx-bson-codec)
BSON Codec for Vert.x 3
Why another codec?
----------------------
The standard EventBus from Vert.x allows Verticles to communicate with each other using JSON. JSON is a generic and fairly
simple encoding scheme, however it limits the data types to be:
* Number (normally a Double)
* String
* Boolean
* Array (Ordered List)
* Object (Map)
* null
Although for most cases these data types are enough, in some more complex cases a Verticle might need to exchange more
rich type data such as Dates, Integers, UUIDs, Regular Expressions, Binary data. This is where the BSON EventBus comes in.
Implementation details
----------------------
The module has no external dependencies, I've decided to implement the bson codec myself to optimize the usage of vert.x
buffers, and for that reason it is quite basic for the moment.
Type mapping implementation status
----------------------------------
| BSON | Java | Implemented | Comments |
|:-----|:-----|:-----------:|:---------|
| Floating Point | Double | ✔ | |
| UTF-8 String | String | ✔ | |
| Embedded Document | java.util.Map | ✔ | |
| Array | java.util.List | ✔ | |
| Binary::Generic | byte[] | ✔ | |
| Binary::Function | | | |
| _Binary::Binary (OLD)_ | byte[] | ✔ | _Deprecated/Only ReadOnly Support (when other sources write data to the Bus_ |
| _Binary::UUID (OLD)_ | | | _Deprecated_ |
| Binary::UUID | java.util.UUID | ✔ | |
| Binary::MD5 | com.jetdrone.bson.vertx.MD5 | ✔ | This is a interface that you need to implement getHash() : byte[] |
| Binary::User Defined | com.jetdrone.bson.vertx.Binary | ✔ | This is a interface that you need to implement getBytes() : byte[] |
| _Undefined_ | | | _Deprecated_ |
| ObjectId | com.jetdrone.bson.vertx.ObjectId | ✔ | |
| Boolean | Boolean | ✔ | |
| UTC Datetime | java.util.Date | ✔ | |
| Null | null | ✔ | |
| Regular Expression | java.util.regex.Pattern | ✔ | |
| _DBPointer_ | | | _Deprecated_ |
| JavaScript Code | | | |
| _Symbol_ | | | _Deprecated_ |
| JavaScript Code w/scope | | | |
| 32bit Integer | Integer | ✔ | |
| Timestamp | java.sql.Timestamp | ✔ | |
| 64bit Integer | Long | ✔ | |
| MinKey | com.jetdrone.bson.vertx.Key.MIN | ✔ | |
| MaxKey | com.jetdrone.bson.vertx.Key.MAX | ✔ | |
Quickstart
----------
Just register the Codec as any other codec:
```
EventBus eb = vertx.eventBus();
eb.registerDefaultCodec(BSONDocument.class, new BSONMessageCodec());
```