msgpack-jakarata-json

Ecode/Decode MessagePack as jakarta-json instances

Add dependency

Maven

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
    <dependencies>
        <dependency>
			<groupId>jakarta.json</groupId>
			<artifactId>jakarta.json-api</artifactId>
			<version>2.1.3</version>
		</dependency>
        <!-- You need a jakarta.json-api implementation -->
		<dependency>
			<groupId>org.eclipse.parsson</groupId>
			<artifactId>parsson</artifactId>
			<version>1.1.7</version>
		</dependency>

        <dependency>
			<groupId>at.bestsolution</groupId>
			<artifactId>msgpack-jakarta-json</artifactId>
			<version>1.0.1</version>
		</dependency>
    </dependencies>
</project>

Usage

Basic useage

import java.io.IOException;
import java.io.OutputStream;
import java.io.InputStream;

import org.msgpack.core.MessagePack;

import jakarta.json.JsonValue;
import at.bestsolution.msgpack.json.MsgpackJson

...

public class Sample {
    ...
    public static void serialize(OutputStream stream, JsonValue value) throws IOException {
        var packer = MessagePack.newDefaultBufferPacker(stream);
        var msgpackJson = MsgpackJson.builder().build();
        msgpackJson.encode(packer, value);
        // Only flush, close() would close the underlying stream
        packer.flush(); 
    }

    public static JsonValue deserialize(InputStream stream) throws IOException {
        var unpacker = MessagePack.newDefaultUnpacker(stream);
        var msgpackJson = MsgpackJson.builder().build();
        return msgpackJson.decode(unpacker);
    }
}

Cached Strings

If you encode eg Enum-like strings it might make sense to reuse JsonString instances when deserializing them. Let's say your enum is made of 'DEFAULT', 'SUCCESS', 'ERROR' you can configure the MsgpackJson-instance like this.

var msgpackJson = MsgpackJson.builder()
    .cachedStrings(Set.of("DEFAULT", "SUCCESS", "ERROR"))
    .build();

Cached Numbers

All numbers between -128 and 127 are cached, like Integer.valueOf() does it.