6.2 创建一个直方条形图

6.2.1 概述

直方条形图常常被用来显示表列数据。如下表，为一个简单的两行、三列数据。

表 6.1

在JFreeChart里，这个表格数据封装为一个dataset数据对象，每列标题为一个种类，每行为一个系列。每行标题为一个系列名称（或者系列关键值）。直方条形图展现的数据图如图6.2.

图6.2 简单的直方条形图（参见：BarExample1.java）

在这个图表的实例中，我们可以看到JFreeChart将每列数据（即一个种类）组合在一起。而且对每行数据（即每个系列）使用各种颜色高亮显示。图表的图例将颜色和系列的名称/关键值对应起来。

6.2.2 创一个dataset

创建直方条形图的第一步就是创建一个合适的dataset数据集。JFreeChart为直方条形图提供的访问表列数据的一系列方法，必须符合接口CategoryDataset定义。

JFreeChart中提供了一个便利的实现CategoryDataset接口的类为DefaultCategoryDataset。下面显示我们如何使用这个类来封装表6.1数据。代码如下：

private CategoryDataset createDataset() {
    DefaultCategoryDataset dataset = new DefaultCategoryDataset();
    dataset.addValue(1.0, "Row 1", "Column 1");
    dataset.addValue(5.0, "Row 1", "Column 2");
    dataset.addValue(3.0, "Row 1", "Column 3");
    dataset.addValue(2.0, "Row 2", "Column 1");
    dataset.addValue(3.0, "Row 2", "Column 2");
    dataset.addValue(2.0, "Row 2", "Column 3");
    return dataset;
}

6.2.3 创建一个chart图表

接下来就是要创建一个JFreeChart的实例，使用上面提供的dataset数据集画一个直方条形图。简单的，我们使用ChartFactory类来创建这个JFreeChart实例。代码如下：

private JFreeChart createChart(CategoryDataset dataset) {
    JFreeChart chart = ChartFactory.createBarChart(
        "BarChartDemo", // chart title
        "Category", // domain axis label
        "Value", // range axis label
        dataset, // data
        PlotOrientation.VERTICAL, // orientation
        true, // include legend
        true, // tooltips?
        false // URLs?
    );
    return chart;
}

CreateBarChart()的大部分参数是比较容易理解的，但其中一部分还需要进一步说明。

• 图显示的方向可以是水平的，还是可以是垂直的。
• 图表的信息提示，是否要添加，有一个标志来控制——在上面的例子中，我们将这个标识设置为true，因此当我们在一个swing应用窗口显示这个图表时，我们会看到这个信息提示。
• URLs标志，设置为false。

我们完成这个直方条形图后，我们将会过头来，仔细看看ChartFactory类在后台做了写什么。

6.2.4 显示该chart图表

为了完成我们的第一个直方条形图实例，我们将JFreeChart实例传给一个ChartPanel对象，然后在一个Swing应用窗口上显示该实例。全部的代码如下：

import java.awt.Dimension;
import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartPanel;
import org.jfree.chart.JFreeChart;
import org.jfree.chart.plot.PlotOrientation;
import org.jfree.data.category.DefaultCategoryDataset;
import org.jfree.ui.ApplicationFrame;
import org.jfree.ui.RefineryUtilities;
/**
* A simple demonstration application showing how to create a bar chart.
*/
public class BarExample1 extends ApplicationFrame {
    /**
    * Creates a new demo instance.
    *
    * @param title
    * the frame title.
    */
    public BarExample1(String title) {
        super(title);
        DefaultCategoryDataset dataset = new DefaultCategoryDataset();
        dataset.addValue(1.0, "Row 1", "Column 1");
        dataset.addValue(5.0, "Row 1", "Column 2");
        dataset.addValue(3.0, "Row 1", "Column 3");
        dataset.addValue(2.0, "Row 2", "Column 1");
        dataset.addValue(3.0, "Row 2", "Column 2");
        dataset.addValue(2.0, "Row 2", "Column 3");
        JFreeChart chart = ChartFactory.createBarChart(
            "Bar Chart Demo", // chart
            // title
            "Category", // domain axis label
            "Value", // range axis label
            dataset, // data
            PlotOrientation.VERTICAL, // orientation
            true, // include legend
            true, // tooltips?
            false // URLs?
        );
        ChartPanel chartPanel = new ChartPanel(chart, false);
        chartPanel.setPreferredSize(new Dimension(500, 270));
        setContentPane(chartPanel);
    }
    /**
    * Starting point for the demonstration application.
    *
    * @param args
    * ignored.
    */
    public static void main(String[] args) {
        BarExample1 demo = new BarExample1("Bar Demo 1");
        demo.pack();
        RefineryUtilities.centerFrameOnScreen(demo);
        demo.setVisible(true);
    }
}

完成这些代码后，运行代码，将会显示如6.2图的界面。