3   数据源处理

JFreeChart 中的数据源是DataSet接口类型。该接口有三个主要的子类接口：CategoryDataset、PieDataset、SeriesDataset

CategoryDataset 接口的实现类基本上都维护了一个三元组<value,row,col>的列表结构。不同的实现类中value 的类型不相同。<row,col>唯一确定一个三元组。CategoryDataset的实现类提供对这个三元组的增删改查操作。

PieDataset 接口有两个主要的实现类：CategoryToPieDataset 、DefaultPieDataset。PieDataset接口的实现类基本上都维护了一个二元组<key,value>的列表结构。Key唯一确定一个二元组。CategoryDataset的实现类提供对这个二元组的增删改查操作。CategoryToPieDataset中的二元结构列表通过对CategoryDataset类型的对象指定行或者列转化过来。DefaultPieDataset直接维护一个二元结构列表。

SeriesDataset 接口的实现类基本上都维护了一种特定数据结构的列表。以TimeSeriesCollection为例。它维护一个TimeSeries对象列表，提供对该列表的增删查操作。每个TimeSeries对象维护一个<time,value>列表，提供对该列表的增删改查操作。
三 JFreeChart 中对常见图形的处理

        JFreeChart 并不存在多个不同的类来生成不同的图形。所有的图形都是具体类 JFreeChart 的实例化对象，初始化 JFreeChart 对象的时候通过指定不同的 Plot 实现类就可以显示出不同的图形。不同的 Plot 实现类具有不同的 Renderer 对象、 Axis 对象、 Dataset 对象。

        JFreeChart 提供工厂类 ChartFactory 方便使用者生成各种不同的图形。 ChartFactory 类的各个工厂方法中实现对具体 Plot 的指定以及对类 JFreeChart 构造函数的调用。

        下面以常用图形说一下常用的使用流程（大部分的操作讲的并不全面，比如 JFreeChart 可能提供了很多增加、修改数据的方式，下文中可能只列举一种）。
1 柱状图

（ 1 ）平面柱状图

        生成柱状图操作：

        JFreeChart chart = ChartFactory.createBarChart(

                       String title,                  // 图标题

                 String categoryAxisLabel,      //x 轴标题

                 String valueAxisLabel,        //y 轴标题

                 CategoryDataset dataset,       // 数据源

                 PlotOrientation orientation,     // 显示方向

                  boolean legend,              // 是否显示图例

                  boolean tooltips,             // 是否显示 tooltip

                  boolean urls) ；               // 是否指定 url

平面柱状图的 Plot 对象是 CategoryPlot 类型。 CategoryPlot 对象的 x 轴是 CategoryAxis 对象， y 轴是 NumberAxis 对象，绘制单元是 BarRenderer 对象，数据源是 CategoryDataset 对象。



获取 CategoryPlot 对象操作为：

CategoryPlot plot = ( CategoryPlot ) chart.getPlot(); 或者

CategoryPlot plot = chart.getCategoryPlot();

获取绘制单元操作：

        BarRenderer renderer = (BarRenderer) plot.getRenderer();

获取 x 轴的操作：

CategoryAxis xAxis = ( CategoryAxis ) plot.getDomainAxis();

获取 y 轴操作：

NumberAxis yAxis = (NumberAxis) plot.getRangeAxis();

获取数据源：

CategoryDataset dataset=plot.getDataset();



        柱状图可以接受一切 CategoryDataset 类型的数据源，下面讲解一下常用的 CategoryDataset 类型 DefaultCategoryDataset 的使用方式

实例化：

DefaultCategoryDataset dataset = new DefaultCategoryDataset();

增加数据

dataset .addValue(double value, Comparable rowKey, Comparable columnKey) ;

删除数据：

        dataset .removeValue(Comparable rowKey, Comparable columnKey);

        或者

        dataset. removeColumn(int columnIndex);

        或者

        dataset. removeColumn(Comparable columnKey);

        对行同样有上述两种删除方式，不在列举。

修改数据：

        dataset. setValue(double value, Comparable rowKey, Comparable columnKey);

查询数据 :

对 plot 对象、绘制单元、 x 轴、 y 轴的显示特性修改不再一一介绍。

（ 2 ） 3D 柱状图

        对应的工厂方法为 createBarChart3D ，该方法的参数与平面柱状图相同。 3D 柱状图的 Plot 对象是 CategoryPlot 类型。 CategoryPlot 对象的 x 轴是 CategoryAxis3D 对象， y 轴是 NumberAxis3D 对象，绘制单元是 BarRenderer3D 对象，数据源是 CategoryDataset 对象。

        具体使用以及操作与平面柱状图雷同，不在详述。
2 饼状图

(1) 平面饼状图

生成平面饼状图：

JFreeChart chart = ChartFactory. createPieChart(String title, // 图标题

                           PieDataset dataset,        // 数据源

                           boolean legend,          // 是否显示图例

                           boolean tooltips,          // 是否显示tooltip

                           boolean urls) ；           // 是否指定url

平面饼状图的Plot对象是PiePlot类型。PiePlot对象没有x轴对象、y轴对象、绘制单元对象，数据源是PieDataset对象。



获取PiePlot对象操作为：

PiePlot plot = (PiePlot) chart.getPlot();

获取数据源：

PieDataset dataset= plot .getDataset();



