Jackson Module

Project Dependencies

Add the following dependency to your pom.xml/build.gradle file:

Gradle

implementation("com.raynigon.unit-api:jackson-module:1.1.7")

Maven

<dependency>
    <groupId>com.raynigon.unit-api</groupId>
    <artifactId>jackson-module</artifactId>
    <version>1.1.7</version>
</dependency>

Configuration

Options

Feature	Default	Description
SYSTEM_UNIT_ON_MISSING_ANNOTATION	disabled	If no Annotation is present and the given input is a number, the system unit for this quantity should be used.

Usage

Java

class JacksonConfiguration {

    public ObjectMapper createObjectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        mapper.registerModule(
                UnitApiModule.withFeatures(UnitApiFeature.SYSTEM_UNIT_ON_MISSING_ANNOTATION)
        );
        return mapper;
    }
}

Kotlin

class JacksonConfiguration {

    fun createObjectMapper(): ObjectMapper {
        val mapper = ObjectMapper()
        mapper.registerModule(
                UnitApiModule.withFeatures(UnitApiFeature.SYSTEM_UNIT_ON_MISSING_ANNOTATION)
        )
        return mapper
    }
}

Examples

You can declare your model like this:

public class BasicEntity {

    public String id;

    @JsonUnit(KilometrePerHour.class)
    public Quantity<Speed> speed;
}

Jackson will now accept any quantity and convert it to the given unit. The following examples will be accepted by Jackson:

Number

{
    "id": "65bf1872-d197-4d72-9950-2b7b4d74a674",
    "speed": 80
}

String

{
    "id": "65bf1872-d197-4d72-9950-2b7b4d74a674",
    "speed": "80"
}

Object

{
    "id": "65bf1872-d197-4d72-9950-2b7b4d74a674",
    "speed": {
        "value:" 80,
        "unit": "km/h"
    }
}

String in km/h

{
    "id": "65bf1872-d197-4d72-9950-2b7b4d74a674",
    "speed": "80 km/h"
}

String in m/s

{
    "id": "65bf1872-d197-4d72-9950-2b7b4d74a674",
    "speed": "22.2222 m/s"
}

Every example will result in having the speed property with a value of 80 and the unit "km/h".

If you don't want to annotate the Attributes in your class, you can enable the SYSTEM_UNIT_ON_MISSING_ANNOTATION Feature. With this Feature enabled, the Mapper will accept a number and convert it to the given System Unit. (e.g. for speed m/s in the SI-System)