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。

powered by Gitbook 该教程制作时间: 2016-01-12 15:32:41