饼状图可以接受一切 PieDataset 类型的数据源，下面讲解一下常用的 PieDataset 类型 DefaultPieDataset 的使用方式

实例化：

     DefaultPieDataset dataset = new DefaultPieDataset();

增加修改操作：

     dataset. setValue(Comparable key, double value);

删除操作：

     dataset. remove(Comparable key);

查询操作：

     dataset. getKey(int item);

或者

dataset. getValue(int item);



(1)3D 饼状图

        对应的工厂方法为 createPieChart3D ，参数与平面饼状图相同。与平面饼状图的差别在于 Plot 对象是PiePlot3D类型 ，不再详述。
3 多重饼状图

（ 1 ）多重平面饼状图

生成多重平面饼状图：

        JFreeChart chart = ChartFactory. createMultiplePieChart

(String title,                // 图标题

                         CategoryDataset dataset,      // 数据源

                         TableOrder order,        // 指定提取数据的方式（按行或者按列）

                         boolean legend,             // 是否显示图例

                         boolean tooltips,             // 是否显示 tooltip

                         boolean urls)    ；             // 是否指定 url

多重平面饼状图的 Plot 对象是 MultiplePiePlot 类型。 MultiplePiePlot 对象没有 x 轴对象、 y 轴对象、绘制单元对象，数据源是 CategoryDataset 对象。 MultiplePiePlot 对象中可以含有多个子 JFreeChart 对象，子 JFreeChart 对象是上面讲过的饼状图对象。



获取 MultiplePiePlot 对象操作为：

MultiplePiePlot plotMain = (MultiplePiePlot) chart.getPlot();

获取子 JFreeChart 的操作为：

        JFreeChart childChart=plotMain.getPieChart();

获取数据源：

CategoryDataset dataset= plotMain .getDataset();

（ 2 ）多重 3D 饼状图

        对应的工厂方法为 createMultiplePieChart3D ，该方法的参数与 多重平面饼状图 相同。 多重 3D 饼状图的 Plot 对象是 MultiplePiePlot 类型。 MultiplePiePlot 对象中可以含有多个子 JFreeChart 对象，子 JFreeChart 对象是上面讲过的 3D 饼状图对象。
4 线图

（ 1 ）平面线图

        生成平面线图：

        JFreeChart chart = ChartFactory. createLineChart(String title,   // 图标题

                          String categoryAxisLabel,          //x 轴标题

                          String valueAxisLabel,             //y 轴标题

                          CategoryDataset dataset,            // 数据源

                          PlotOrientation orientation,          // 显示方向

                          boolean legend,                  // 是否显示图例

                          boolean tooltips,                  // 是否显示 tooltip

                          boolean urls);                   // 是否指定 url

平面线图除了的 Plot 对象中绘制单元对象是 LineAndShapeRenderer 对象，其他一切组成对象与平面柱状图相同。

获取 Renderer 操作：

LineAndShapeRenderer renderer=(LineAndShapeRenderer) plot.getRenderer();

其他参考平面柱状图。

（ 2 ） 3D 线图

对应工厂方法为 createLineChart3D ，参数与 createLineChart 相同。 3D 线图的组成对象除了绘制单元对象是 LineAndShapeRenderer3D 对象，其他一切组成对象与 3D 柱状图相同。
5 时序图

生成时序图：

        JFreeChart chart = ChartFactory.createTimeSeriesChart(

               String title,     // 图标题

                  String timeAxisLabel,    //x 轴标题

                  String valueAxisLabel,   //y 轴标题

                  XYDataset dataset,        // 数据源

                  boolean legend,           // 是否显示图例

                  boolean tooltips,         // 是否显示 tooltip

                  boolean urls);            // 是否指定 url

时序图的 Plot 对象是 XYPlot 类型。 XYPlot 对象的 x 轴是 DateAxis 对象， y 轴是 NumberAxis 对象，绘制单元是 XYLineAndShapeRenderer 对象，数据源是 XYDataset 对象。

Plot 对象的获取操作：

        XYPlot plot = (XYPlot) chart.getPlot();

X 轴对象的获取操作：

        DateAxis xAxis = (DateAxis) plot.getDomainAxis();

Y 轴对象的获取操作：

        NumberAxis yAxis =(NumberAxis) plot.getRangeAxis();

Renderer 对象的获取操作：

        XYItemRenderer renderer= plot.getRenderer();



时序图可以接受一切 XYDataset 类型的数据源，下面讲解一下常用的 XYDataset 类型 TimeSeriesCollection 的使用方式。

实例化：

        TimeSeriesCollection dataset=new TimeSeriesCollection();

添加数据操作：

        dataset. addSeries(TimeSeries); // 后面讲解 TimeSeries 对象

删除数据操作：

        dataset. removeSeries(int index);

查询数据操作 :

        dataset. getSeries(int series);



TimeSeries 对象操作

实例化：

        TimeSeries ts=TimeSeries(String name, Class timePeriodClass);

增加数据操作：

        ts. add(RegularTimePeriod period, double value);

删除数据操作：

        ts. delete(RegularTimePeriod period);   

修改数据操作：

        ts. update(RegularTimePeriod period, Number value);

查询数据操作：

        ts. getValue(RegularTimePeriod period);

类 RegularTimePeriod 是 JFreeChart 提供的时间模板类，它有很多具体的时间类，比如： Minute 、 Second 、 Hour 、 Day…… 等，不再详述。