DSL Framework for JFreeChart

Introduction

The present project try to make the Chart generation easy through a Fluent Api [^fluentApi]. The core of the Api is based on JFreechart.

@Chart Annotation

The engine of the DSL for create Charts use the @Chart annotation for create the whole Chart. Basically, you have to decorate the class on your class with the Annotation and add properties that will map on graph properties.

Let's to build a graph of "amount vs age " with the next information:

The steps for create a graph are shown next:

Steps:

1. Create a JavaBean Class. and add an @Graph Annotation on top Of the class.
2. Configure the The DSL for create the Graph

Create a JavaBean Class

The Pojo created is shown next:

@Chart(chartType = ChartType.PIE_CHART, xProperty = "edad", yProperty = "cantidad")
public class Persona {

    private String persona;

    private double cantidad;

    private int edad;

    private Date fecha;

   //Getters and Setters methods
     .
     .

Configure the The DSL for create the Graph.

Here I show a snipped of code for create a graph Based on the DSL and @Graph annotation:

import static com.danimaniarqsoft.report.poi.dsl.WorkbookBuilder.createWorkbook;
    private List<Persona> personasDataset;
     //Fill personasDataset from some datasource
    JFreeChart chart = createChart().ofTypeXYPlotChart()
                        .withXAxisLabel("X-edad").
                        withYAxisLabel("Y-cantidad")
                        .withChartTitle("Reflection")
                        .addDataSet(personasDataset, Persona.class).
                        createChart();

    ChartUtilities.saveChartAsJPEG(new File("ReflectionChart.jpg"),

@Graph Annotation

The @Graph annotation has a lot of properties for control the way how the DSL have to build the graph. The next table describe each property:

Aligments

[^fluentApi]:Fluent Interface, Martin Fowler on December twenty of 2005 write about a certain style of interface which he decided to name fluent interface. We write DSL's based on the concept of Fluent Interface

© danimaniArqsoft