jcharts jCharts Sample Shows how third-party charting APIs could be used for rendering charts as images. How to render images using the jCharts library. 0.6.0 Sanda Zaharia shertage@users.sourceforge.net The JCharts Sample

This sample illustrates an interesting example of report scriptlets working in collaboration with third-party APIs, in order to output a chart image generated with the jCharts library.
First let's see the JChartsReport.jrxml template in the samples/jcharts/reports directory. It provides a scriptletClass="JChartsScriptlet" attribute, and a parametrized image element: 

  
  
  
]]>
The java.awt.Image object is stored in the ChartImage report variable: 
]]>
To see how the ChartImage variable was "calculated", let's dig a little into the JChartsScriptlet.java file in the src directory:
Here an area chart is created after the report initialization, using APIs in the jCharts library. The chart is rendered as java.awt.Image and stored in the ChartImage variable. From now on, the chart image is ready to be used by the report filler when needed.
And that's all the story here. With only a report scriptlet and a third-party library, one could embed interesting, complex, spectacular objects in a given report.

Running the Sample

Running the sample requires the Apache Ant library. Make sure that ant is already installed on your system (version 1.5 or later).
In a command prompt/terminal window set the current folder to demo/samples/jcharts within the JasperReports source project and run the > ant test view command.
It will generate all supported document types containing the sample report in the demo/samples/jcharts/build/reports directory.
Then the report will open in the JasperReports internal viewer.