java-chartjs

Java-chartjs provides you with a way to configure and use ChartJs from Java and Java-based web frameworks such as Apache Wicket.

Usage example

In Java:

SimpleChartJsConfigBuilder<SimpleChartJsXYDataPoint<LocalDate, Integer>> config =
    SimpleChartJsConfigBuilder.lineChart();

SortedMap<LocalDate, Integer> dataPoints = createUserCountMap();

config.data()
    .addDataset()
    .withDataPoints(dataPoints.entrySet(), SimpleChartJsXYDataPoint::new)
    .withLabel("activeUsers")
    .withFill(ChartJsFill.boundary(ChartJsBoundaryType.START))
    .withBorderColor(ChartJsRGBAColor.BLUE);

LocalDate smallestXValue = dataPoints.firstKey();

SimpleChartJsOptionsBuilder optionsBuilder = config.options();
optionsBuilder.withResponsive(true);
optionsBuilder.hoverConfig().withIntersect(true).withMode(ChartJsInteractionMode.NEAREST);
optionsBuilder.tooltipConfig().withIntersect(false).withMode(ChartJsInteractionMode.INDEX);

SimpleChartJsLocalDateAxisConfigBuilder xAxisBuilder =
    optionsBuilder.scalesConfig().withLocalDateXAxisConfig();
xAxisBuilder.withDisplay(true).labelConfig().withDisplay(true).withLabelString("days");
xAxisBuilder.tickConfig().withForcedMinimum(smallestXValue);
xAxisBuilder.timeConfig().withTimeUnit(ChartJsTimeUnit.DAY).withStepSize(7);

SimpleChartJsLinearAxisConfigBuilder yAxisBuilder =
    optionsBuilder.scalesConfig().withLinearYAxisConfig();
yAxisBuilder.withDisplay(true)
    .labelConfig()
        .withDisplay(true)
        .withLabelString("active users");

String chartJsConfigAsJson = ChartJsObjectMapperFactory.getObjectMapper(true).writeValueAsString(config.build());

In HTML/Javascript

var ctx = document.getElementById('graphPanel').getContext('2d');
new Chart(ctx, chartJsConfigAsJson);

If you use Wicket, you can go straight from building the config to displaying it in the provided SimpleGraphPanel:

public GraphPage()
{
    add(new SimpleGraphPanel("graphPanel", getChartJsConfigModel(), Model.of("My graph")));
}

See the tests of the java-chartjs-wicket module for more examples.

Maven Central

Java-chartjs is available from Maven Central. Simply add the relevant artifacts to your dependencies.

<dependency>
    <groupId>nl.crashdata.java-chartjs</groupId>
    <artifactId>java-chartjs-data</artifactId>
    <version>2.2.0</version>
</dependency>

java-chartjs-data contains a set of POJOs annotated with Jackson annotations for easy serialization. It also contains a set of builders to help in creating a full ChartJsConfig.

java-chartjs-serialization contains helper code for easy serialization of config based on java-chartjs-data classes to a JSON config object for chartjs.

java-chartjs-wicket contains a simple wicket SimpleGraphPanel, as well as up-to-date ChartJs and moment.js libraries and assorted ResourceReferences.

ChartJs versions