Implementation of JSON Stat in Java - http://json-stat.org

Status

Usage

Add json stat dependency into your project

<dependency>
            <groupId>no.ssb.jsonstat</groupId>
            <artifactId>json-stat-java</artifactId>
            <version>0.2.5</version>
</dependency>

Register the module

class Example {
    static {
        mapper = new ObjectMapper();
        mapper.registerModule(new JsonStatModule());
        mapper.registerModule(new JavaTimeModule());
    }
}

Create a new json stat data set

class Example {
    static {
        Dataset.Builder builder = Dataset.create().withLabel("My dataset");

        builder.withDimension(
            Dimension.create("year")
                .withRole(Dimension.Roles.TIME)
                .withIndexedLabels(ImmutableMap.of("2003", "2003", "2004", "2004", "2005", "2005")
            )
        );

        builder.withDimension(
            Dimension.create("month").withRole(Dimension.Roles.TIME)
                .withIndexedLabels(ImmutableMap.of("may", "may", "june", "june", "july", "july")
            )
        );

        builder.withDimension(
            Dimension.create("week").withTimeRole()
                .withIndexedLabels(ImmutableMap.of("30", "30", "31", "31", "32", "32")
            )
        );

        builder.withDimension(
            Dimension.create("population").withMetricRole()
                     .withIndexedLabels(ImmutableMap.of(
                                "A", "active population",
                                "E", "employment",
                                "U", "unemployment",
                                "I", "inactive population",
                                "T", "population 15 years old and over"))
        );

        builder.withDimension(
            Dimension.create("amount").withMetricRole()
                .withIndexedLabels(ImmutableMap.of("millions", "millions"))
        );

        builder.withDimension(
            Dimension.create("percent").withMetricRole()
                .withIndexedLabels(ImmutableMap.of("%", "percent"))
        );

        Dataset dataset = builder.withMapper(
                dimensions -> newArrayList(
                        dimensions.hashCode(),
                        dimensions.hashCode())
        );
    }
}

Deserialize a dataset

class Example {
    static {
        mapper = new ObjectMapper();
        
        mapper.registerModule(new GuavaModule());
        mapper.registerModule(new Jdk8Module());
        mapper.registerModule(new JavaTimeModule());
        
        mapper.registerModule(new JsonStatModule());

        Dataset.Builder builder = mapper.readValue("{ ... }", Dataset.Builder.class);
        // Or
        Dataset dataset = mapper.readValue("{ ... }", Dataset.class);
    }
}