JFreeChart参考API - JFreeChart教程
在本章中，我们将讨论一些在JFreeChart库重要的软件包，类和方法。这些软件包，类和方法是最常见的，同时建立了各种使用JFreeChart库图表。
ChartFactory 类
ChartFactory是org.jfree.chart包中抽象类。它提供了实用方法的集合，用于生成标准的图表。以下是几个重要方法的列表：
类构造方法
| S.N. | 描述 |
|---|---|
| 1 | ChartFactory() ChartFactory类的默认构造函数。 |
类方法
| S.N. | 方法 & 描述 |
|---|---|
| 1 | createPieChart(java.lang.String title, PieDataset dataset, boolean legend, boolean tooltips, boolean urls) 此方法使用默认设置创建一个饼图。它返回JFreeChart类型的对象。 |
| 2 | createPieChart3D(java.lang.String title, PieDataset dataset, boolean legend, boolean tooltips, boolean urls) 此方法使用指定的数据集三维/3D饼图。 |
| 3 | createBarChart(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) 参数java.lang.String categoryAxisLabel标签放置在X轴的值。该参数的java.lang.String valueAxisLabel标签放置在Y轴的数值。此方法创建一个条形图。 |
| 4 | createBarChart3D(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) 此方法创建一个柱形图具有3D效果。它返回JFreeChart类型的对象。 |
| 5 | createLineChart(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) 此方法使用默认设置创建一个折线图。 |
| 6 | createLineChart3D(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) 此方法创建一个折线图与3D效果。 |
| 7 | createXYLineChart(java.lang.String title, java.lang.String xAxisLabel, java.lang.String yAxisLabel, XYDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) 此方法使用默认设置创建基于XYDataset的折线图。 |
ChartFrame 类
ChartFrame类在org.jfree.chart包中，提供所有的帧相关的功能和工具。 ChartFrame类继承自父类，如Frame, Window, Container, Component 类功能。
类构造方法
| S.N. | 构造方法及描述 |
|---|---|
| 1 | ChartFrame (java.lang.Frame String, JfreeChart chart) 它构建一个框架/frame。 |
| 2 | Chart Frame (java.lang.Frame String, JfreeChart chart, boolean scrollpane) 它构建一个框架/frame。 |
类方法
| S.N. | 构造方法及描述 |
|---|---|
| 1 | getChartPanel() 此方法返回图表面板的框架/frame。 |
ChartPanel 类
org.jfree.chart包中的ChartPanel类用于swing GUI部件，用于显示JfreeChart对象。
类构造方法
| S.N. | 构造方法及描述 |
|---|---|
| 1 | ChartPanel(JFreeChart chart) 此构造一个面板/panel ，显示指定的图表。 |
| 2 | ChartPanel(JFreeChart chart, boolean useBuffer) 这个构造函数构造包含图表的面板/panel。 |
| 3 | ChartPanel(JFreeChart chart, boolean properties, boolean save, boolean print, boolean zoom, boolean tooltips) 此构造一个JFreeChart面板。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setPreferredSize(java.awt.Dimension) 该方法用于java.awt中设置的帧大小。 Dimension类对象作为参数。这个方法是从javax.swing.JComponent中实现。 |
ChartUtilities 类
org.jfree.chart包中的CharUtilites类提供JFreeCharts包括将图表转换成图像文件格式，如PNG，JPEG和创建HTML图像映射方法的实用方法的集合。
类构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | ChartUtilities() 这是类的一个默认构造函数 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | saveChartAsPNG(java.io.File file, JfreeChart chart, int width, int height) 此方法转换和保存图表为PNG格式指定的文件。 |
| 2 | saveChartAsJPEG(java.io.File file, JfreeChart chart, int width, int height) 此方法转换并保存一个图表，以JPEG格式指定的文件。 |
JFreeChart 类
JFreeChart 类是在org.jfree.chart包的核心类。这个类提供了JFreeChart的方法来创建柱状图，折线图，饼图和XY坐标图，包括时间序列数据。
类构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | JfreeChart(Plot plot) 此构造函数创建基于所提供的节点一个新的图表。 |
| 2 | JfreeChart(java.lang.String title, java.awt.Font titleFont, Plot plot, boolean createLegend) 该构造函数创建一个新的图表给定标题和绘图。 |
| 3 | JfreeChart(java.lang.String title, Plot plot) 该构造函数创建一个新的图表给定标题和绘图。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | getXYPlot() 此方法返回节点图表作为XYPlot。使用XYPolt我们可以XY图表做了一些实用操作。 |
PiePlot 类
这个类是org.jfree.chart.plot包的一部分，来自同一个包扩展Plot 类。这个类提供了一些方法来创建饼图块。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | PiePlot() 它创建了一个新的绘图。 |
| 2 | PiePlot(PieDataset dataset) 它创建了一个绘图，饼图由指定的数据集。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setStartAngle(double angle) 此方法设置起始角度和发送PlotChangeEvent向所有注册的侦听器 |
PiePlot3D 类
PiePlot3D类和PiePlot类在同一个包中的子类。因此，这两个类有相同的功能，PiePlot类只不过是用于创建3D图形。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | PiePlot3D() 此构造函数创建没有数据集的新实例。 |
| 2 | PiePlot3D(PieDataset dataset) 该构造函数创建一个饼图和使用指定的数据集三维效果。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setForegroundAlpha(float alpha) 它设置alpha透明度并向所有发送PlotChangeEvent注册的侦听器。 |
| 2 | setInteriorGap(double percent) 它设置了内部差距并发送PlotChangeEvent向所有注册的侦听器。这种控制的饼图绘图边缘与绘图区本身（即，其中部分标签显示的区域）之间的空间。这个方法是从父类PiePlot继承。 |
PlotOrientation 类
这是一个串行化类从org.jfree.chart.plot封装，它是用来显示一个二维曲线图的方位。方向可以是垂直的或水平的。它设置Y轴的方向。传统的绘图有一个垂直的Y轴。
字段摘要
| S.N. | 类型 | 字段 & 描述 |
|---|---|---|
| 1 | PlotOrientation | HORIZONTAL 为一个曲线图，其中所述范围轴（Y轴）是水平。 |
| 2 | PlotOrientation | VERTICAL 为一个曲线图，其中所述范围轴（Y轴）是垂直的。这个默认的方向。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | isHorizontal() 如果这个方向是水平的，此方法返回true，否则返回false。 |
| 2 | isVertical() 如果这个方向是VERTICAL，此方法返回true，否则返回false。 |
XYPlot 类
这在org.jfree.chart.plot包可用一个通用类，并将其用于在（X，Y）对的形式标绘数据。这个曲线图可以从实现XYDataSet接口的任何其它类中使用的数据。 XYPlot利用一个XYItemRenderer的画在图上的每个点。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | XYPlot() 该构造器没有数据集，无轴，无渲染器创建一个新的XYPlot实例。 |
| 2 | XYPlot(XYDataset dataset，ValueAxis domainAxis，ValueAxis rangeAxis，XYItemRenderer renderer），此构造函数创建一个新的绘图并指定数据集，轴和渲染。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setRenderer(XYItemRenderer renderer) 此方法设置渲染器的主要数据集，并发送更改事件向所有注册的侦听器。 |
NumberAxis 类
这个类是org.jfree.chart.axis封装，它可以访问任意轴的数值数据。当我们设置任何轴的范围为默认值，它根据所述数据的范围配合。但使用NumberAxis，类我们可以设置较低的利润率和定义域和值域轴的上侧边距。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | NumberAxis( ) 这是NumberAxis一个默认的构造函数。 |
| 2 | NumberAxis( java.lang.String label) 构造函数NumberAxis使用必要的默认值在哪里。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setLowerMargin(double margin) 它为轴心的利润率较低（为轴心范围的百分比），并发送一个AxisChangeEvent所有已注册的侦听器。这个方法是从父类ValueAxis继承。 |
| 2 | setUpperMargin(double margin) 它设置于所述轴的上缘（视轴范围的百分比），并发送一个AxisChangeEvent给所有注册的监听器。这种方法也存在于ValueAxis类。 |
XYLineAndShapeRenderer 类
这是在org.jfree.chart.renderer.xy包下的类，它需要连接数据点与线，并绘制形状，在每个数据点下是可用的。这个渲染器类是专为XYPlot类配合使用。
类的构造函数
| S.N. | 构造和描述 |
|---|---|
| 1 | XYLineAndShapeRenderer() 它创建了一个新的渲染器有两种线条和形状可见。 |
| 2 | XYLineAndShapeRenderer (boolean lines, boolean shapes) 它创建了一个新的渲染与特定的属性。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setSeriesPaint(int series, java.awt.Paint paint) 此方法设置用于一系列的涂料，并发送RendererChangeEvent给所有注册的监听器。这个方法是从AbstratRenderer抽象类从渲染器包中JFreeChart的API。 |
| 2 | setSeriesStroke(int series, java.awt.Stroke stroke) 此方法设置用于一系列的流程，并发送RendererChangeEvent向所有注册的侦听器。这个方法是从AbstratRenderer抽象类，它是这个包的超类。 |
XYItemRenderer通用数据集
这是用于使一个单一的（X，Y）格式项在XYPlot接口。org.Jfree.data.general包其具有类和接口，以定义不同类型的数据集来构造图。
PieDataset
这是作为一个通用的数据集，其中值与键相关联的接口。正如其名称所暗示的，可以使用这个数据集提供数据的饼图。此接口扩展KeyedValues数据集的接口。所有使用此接口的方法取自KeyedValues，Values和数据集的接口。
DefaultPieDataset 类
这是一个默认的实现类PieDataset接口。
类的构造函数
| S.N. | 构造函数和描述 |
|---|---|
| 1 | DefaultPieDataset() 该构造函数创建一个新的数据集，初始为空。 |
| 2 | DefaultPieDataset(KeyedValues data) 它从一个KeyedValues实例复制数据创建了一个新的数据集。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | setValue(java.lang.Comparable key, double value) 它设置数据值的键，发送DatasetChangeEvent向所有注册的侦听器。 |
| 2 | setValue(java.lang.Comparable key, java.lang.Number value) 它设置数据值的键，发送DatasetChangeEvent向所有注册的侦听器。 |
SeriesException 类
这是一个异常类。它会引发发生在时间序列中数据集的数据的异常。异常是引发上的重复或无效数据的次数。时间序列不能与重复应用，格式必须是有效的。
DefaultCategoryDataset
这是一个默认的实现类CategoryDataset接口。
类的构造函数
| S.N. | 构造函数及描述 |
|---|---|
| 1 | DefaultCategoryDataset() 此构造函数创建新的空数据集。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | addValue(double value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) 这种方法增加了一个值，以使用可比的键表。 |
| 2 | addValue(java.lang.Number value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) 这种方法增加了一个值的表。 |
| 3 | setValue(double value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) 此方法添加或在表中更新的值，并发送aDatasetChangeEvent给所有注册的监听器。 |
| 4 | setValue(java.lang.Number value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) 此方法添加或在表中更新的值，并发送DatasetChangeEvent给所有注册的监听器。 |
参见JFreeChart的API，用于各种其他方法和字段的详细信息。
序列数据集
系列数据集用于XY图表。该软件包是org.Jfree.data.xy，其中包含类和属于XY图表接口。核心接口是XYDataset。
XYDataset
这是通过该数据中的（X，Y）的项目的形式可被访问的接口。正如其名称所提示的，可以使用这个数据集服务XY图表。一些在这个接口中的方法都取自SeriesDateset接口。
XYZDataset
这是通过该数据的形式（x，y，z）的项目可被访问的接口。正如其名称所暗示的，可以使用这个数据集服务XYZ图。一些在这个接口中的方法都取自SeriesDateset。
XYSeries
这是一类，它代表了在所述形式的零个或多个数据项（x，y）的序列。默认情况下，该系列中的数据项都按升序排列由x值，并重复允许的x值。无论是排序和复制缺省值可以在构造函数中被改变。 Y值可以表示为空值代表缺失值。
类构造函数
| S.N. | 构造函数描述 |
|---|---|
| 1 | XYSeries(java.lang.Comparable key) 该构造函数创建一个新的空系列。 |
| 2 | XYSeries(java.lang.Comparable key, boolean autoSort) 它构造一个新的空系列，具有自动排序标志集的请求，并且重复的值是允许的。 |
| 3 | XYSeries(java.lang.Comparable key, boolean autoSort, boolean allowDuplicateXValues) 它构造一个新的xy系列不包含任何数据。 |
类方法
| S.N. | 方法描述 |
|---|---|
| 1 | add(double x, double y) 这种方法增加了数据项成系列。 |
在上述方法中使用的教程例子。如果想了解其余的方法和字段，请参考JFreeChart的API。
XYSeriesCollection
XYSeriesCollection类有类似父类AbstractIntervelDataset，AbstractXYDatset，AbstractSeriesDataset和AbstractDataset。一些在这个类中的方法属于这个类的父类。
类的构造函数
| S.N. | 构造函数描述 |
|---|---|
| 1 | XYSeriesCollection() 它构造一个空的数据集。 |
| 2 | XYSeriesCollection(XYSeries xyseries)它构建了一个数据集，并用一个系列的填充。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | addSeries(XYSeries series) 这种方法增加了一系列的收集和发送DatasetChangeEvent向所有注册的侦听器。 |
参见JFreeChart的API其余的方法和字段。
Default XYZDataset :
DefaultXYZDataset类都有父类，如AbstractIntervelDataset，AbstractXYDatset，AbstractSeriesDataset，AbstractDataset和AbstractXYZDataset。一些在这个类中的方法属于这一类的父类。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | DefaultXYZDataset() 它构造一个空的数据集。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | addSeries(java.lang.Comparable seriesKey, double[ ][ ] data ) 该方法增加了一系列的收集和发送DatasetChangeEvent向所有注册的侦听器。 |
请参考JFreeChart的API，其余的方法和字段。
JFreeCharts的时间序列
该软件包是org.jfree.data.time。该软件包包含用于时间相关的数据的类和接口。
TimeSeries :
此类表示数据项的期值的形式，其中一段是RegularTimePeriod抽象类，如时间，日，小时，分钟和秒类的一些实例序列。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | TimeSeries(java.lang.Comparable name) 它创建新的空系列。 |
| 2 | TimeSeries(java.lang.Comarable name, java.lang.String domain, java.lang.Strin range) 它会创建一个不包含任何数据的新的时间序列。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | add(RegularTimePeriod period,double value) 该方法增加了一个新的数据项用以串联。 |
其余的方法和字段参见JFreeChart的API。
TimeSeriesCollection :
这是作为时间序列的对象的集合的类。这个类实现了XYDataset接口，以及它扩展了IntervelXYDataset接口。这使得它可以方便地收集序列数据对象。
类的构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | TimeSeriesCollection() 它构造一个空的数据集，绑在默认时区。 |
| 2 | TimeSeriesCollection(TimeSeries series) 它构造一个包含单个系列（更多可添加），绑在默认时区的数据集。 |
| 3 | TimeSeriesCollection(TimeSeries series, java.util.TimeZone zone) 它构造包含单个系列（更可添加），绑定到特定的时间段的数据集。 |
| 4 | TimeSeriesCollection(java.util.TimeZone zone) 它构造一个空的数据集时，绑定到特定的时间区。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | addSeries(TimeSeries series) 方法增加了一系列的收集和发送DatasetChangeEvent向所有注册的侦听器。 |
其余的方法和字段请参考JFreeChart的API。
Second 类:
这个类表示一个特定的日子一秒钟。这个类是不可变的，这是对所有RegularTimePeriod子类的要求。
类的构造函数
| S.N. | 构造函数及描述 |
|---|---|
| 1 | Second() 它构造一个新的Second，基于系统的日期/时间。 |
| 2 | Second(java.util.Date time) 它构造从指定日期/时间和默认时区的新实例。 |
| 3 | Second(java.util.Date time, java.util.TimeZone zone, java.util.Locale locale) 它创建基于所提供的时间和时区的新的Second对象。 |
| 4 | Second(int second, int minute, int hour, int day, int month, int year)它创建了一个新的Second对象。 |
| 5 | Second(int second, Minute minute) 它构建了一个新的Second。 |
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | getSecond() 它返回分钟和秒。 |
| 2 | next() 它返回当前的下一秒。 |
其余的方法和字段请参考JFreeChart的API。
JFreeCharts 中的帧:
该软件包是org.jfree.ui。这是包所属JFreeChart的JCommons的API。它包含用于创建预配置的图表框架的实用程序类。
ApplicationFrame :
这是用于创建简单的应用程序的主框架的基类。帧监听窗口关闭事件，并作出反应，关闭JVM。这是很好的小型演示应用。对于企业应用程序，需要使用一些更稳健的东西。在这个类中的主要核心方法取自Component, Container, Window, Frame 和Jframe类。
类构造函数
| S.N. | 构造方法及描述 |
|---|---|
| 1 | ApplicationFrame(java.lang.String title) 它会创建一个字符串标题的应用程序框架。 |
这个类有助于创建AWT框架。这就是为什么我们使用这个类作为父类在本教程中的例子的原因。
其采取父类的方法用于打开一个框架，关闭一个框架，改变大小，改变背景或前景颜色和监听器。
RefineryUtilities :
这是关于用户界面的工具方法的类的集合。
类方法
| S.N. | 方法及描述 |
|---|---|
| 1 | centerFrameOnScreen(java.awt.Window frame) 它定位在屏幕的中间的指定帧。 |
在上述方法中使用的教程例子以外的类，方法和字段参见JFreeChart的API。