E512 java-chartjs/README.md at java-chartjs-0.92 · opsdemon/java-chartjs · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
82 lines (61 loc) · 3.17 KB

File metadata and controls

82 lines (61 loc) · 3.17 KB

java-chartjs

Maven metadata URI license

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<LocalDate, Integer> config =
	SimpleChartJsConfigBuilder.lineChart();

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

config.data()
	.addDataset()
	.withDataPoints(dataPoints)
	.withLabel("activeUsers")
	.withBorderColor(ChartJsRGBAColor.BLUE);

LocalDate smallestXValue = dataPoints.firstKey();

SimpleChartJsOptionsBuilder<LocalDate, Integer> 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);

SimpleChartJsLinearAxisConfigBuilder yAxisBuilder =
	optionsBuilder.scalesConfig().withLinearYAxisConfig();
yAxisBuilder.withDisplay(true).labelConfig().withDisplay(true).withLabelString(
	"active users");
	
String chartJsConfigAsJson = ChartJsObjectMapperFactory.createObjectMapper(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")));
}

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>0.90</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

java-chartjs Chart.js moment.js
0.70 2.7.2 2.21.0
0.80 2.7.2 2.21.0
0.90 2.7.2 2.22.2
0