当前位置: 代码迷 >> Web前端 >> JFreeChart的汉语言帮助文档一(转)
  详细解决方案

JFreeChart的汉语言帮助文档一(转)

热度:111   发布时间:2012-10-08 19:54:56.0
JFreeChart的中文帮助文档一(转)
1.基本配置
在JFreeChart的官方网站(http://www.jfree.org/jfreechart/index.html)上可以下载到该插件,该插件有两个版本:

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

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

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

jfreechart-1.0.5.jar

jcommon-1.0.10.jar

junit.jar

gnujaxp.jar

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