一、JFreeChart项目简介
JFreeChart是开放源代码站点SourceForge.net上的一个JAVA项目，它主要用来各种各样的图表，这些图表包括：饼图、柱状图(普通柱状图以及堆栈柱状图)、线图、区域图、分布图、混合图、甘特图以及一些仪表盘等等。这些不同式样的图表基本上可以满足目前的要求。为了减少篇幅本文主要介绍前面三种类型的图表，读者可以触类旁通去开发其他样式的图表。下面几个是JFreeChart产生的这三种类型图表的结果：
图1
图2
图3
上面的三个图都是表示四个季度的某个产品的销量信息。在继续下面小节之前必须先准备好开发环境，因为是基于WEB浏览器的图表展现，因此需要一个Servlet引擎或者是J2EE应用服务器（例如WebSphere，Tomcat等）。WEB环境的搭建就不累赘了，读者根据喜好自行安装。JFreeChart引擎本身需要到SourceForge.net上 下载，地址如下：
JFreeChart主页： http://www.jfree.org/jfreechart/index.html
JFreeChart 下载页面： http://sourceforge.net/projects/jfreechart/
下载的时候需要注意的是必须 下载两个文件：JFreeChart以及Jcommon。目前最新配套版本是：JFreeChart 0.9.11 Jcommon 0.8.6
这里有点笔者在开发中遇见的问题需要注意的是：在使用Eclipse开发的时候会报一个莫名其妙的错误，错误可能指向某个类文件的第一行。遇到这样的问题一般是因为没有把Jcommon的jar包设置到项目的类路径中的缘故。具体的原因不祥。
二、解读JFreeChart的 源码结构
在开始使用JFreeChart之前我们有必要先大概了解一下JFreeChart本身的结构以及它所带一些例子程序，这样有助于我们下一步自行开发。 下载JFreeChart包后已经带有非常丰富的例子，因为JFreeChart这个项目本身的使用文档非常少，因此学习它最好的办法就是学习它所带的例子 源码。在包org.jfree.chart.demo中有几十个文件用于展示JFreeChart所能支持的所有图表的结果。如果你的JDK是比较新的情况下可能在运行这些例子时会有问题，现象如下：
java.lang.UnsatisfiedLinkError: initDDraw
at sun.awt.windows.Win32OffScreenSurfaceData.initDDraw(Native Method)
at sun.awt.windows.Win32OffScreenSurfaceData.<clinit>(Win32OffScreenSurfaceData.java:141)
at sun.awt.Win32GraphicsDevice.<clinit>(Win32GraphicsDevice.java:58)
at sun.awt.Win32GraphicsEnvironment.makeScreenDevice(Win32GraphicsEnvironment.java:168)
at sun.java2d.SunGraphicsEnvironment.getScreenDevices(SunGraphicsEnvironment.java:240)
at sun.awt.Win32GraphicsEnvironment.getDefaultScreenDevice(Win32GraphicsEnvironment.java:61)
at java.awt.Window.init(Window.java:224)
at java.awt.Window.<init>(Window.java:268)
at java.awt.Frame.<init>(Frame.java:398)
at javax.swing.JFrame.<init>(JFrame.java:198)
at org.jfree.chart.demo.JFreeChartDemo.<init>(JFreeChartDemo.java:148)
at org.jfree.chart.demo.JFreeChartDemo.main(JFreeChartDemo.java:285)
Exception in thread "main"
这个错误是由于新版的Swing大量的使用了微软的DirectDraw的技术来提高画图的性能，而可能你的显卡在这时候会跟你闹点情绪或者显卡本身并不支持这样的一个技术。难道就没有办法了嘛？要解决这个问题也非常简单，我们可以屏蔽掉DirectDraw，不让Swing使用该技术就可以了。在运行这些代码时给虚拟机指定参数-Dsun.java2d.noddraw即可。
这时可能你又该纳闷了，不说是基于Web的图表嘛，怎么又扯到Swing上了？这是因为为了使开发者容易上手，无需配置任何运行环境，所以这些例子都是基于GUI方式的用于展现给开发者如果生成一个图表，我们要学习的也就是如何利用这个引擎生成图表而不是怎么来显示一个图表。当我们把生成的图表对象Export到一个图像文件即可在Web上发布。
下面我们来介绍JFreeChart中几个核心的对象类：
类名 类的作用以及简单描述
JFreeChart 图表对象，任何类型的图表的最终表现形式都是在该对象进行一些属性的定制。JFreeChart引擎本身提供了一个工厂类用于创建不同类型的图表对象
XXXXXDataset 数据集对象，用于提供显示图表所用的数据。根据不同类型的图表对应着很多类型的数据集对象类
XXXXXPlot 图表区域对象，基本上这个对象决定着什么样式的图表，创建该对象的时候需要Axis、Renderer以及数据集对象的支持
XXXXXAxis 用于处理图表的两个轴：纵轴和横轴
XXXXXRenderer 负责如何显示一个图表对象
XXXXXURLGenerator 用于生成Web图表中每个项目的鼠标点击链接
XXXXXToolTipGenerator 用于生成图象的帮助提示，不同类型图表对应不同类型的 工具提示类
基本上我认为JFreeChart项目本身的类结构的设计并不是很好，首先在创建图表的时候用到了大量的工厂方法，这样做虽然可以简化创建图表对象的代码，但是对项目本身或者开发人员来讲自行扩展一种新的图表都仍然是一件很麻烦的事情；其次除图表对象本身外其余的类过于复杂，使用者必须去了解每个类型的图表对象应该对应哪些Axis、Plot、Renderer类，并且必须非常熟悉这些类的构造函数中每个参数的具体含义。这些问题都大大困扰很多初学者。不过，虽然存在很多问题，但是JFreeChart本身仍不失为一个非常优秀的图表引擎，况且项目本身也在逐渐的发展中。
在非常简略的介绍了JFreeChart本身的代码结构后，下面我们开始动手试验几个常用的图表并把他们放到web上。
三、使用JFreeChart生成各种样式的图表
限于篇幅的问题我们在这里只实现两种常用的图表，其他类型图表读者可以触类旁通。我们先给出柱状图的实现，饼图的实现再来跟柱状图进行比较。
1 柱状图
package lius.chart.demo;
import java.io.*;
import org.jfree.data.*;
import org.jfree.chart.*;
import org.jfree.chart.plot.*;
/**
* 该类用于演示最简单的柱状图生成
* @author Winter Lau
*/
public class BarChartDemo {
public static void main(String[] args) throws IOException{
CategoryDataset dataset = getDataSet2();
JFreeChart chart = ChartFactory.createBarChart3D(
"水果产量图", // 图表标题
"水果", // 目录轴的显示标签
"产量", // 数值轴的显示标签
dataset, // 数据集
PlotOrientation.VERTICAL, // 图表方向：水平、垂直
true, // 是否显示图例(对于简单的柱状图必须是false)
false, // 是否生成 工具
false // 是否生成URL链接
);
FileOutputStream fos_jpg = null;
try {
fos_jpg = new FileOutputStream("D:\\fruit.jpg");
ChartUtilities.writeChartAsJPEG(fos_jpg,100,chart,400,300,null);
} finally {
try {
fos_jpg.close();
} catch (Exception e) {}
}
}
/**
* 获取一个演示用的简单数据集对象
* @return
*/
private static CategoryDataset getDataSet() {
DefaultCategoryDataset dataset = new DefaultCategoryDataset();
dataset.addValue(100, null, "苹果");
dataset.addValue(200, null, "梨子");
dataset.addValue(300, null, "葡萄");
dataset.addValue(400, null, "香蕉");
dataset.addValue(500, null, "荔枝");
return dataset;
}
/**
* 获取一个演示用的组合数据集对象
* @return
*/
private static CategoryDataset getDataSet2() {
DefaultCategoryDataset dataset = new DefaultCategoryDataset();
dataset.addValue(100, "北京", "苹果");
dataset.addValue(100, "上海", "苹果");
dataset.addValue(100, "广州", "苹果");
dataset.addValue(200, "北京", "梨子");
dataset.addValue(200, "上海", "梨子");
dataset.addValue(200, "广州", "梨子");
dataset.addValue(300, "北京", "葡萄");
dataset.addValue(300, "上海", "葡萄");
dataset.addValue(300, "广州", "葡萄");
dataset.addValue(400, "北京", "香蕉");
dataset.addValue(400, "上海", "香蕉");
dataset.addValue(400, "广州", "香蕉");
dataset.addValue(500, "北京", "荔枝");
dataset.addValue(500, "上海", "荔枝");
dataset.addValue(500, "广州", "荔枝");
return dataset;
}
}
程序运行结束后生成的图片文件效果如下图所示：
图4
如果是使用简单的数据即使用getDataSet方法获取数据集时产生的图片文件如下：
图5
2 饼图
对于饼图而言，数据集的获取用的不是同一个数据集类，另外饼图不支持同一个类别的项目中还有子项目这样的数据。我们只给出创建饼图的代码，至于写图表到一个文件则与柱状图一致，无需重复。
package lius.chart.demo;
import java.io.*;
import org.jfree.data.*;
import org.jfree.chart.*;
/**
* 用于演示饼图的生成
* @author Winter Lau
*/
public class PieChartDemo {
public static void main(String[] args) throws IOException{
DefaultPieDataset data = getDataSet();
JFreeChart chart = ChartFactory.createPie3DChart("水果产量图", // 图表标题
data,
true, // 是否显示图例
false,
false
);
//写图表对象到文件，参照柱状图生成源码
}
/**
* 获取一个演示用的简单数据集对象
* @return
*/
private static DefaultPieDataset getDataSet() {
DefaultPieDataset dataset = new DefaultPieDataset();
dataset.setValue("苹果",100);
dataset.setValue("梨子",200);
dataset.setValue("葡萄",300);
dataset.setValue("香蕉",400);
dataset.setValue("荔枝",500);
return dataset;
}
}
生成的饼图文件效果如下：
图6
四、将生成的图表移到浏览器上
为了将生成的图表直接传给客户端浏览器，只需要将前面两个例子中的文件流换成是通过HttpServletResponse对象获取到的输出流，详细代码清单如下：
package lius.chart.demo;
import java.io.IOException;
import javax.servlet.*;
import javax.servlet.http.HttpServlet;
import org.jfree.data.*;
import org.jfree.chart.*;
/**
* 演示通过servlet直接输出图表
* @author Winter Lau
*/
public class ChartDemoServlet extends HttpServlet {
public void service(ServletRequest req, ServletResponse res)
throws ServletException, IOException
{
res.setContentType("image/jpeg");
DefaultPieDataset data = getDataSet();
JFreeChart chart = ChartFactory.createPie3DChart("水果产量图",
data,
true,
false,
false
);
ChartUtilities.writeChartAsJPEG(res.getOutputStream(),
100,chart,400,300,null);
}
/**
* 获取一个演示用的简单数据集对象
* @return
*/
private static DefaultPieDataset getDataSet() {
DefaultPieDataset dataset = new DefaultPieDataset();
dataset.setValue("苹果",100);
dataset.setValue("梨子",200);
dataset.setValue("葡萄",300);
dataset.setValue("香蕉",400);
dataset.setValue("荔枝",500);
return dataset;
}
}
高级主题
很多情况我们不仅仅要求可以在浏览器上显示一个图表，我们更需要客户可以直接在图表上做一下交互的操作，例如获取信息提示，点击图表某个部分进行更详细信息的展示等等。例如前面生成的简单柱状图，用户需要在看到柱状图后点击某种水果例如是苹果即可看到各个地区苹果产量的情况。为此就要求该图形具有交互操作的功能。在HTML中为了让一个图像具有可交互的功能就必须给该图像定义一个Map对象。下表节选一段具有该功能的HTML代码
<MAP NAME="chartMap">
<AREA SHAPE="RECT" COORDS="81,15,126,254" href="?series=0&category=100" _fcksavedurl=""?series=0&category=100"" title="100 = 7,048"
οnclick="javascript:clickChart(´100´);return false;">
<AREA SHAPE="RECT" COORDS="143,27,188,255" href="?series=0&category=200" title="200 = 6,721"
οnclick="javascript: clickChart (´200´);return false;">
<AREA SHAPE="RECT" COORDS="205,54,250,255" href="?series=0&category=300" title="300 = 5,929"
οnclick="javascript: clickChart (´300´);return false;">
<AREA SHAPE="RECT" COORDS="267,85,312,255" href="?series=0&category=400" title="400 = 5,005"
οnclick="javascript: clickChart (´400´);return false;">
<AREA SHAPE="RECT" COORDS="329,17,374,255" href="?series=0&category=Diet" title="Diet = 7,017" οnclick="javascript:
clickChart (´Diet´);return false;">
</MAP>
由此就产生了一个问题：如果根据一个图像来生成对应的MAP对象。我们回头看看刚才的代码，在创建一个图表对象时候有两个参数，我们举柱状图的例子来讲这两个参数就是ChartFactory. createBarChart3D方法中的最后两个参数，这两个参数的类型都是布尔值。这两个参数意思分别是：是否创建工具提示(tooltip)以及是否生成URL。这两个参数分别对应着MAP中一个AREA的title属性以及href属性。
可是我想知道的是怎么来产生这个MAP啊！哈哈，不要着急，JFreeChart已经帮我们做好生成MAP对象的功能。为了生成MAP对象就要引入另外一个对象：ChartRenderingInfo。因为JFreeChart没有直接的方法利用一个图表对象直接生成MAP数据，它需要一个中间对象来过渡，这个对象就是ChartRenderingInfo。下图是生成MAP数据的流程图：
图7
如上图所示，ChartUtilities类是整个流程的核心，它周围的对象都是一些例如数据对象或者是文件等。这个流程简单描述如下：首先创建一个ChartRenderingInfo对象并在调用ChartUtilities的writeChartAsJPEG时作为最后一个参数传递进去。调用该方法结束后将产生一个图像文件以及一个填充好MAP数据的ChartRenderingInfo对象，有了这个对象我们还是没有办法获取具体的MAP数据，我们还必须借助于ChartUtilities的writeImageMap方法来将ChartRenderingInfo对象读取出来，获取MAP数据的代码片断如下：
PrintWriter w = null;
FileOutputStream fos_jpg = null;
FileOutputStream fos_cri = null;
try{
//根据不同类型的图表使用不同类，以下是针对饼图的操作
PiePlot plot = (PiePlot) chart.getPlot();
plot.setURLGenerator(new StandardPieURLGenerator(url));
//设置工具提示
plot.setToolTipGenerator(new StandardPieToolTipGenerator());
fos_jpg = new FileOutputStream(“d:\\fruit.jpg”);
ChartUtilities.writeChartAsJPEG(
fos_jpg,
100,
chart,
400,
300,
info);
fos_cri = new FileOutputStream(__d:\\fruit.map__);
w = new PrintWriter(fos_cri);
ChartUtilities.writeImageMap(w, __mapname__, info);
w.flush();
}finally{
try{
w.close();
}catch(Exception e){}
try{
fos_cri.close();
}catch(Exception e){}
try{
fos_jpg.close();
}catch(Exception e){}
}
打开文件D:\fruit.map，文件的内容就是要写到页面上的MAP数据。把生成的图像文件以及MAP数据文件写到页面上即可完成热点图表的功能。至于怎么结合两者之间的关系例如图像的useMap属性值必须与MAP对象的名称结合起来，必须根据实际的应用情况进行相应的处理。笔者建议把二者通过标签库封装起来，图像文件的名称以及MAP对象的名称由标签库统一进行控制，这样可以保证二者的一致性。
------------------------------------------------------------------------------------------------------------------------------------------
JFreeChart是一个开源的JAVA项目，它主要用来开发各种各样的图表，这些图表包括：饼图、柱状图(普通柱状图以及堆栈柱状图)、线图、区域图、分布图、混合图、甘特图以及一些仪表盘等等。在这些不同式样的图表上可以满足目前商业系统的要求。JFreeChart是一种基于JAVA语言的图表开发技术。JFreeChart可用于Servlet、JSP、Applet、Java Appication环境中，通过JDBC可动态显示任何数据库数据，结合Itext可以输出至PDF文件。<o:p> </o:p>
JFreeChart主要是由三个类构成：<o:p> </o:p>
A）org.jfree.chart.servlet.ChartDeleter继承自HttpSessionBindingListener，用于实现当Session 关闭时，删除临时目中的图象文件。<o:p> </o:p>
B）org.jfree.chart.servlet.DisplayChart继承自Httpservlet 用于处理显示图象。<o:p> </o:p>
C）org.jfree.chart.servlet.ServletUtilities有一系列方法，例如，saveChartAs*;saveChartAs*是把图表按照不同的形式存储为图象；sendTempFile方法被重载了很多次，用于把文件流发送response。<o:p> </o:p>
下面以柱状图和饼图为例，介绍图形创建方法。<o:p> </o:p>
1 柱状图<o:p> </o:p>
org.jfree.chart.ChartFactory这个工厂类有createBarChart、createStackedBarChart、createBarChart3D、createStackedBarChart3D，这几个工厂方法创建不同类型的柱状图，比较重要的是 PlotOrientation.VERTICAL 让平行柱垂直显示，而 PlotOrientation.HORIZONTAL 则让平行柱水平显示。对柱状图影响较大的几个类包括：org.jfree.chart.axis.CategoryAxis、org.jfree.chart.axis.ValueAxis、org.jfree.chart.renderer.BarRenderer、org.jfree.chart.renderer. BarRenderer3D。<o:p> </o:p>
具体实现步骤：<o:p> </o:p>
1）创建用于图形生成所要的数据集对象。<o:p> </o:p>
CategoryDataset dataset = DatasetUtilities.createCategoryDataset(rowKeys, columnKeys, data)；<o:p> </o:p>
其中：rowKeys表示X轴数据，columnKeys表示Y轴数据，data表示填充柱状图所要的实际数据（来自于数据库）。<o:p> </o:p>
2）创建图形对象。<o:p> </o:p>
JFreeChart chart = ChartFactory.createBarChart3D("标题", null，null，dataset，PlotOrientation.VERTICAL,，true，false，false)；<o:p> </o:p>
createBarChart3D方法是ChartFactory工厂类里的一个方法，用于3D柱状图的生成，该类继承自JFreeChart。其中的八个参数分别代表：图形的标题、X轴标题、Y轴标题、dataset就是CategoryDataset类的实例对象、显示标题、启用热键、启用超键接。<o:p> </o:p>
3）设置图形显示的属性。<o:p> </o:p>
a ) ValueAxis类，设置柱到图上下边的距离。实现方法是：<o:p> </o:p>
ValueAxis rangeAxis = plot.getRangeAxis();<o:p> </o:p>
设置最高的一个柱与图片顶端的距离：<o:p> </o:p>
rangeAxis.setUpperMargin(0.15)<o:p> </o:p>
设置最低的一个柱与图片底端的距离：<o:p> </o:p>
rangeAxis.setLowerMargin(0.15)<o:p> </o:p>
b）org.jfree.chart.renderer.BarRenderer3D类，设置图形上显示的数值。实现方法如下：<o:p> </o:p>
BarRenderer3D renderer = new BarRenderer3D();<o:p> </o:p>
renderer.setBaseOutlinePaint(Color.BLACK);<o:p> </o:p>
设置 Wall 的颜色：<o:p> </o:p>
renderer.setWallPaint(Color.gray);<o:p> </o:p>
设置每个柱的颜色：<o:p> </o:p>
renderer.setSeriesPaint(0, new Color(0, 0, 255));<o:p> </o:p>
renderer.setSeriesPaint(1, new Color(0, 100, 255));<o:p> </o:p>
renderer.setSeriesPaint(2, Color.GREEN);<o:p> </o:p>
设置每个柱的 Outline 颜色
renderer.setSeriesOutlinePaint(0, Color.BLACK);<o:p> </o:p>
renderer.setSeriesOutlinePaint(1, Color.BLACK);<o:p> </o:p>
renderer.setSeriesOutlinePaint(2, Color.BLACK);<o:p> </o:p>
设置每个地区所包含的平行柱之间的距离
renderer.setItemMargin(0.1);<o:p> </o:p>
显示每个柱的数值，并修改该数值的字体属性<o:p> </o:p>
renderer.setItemLabelGenerator(new StandardCategoryItemLabelGenerator());<o:p> </o:p>
renderer.setItemLabelFont(new Font("黑体",Font.PLAIN,12));<o:p> </o:p>
renderer.setItemLabelsVisible(true);<o:p> </o:p>
为图形加入超连接<o:p> </o:p>
renderer.setItemURLGenerator(new StandardCategoryURLGenerator());<o:p> </o:p>
renderer.setToolTipGenerator(new StandardCategoryToolTipGenerator());<o:p> </o:p>
2 饼图<o:p> </o:p>
org.jfree.chart.plot包，包含创建饼形图的所有方法和属性。<o:p> </o:p>
笔者根据业务需求创建了setURLGenerator(PieURLGenerator generator)方法，在图片上建立连接，就是图片不同部分连接不同的资源。<o:p> </o:p>
setSectionLabelType(int type)方法：<o:p> </o:p>
指定 section 标签的类型，共有 7 种类型。如果不指定，默认是 NAME_LABELS，其中类型分别是：<o:p> </o:p>
PiePlot.NO_LABELS<o:p> </o:p>
PiePlot.NAME_LABELS<o:p> </o:p>
PiePlot.VALUE_LABELS<o:p> </o:p>
PiePlot.PERCENT_LABELS 、PiePlot.NAME_AND_VALUE_LABELS、PiePlot. NAME_AND_PERCENT_LABELS、PiePlot.VALUE_AND_PERCENT_LABELS。<o:p> </o:p>
setDefaultOutlinePaint(java.awt.Paint paint)方法，指定 section 轮廓线的颜色，如果不指定，默认值为NULL。<o:p> </o:p>
setDefaultOutlineStroke(java.awt.Stroke stroke)方法，指定 section 轮廓线的厚度。<o:p> </o:p>
setRadius(double percent) 和 setExplodePercent(int section, double percent)方法，抽离 section，就是把某一section从饼形图剥离出来，需要两个方法一起使用。<o:p> </o:p>
setStartAngle(double angle)方法，设置第一个section开始位置，默认从12点钟方向开始。<o:p> </o:p>
setPaint(int section, java.awt.Paint paint)方法指定section的颜色。<o:p> </o:p>
setDirection(int direction)方法指定section顺序，默认是顺时针方向。顺时针：PiePlot.CLOCKWISE；逆时针：PiePlot.ANTICLOCKWISE。<o:p> </o:p>
具体实现步骤：<o:p> </o:p>
1）创建用于图形生成所要的数据集对象。<o:p> </o:p>
首先实例化类DefaultPieDataset dataset = new DefaultPieDataset()。然后利用DefaultPieDataset类提供的setValue（value1,value2）方法，把从数据库里提取的数据存入DefaultPieDataset对象。其中value1是数据名称、value2是数据值。<o:p> </o:p>
2）创建图形对象。<o:p> </o:p>
首先实例化JFreeChart chart = ChartFactory.createPieChart3D(title, dataset, true, true, false)createPieChart3D方法是用于饼图生成的主要方法。其中title代表图形的标题、dataset就是DefaultPieDataset对象的实例。
3）设置图形显示的属性。<o:p> </o:p>
String filename = ServletUtilities.saveChartAsPNG(jFreeChart, 700, 450, info, session);<o:p> </o:p>
ChartUtilities.writeImageMap(pw, filename, info);<o:p> </o:p>
pw.flush()<o:p> </o:p>
saveChartAsPNG方法在ServletUtilities工厂类定义完成。主要用于把图形对象JFreeChart以图片的形式保存。其中的jFreeChart就是JFreeChart对象的实例。该方法返回一个文件名。<o:p> </o:p>
writeImageMap（pw, filename, info）方法用于把保存的图片文件以字节流的形式写入用户界面。<o:p> </o:p>
其中pw是java.io包的PrintWriter类的实例对象，该对象创建一个图形输出流。Filename是输出图片的文件名。该文件名来自ServletUtilities.saveChartAsPNG方法创建。<o:p> </o:p>
参数info用于图形信息的显示。<o:p> </o:p>
用ChartRenderingInfo info=new ChartRenderingInfo(new StandardEntityCollection())创建。<o:p> </o:p>
最后输出完成图形，调用pw.flush()方法关闭IO流。
------------------------------------------------------------------------------------------
扫一扫
297
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
