83 lines
3.4 KiB
Markdown
83 lines
3.4 KiB
Markdown
msgpack
|
|
=======
|
|
[](https://maven-badges.herokuapp.com/maven-central/ch.dissem.msgpack/msgpack)
|
|
[](http://www.javadoc.io/doc/ch.dissem.msgpack/msgpack)
|
|
[](https://raw.githubusercontent.com/Dissem/Jabit/master/LICENSE)
|
|
|
|
This is a simple Java library for handling MessagePack data. It doesn't do any object mapping, but maps to special
|
|
objects representing MessagePack types. To build, use command `./gradlew build`.
|
|
|
|
For most cases you might be better off using `org.msgpack:msgpack`, but I found that I needed something that generically
|
|
represents the internal structure of the data.
|
|
|
|
msgpack uses Semantic Versioning, meaning as long as the major version doesn't change, nothing should break if you
|
|
update. Be aware though that this doesn't necessarily applies for SNAPSHOT builds and the development branch.
|
|
|
|
|
|
#### Master
|
|
[](https://travis-ci.org/Dissem/MsgPack)
|
|
[](https://www.codacy.com/app/chrigu-meyer/MsgPack/dashboard?bid=TODO)
|
|
[](https://codecov.io/github/Dissem/Jabit?branch=master)
|
|
|
|
#### Develop
|
|
[](https://travis-ci.org/Dissem/MsgPack?branch=develop)
|
|
[](https://www.codacy.com/app/chrigu-meyer/MsgPack/dashboard?bid=4118049)
|
|
[](https://codecov.io/github/Dissem/MsgPack?branch=develop)
|
|
|
|
Limitations
|
|
--------------
|
|
|
|
* There is no fallback to BigInteger for large integer type numbers, so there might be an integer overflow when reading
|
|
too large numbers
|
|
* `MPFloat` uses the data type you're using to decide on precision (float 32 or 64) - not the actual value. E.g. 0.5
|
|
could be saved perfectly as a float 42, but if you provide a double value, it will be stored as float 64, wasting
|
|
4 bytes.
|
|
|
|
Setup
|
|
-----
|
|
|
|
Add msgpack as Gradle dependency:
|
|
```Gradle
|
|
compile "ch.dissem.msgpack:msgpack:1.0.0"
|
|
```
|
|
|
|
Usage
|
|
-----
|
|
|
|
### Serialize Data
|
|
|
|
First, you'll need to create some msgpack objects to serialize:
|
|
```Java
|
|
MPMap<MPString, MPType<?>> object = new MPMap<>();
|
|
object.put(new MPString("compact"), new MPBoolean(true));
|
|
object.put(new MPString("schema"), new MPInteger(0));
|
|
```
|
|
or the shorthand version for simple types:
|
|
```Java
|
|
import static ch.dissem.msgpack.types.Utils.mp;
|
|
|
|
MPMap<MPString, MPType<?>> object = new MPMap<>();
|
|
object.put(mp("compact"), mp(true));
|
|
object.put(mp("schema"), mp(0));
|
|
```
|
|
then just use `pack(OutputStream)`:
|
|
```Java
|
|
OutputStream out = ...;
|
|
object.pack(out);
|
|
```
|
|
|
|
|
|
### Deserialize Data
|
|
|
|
For deserializing data there is the reader object:
|
|
```Java
|
|
Reader reader = Reader.getInstance()
|
|
```
|
|
just use `reader.read(InputStream)`. Unfortunately you'll need to make sure you got what you expected, the following
|
|
example might result in `ClassCastException` at weird places:
|
|
```Java
|
|
InputStream in = ...;
|
|
MPType read = reader.read(in);
|
|
MPMap<MPString, MPString> map = (MPMap<MPString, MPString>) read;
|
|
String value = map.get(mp("key")).getValue();
|
|
``` |