JFreeChart使用心得与例子

一、JFreeChart的介绍与获取
JFreeChart开发包是一个开源的Java图形开发包,它从柱形图，饼形图，到雷达图，蜡烛图等等无所不包,可以在c/s,b/s,甚至是实时环境都能一显身手。
当前的JFreeChart的最新版本为jfreechart-1.0.0-rc1.zip。可以到http://www.jfree.org/jfreechart/index.html下载。如果是进行web开发，把解压缩文件中的lib目录下jcommon-1.0.0-rc1.jar和jfreechart-1.0.0-rc1.jar放置到web应用程序的WEB-INF/lib目录下；如果是Java开发，则加入到classpath环境变量中。

二、JFreeChart的基本使用
不论创建的是什么图，JFreeChart都遵循以下的这个使用步骤：
1、建立Dataset。所有的数据都存放在Dataset中的。(创建一个数据源（dataset）来包含将要在图形中显示的数据)
2、建立JFreeChart。将dataset中的数据导入到JFreeChart中。(创建一个 JFreeChart 对象来代表要显示的图形 )
3、设置JFreeChart的显示属性。这一步可以省略，使用默认的JFreeChart显示属性。
3、渲染图表。即生成图片。
4、页面图片显示。
重要的类和接口：
org.jfree.data.general.Dataset 所有数据源类都要实现的接口
org.jfree.chart.ChartFactory 由它来产生 JFreeChart 对象
org.jfree.chart.JFreeChart 所有对图形的调整都是通过它噢！！
org.jfree.chart.plot.Plot 通过JFreeChart 对象获得它，然后再通过它对图形外部部分（例：坐标轴）调整
注意：它有很多子类，一般都下涉及到它的子类！
org.jfree.chart.renderer.AbstractRenderer 通过JFreeChart 对象获得它，然后再通过它对图形内部部分(例：折线的类型）调整。同样，针对不同类型的报表图，它有着不同的子类实现！在下面我们简称它为 Renderer

三、JFreeChart使用的具体例子

package com.hong.bean;

import java.awt.Color;
import java.awt.Font;
import java.io.IOException;
import java.io.PrintWriter;
import java.text.NumberFormat;
import java.text.SimpleDateFormat;
import javax.servlet.http.HttpSession;
import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartRenderingInfo;
import org.jfree.chart.ChartUtilities;
import org.jfree.chart.JFreeChart;
import org.jfree.chart.axis.DateAxis;
import org.jfree.chart.axis.NumberAxis;
import org.jfree.chart.entity.StandardEntityCollection;
import org.jfree.chart.labels.StandardXYToolTipGenerator;
import org.jfree.chart.plot.XYPlot;
import org.jfree.chart.renderer.xy.XYItemRenderer;
import org.jfree.chart.renderer.xy.XYLineAndShapeRenderer;
import org.jfree.chart.servlet.ServletUtilities;
import org.jfree.chart.title.TextTitle;
import org.jfree.data.time.Day;
import org.jfree.data.time.TimeSeries;
import org.jfree.data.time.TimeSeriesCollection;
import org.jfree.data.xy.XYDataset;
import org.jfree.ui.RectangleInsets;

/**
* @author caiwb 曲线图的绘制
*/
public class LineXYChart
{
    /**
     * 返回生成图片的文件名
     * @param session
     * @param pw
     * @return 生成图片的文件名
     */
    public String getLineXYChart(HttpSession session, PrintWriter pw)
    {
        XYDataset dataset = this.createDateSet();//建立数据集
        String fileName = null;
        //建立JFreeChart
        JFreeChart chart = ChartFactory.createTimeSeriesChart(
                "JFreeChart时间曲线序列图", // title
                "Date", // x-axis label
                "Price", // y-axis label
                dataset, // data
                true, // create legend?
                true, // generate tooltips?
                false // generate URLs?
                );
        //设置JFreeChart的显示属性,对图形外部部分进行调整
        chart.setBackgroundPaint(Color.red);//设置曲线图背景色
        //设置字体大小，形状
        Font font = new Font("宋体", Font.BOLD, 16);
        TextTitle title = new TextTitle("JFreeChart时间曲线序列图", font);
        chart.setTitle(title);

        XYPlot plot = (XYPlot) chart.getPlot();//获取图形的画布
        plot.setBackgroundPaint(Color.lightGray);//设置网格背景色
        plot.setDomainGridlinePaint(Color.green);//设置网格竖线(Domain轴)颜色
        plot.setRangeGridlinePaint(Color.white);//设置网格横线颜色
        plot.setAxisOffset(new RectangleInsets(5.0, 5.0, 5.0, 5.0));//设置曲线图与xy轴的距离
        plot.setDomainCrosshairVisible(true);
        plot.setRangeCrosshairVisible(true);
        XYItemRenderer r = plot.getRenderer();
        if (r instanceof XYLineAndShapeRenderer)
        {
            XYLineAndShapeRenderer renderer = (XYLineAndShapeRenderer) r;
            renderer.setDefaultShapesVisible(true);
            renderer.setDefaultShapesFilled(true);
            renderer.setShapesVisible(true);//设置曲线是否显示数据点
        }

        //设置Y轴
        NumberAxis numAxis = (NumberAxis) plot.getRangeAxis();
        NumberFormat numFormater = NumberFormat.getNumberInstance();
        numFormater.setMinimumFractionDigits(2);
        numAxis.setNumberFormatOverride(numFormater);

        //设置提示信息
        StandardXYToolTipGenerator tipGenerator = new StandardXYToolTipGenerator(
                "历史信息:({1} 16:00,{2})", new SimpleDateFormat("MM-dd"),
                numFormater);
        r.setToolTipGenerator(tipGenerator);

        //设置X轴（日期轴）
        DateAxis axis = (DateAxis) plot.getDomainAxis();
        axis.setDateFormatOverride(new SimpleDateFormat("MM-dd"));

        ChartRenderingInfo info = new ChartRenderingInfo(
                new StandardEntityCollection());
        try
        {
            fileName = ServletUtilities.saveChartAsPNG(chart, 500, 300, info,
                    session);//生成图片
//          Write the image map to the PrintWriter
            ChartUtilities.writeImageMap(pw, fileName, info, false);
        }
        catch (IOException e)
        {
            e.printStackTrace();
        }
        pw.flush();
        return fileName;//返回生成图片的文件名
    }

    /**
     * 建立生成图形所需的数据集
     * @return 返回数据集
     */
    private XYDataset createDateSet()
    {
        TimeSeriesCollection dataset = new TimeSeriesCollection();//时间曲线数据集合
        TimeSeries s1 = new TimeSeries("历史曲线", Day.class);//创建时间数据源，每一个//TimeSeries在图上是一条曲线

        //s1.add(new Day(day,month,year),value),添加数据点信息
        s1.add(new Day(1, 2, 2006), 123.51);
        s1.add(new Day(2, 2, 2006), 122.1);
        s1.add(new Day(3, 2, 2006), 120.86);
        s1.add(new Day(4, 2, 2006), 122.50);
        s1.add(new Day(5, 2, 2006), 123.12);
        s1.add(new Day(6, 2, 2006), 123.9);
        s1.add(new Day(7, 2, 2006), 124.47);
        s1.add(new Day(8, 2, 2006), 124.08);
        s1.add(new Day(9, 2, 2006), 123.55);
        s1.add(new Day(10, 2, 2006), 122.53);

        dataset.addSeries(s1);
        dataset.setDomainIsPointsInTime(true);
        return dataset;
    }
}

在jsp文件中显示图片
首先在Web应用程序部署文件web.xml中添加以下代码:

<!-- 图片显示，使用专用的servlet来进行显示，它会完成路径的搜索及映射 -->
<servlet>
     <servlet-name>DisplayChart</servlet-name>
     <servlet-class>org.jfree.chart.servlet.DisplayChart</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>DisplayChart</servlet-name>
<url-pattern>/servlet/DisplayChart</url-pattern>
</servlet-mapping>
然后在jsp中显示图片
完整的jsp文件：
<!--文件名称：timeLine.jsp-->
<%@ page contentType="text/html;charset=gb2312" pageEncoding="GB2312"%>
<%@ page import="com.caiwb.bean.LineXYChart"%>
<%@ page import = "java.io.PrintWriter" %>
<%
LineXYChart xyChart=new LineXYChart();
String fileName=xyChart.getLineXYChart(session,new PrintWriter(out));
  String graphURL = request.getContextPath() + "/servlet/DisplayChart?filename=" + fileName; 
%>
<html>
</head>
<title> JFreeChart使用例子</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<img src="<%= graphURL %>" width=500 height=300 border=0 usemap="#<%= fileName %>">
</body>
</html>