JFreeChart的中文帮助文档一

1.基本配置

在JFreeChart的官方网站(http://www.jfree.org/jfreechart/index.html)上可以下载到该插件,该插件有两个版本:

l          jfreechart-1.0.6.zip,该版本适用于Windows系统。

l          jfreechart-1.0.6.tar.gz,该版本适用于UNIX / Linux系统。

本书所有案例的开发环境均为Windows系统,解压缩jfreechart-1.0.6.zip后将得到一个名为jfreechart-1.0.6的文件夹,只需将lib子文件夹内的如下文件拷贝到WEB应用程序的/WEB-INF/lib文件夹内:

l          jfreechart-1.0.5.jar

l          jcommon-1.0.10.jar

l          junit.jar

l          gnujaxp.jar

l          servlet.jar

并且在/WEB-INF/web.xml文件中添加如下代码,就可以利用JFreeChart插件生成统计图表了。

<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>

2.开发思路

在利用JFreeChart插件生成统计图表时,大体有两种开发思路,一种是通过工厂类ChartFactory创建JFreeChart实例,另一种是通过JFreeChart类创建JFreeChart实例。

在通过工厂类ChartFactory创建JFreeChart实例时,基本的开发思路如下:

(1)创建相应统计图的数据集实例。

(2)通过工厂类ChartFactory创建JFreeChart实例,ChartFactory类中的所有方法均需要传入一个数据集实例。

(3)订制图片和绘图区的绘制属性,该步可选。

(4)生成指定格式的图片,并返回生成图片的名称。

(5)组织图片浏览路径。

(6)通过HTML中的<img>元素显示图片。

在通过JFreeChart类创建JFreeChart实例时,基本的开发思路如下:

(1)创建相应统计图的绘图区实例;

(2)创建相应统计图的数据集实例,并传入绘图区实例;

(3)订制绘图区的绘制属性,例如绘图区的背景色,柱形图坐标轴的绘制属性,饼形图图例的填充色等,该步可选;

(4)通过JFreeChart类创建JFreeChart实例,JFreeChart类的所有构造方法均需要传入一个绘图区实例;

(5)订制图片的绘制属性,例如图片的标题、背景色等,该步可选;

(6)生成指定格式的图片,并返回生成图片的名称;

(7)组织图片浏览路径;

(8)通过HTML中的<img>元素显示图片。

3.核心API简介

在使用JFreeChart插件之前,先了解一下该插件的核心类及其功能,这对将来能够得心应手的使用该插件是非常重要的,JFreeChart核心类及其功能请参见表5.1。

表5.1                            JFreeChart核心类及其功能

类名

功能

JFreeChart

图表对象。生成任何类型的图表都要通过该对象,JFreeChart插件提供了一个工厂类ChartFactory,用来创建各种类型的图表对象

XXXDataset

数据集对象。用来保存绘制图表的数据,不同类型的图表对应着不同类型的数据集对象

XXXPlot

绘图区对象。如果需要自行定义绘图区的相关绘制属性,需要通过该对象进行设置

XXXAxis

坐标轴对象。用来定义坐标轴的绘制属性

XXXRenderer

图片渲染对象。用于渲染和显示图表

XXXURLGenerator

链接对象。用于生成Web图表中项目的鼠标单击链接

XXXToolTipGenerator

图表提示对象。用于生成图表提示信息,不同类型的图表对应着不同类型的图表提示对象

通过工厂类ChartFactory,可以创建各种类型的图表对象,常用的创建JFreeChart实例的方法及其功能请参见表5.2。

表5.2                            ChartFactory类中常用方法及其功能

名称

功能

createBarChart()和createBarChart3D()

分别用来创建绘制普通柱形图和3D柱形图的JFreeChart实例,它们基于的是DefaultCategoryDataset类型的数据集

createXYBarChart()

用来创建绘制普通柱形图的JFreeChart实例,它基于的是TimeSeries类型的数据集,TimeSeries数据集主要用来绘制与日期和时间相关的统计图

createStackedBarChart()和createStackedBarChart3D()

它们同createBarChart()和createBarChart3D()的功能相同,只是绘制出的柱形图效果不同,它们可以互换使用

createPieChart()和createPieChart3D()

分别用来创建绘制普通饼形图和3D饼形图的JFreeChart实例,它们基于的是DefaultPieDataset类型的数据集

createLineChart()和createLineChart3D()

分别用来创建绘制普通折线图和3D折线图的JFreeChart实例,它们基于的是DefaultCategoryDataset类型的数据集

createXYLineChart()

用来创建绘制普通折线图的JFreeChart实例,它基于的是TimeSeries类型的数据集,TimeSeries数据集主要用来绘制与日期和时间相关的统计图

createAreaChart()

用来创建绘制普通区域图的JFreeChart实例,它基于的是DefaultCategoryDataset类型的数据集

createXYAreaChart()

用来创建绘制普通区域图的JFreeChart实例,它基于的是TimeSeries类型的数据集,TimeSeries数据集主要用来绘制与日期和时间相关的统计图

createTimeSeriesChart()

用来创建绘制普通时序图的JFreeChart实例,时序图与折线图有些类似,不过时序图提供了绘制移动平均线的功能,通过给定的数据集实例,可以自动计算任意时间段的移动平均值,它基于的是TimeSeries类型的数据集,TimeSeries数据集主要用来绘制与日期和时间相关的统计图

*  注意:ChartFactory类中的所有方法均需要传入一个数据集实例,并且返回值类型均为JFreeChart

你可能感兴趣的:(Web,windows,linux,servlet,jfreechart)