JFreeChart使用教程(含下载、安装)之欧阳法创编

用JFreeChart增强JSP报表的
JFreeChart是一组功能强大、灵活易用的Java绘图A PI，使用它可以生成多种通用性的报表，包括柱状图、饼图、曲线图、甘特图等。

它能够用在Swing和Web等中制作自定义的图表或报表，并且得到广泛的应用。

本文将通过引领读者学习在JFreeChart中饼图、柱状图和曲线图的进阶应用，来达到熟练使用J FreeChart的目的。

一．下载与环境配置
1. 下载JFreeChart
JFreeChart是开放源代码的免费软件，但是它的支持文档需要付费才能得到。

其下载地址为：http://so /project/showfiles.php?group_id=15494，当前最新版本为1.0.6。

笔者下载的是1.0.6最新版。

说明：1）source目录：为jfreechart的源码目录；
2）lib目录：为包目录，我们需要关注的包为jfre echart-1.0.6.jar、gnujaxp.jar和jcommon-1.0.10.jar这三个包；
3）根目录下的jfreechart-1.0.6-demo.jar是例子程序，大家双击后可看到其中有很多例子的运行结果。

2. 环境配置
笔者的开发环境如下：
JDK：1.5
MyEclipse：5.1.1 GA
Tomcat：5.5.28
为了后续的“用JFreeChart创建基于Web的图表”的一个例子的展示，我们在MyEclipse中创建一个名为jfreechart的Web工程。

将下载的JFreeChart1.
0.6下lib目录下的jar包拷贝到WebRoot/WEB-INF/li b目录下。

另外还需要在web.xml文件中增加如下配置:
servlet servletnameDisplayChartservletname servletclass orgjfreechartservletDisplayChartservletclass servlet servlet mapping servletnameDisplayChartservletname
urlpatternDisplayCharturlpattern servletmapping
二．柱状图
在WebRoot目录下建立bar目录，用来存放柱状图的各个例子。

首先在该目录下建立一个sample1.jsp 文件，让我们来看一个简单的柱状图的例子，修改后的sample1.jsp的内容如下所示：
<%@ page contentType="text/html;charset=GBK"%> <%@ page import="org.jfree.chart.ChartFactor
y, org.jfree.chart.JFreeChart, org.jfree.chart. plot.PlotOrientation, org.jfree.chart.servlet.ServletUtil ities, org.jfree.data.category.DefaultCategoryDataset "%>
<%
DefaultCategoryDataset dataset = new DefaultCategoryD ataset();
dataset.addValue(610, "广州", "猪肉");
dataset.addValue(220, "广州", "牛肉");
dataset.addValue(530, "广州", "鸡肉");
dataset.addValue(340, "广州", "鱼肉"); JFreeChart chart = ChartFactory.createBarChart3D("肉类销量统计图", "肉类",
"销量",
dataset,
PlotOrientation.VERTICAL,
false,
April
http??localhost????
??
jfreechartbarsample jsp，可看到如下柱状图：
上面的这个柱状图比较简单，稍显单调，在有些情况下，我们需要用不同颜色来表示不同的种
类，或者在种类上标上具体数值，亦或需要加上??D水晶效果。

下面让我们来做更深一步的探
讨。

接下来让我们看一个用不同颜色来表示不通种类的例子。

在WebRoot的bar目录下新建sam ple jsp页面，将其代码修改如下：
April@ page contentType??2021texthtml??charset??GBK 2021April
April@ page import??2021orgjfreechartChartFactory
org.jfree.chart.JFreeChart,
org.jfree.chart.plot.PlotOrientation,
org.jfree.chart.servlet.ServletUtilities,
org.jfree.data.category.CategoryDataset,
org.jfree.data.general.DatasetUtilities"%>
<%
double[][] data = newdouble[][] {{1310}, {720}, {113 0}, {440}};
String[] rowKeys = {"猪肉", "牛肉","鸡肉", "鱼肉"}; String[] columnKeys = {""};
CategoryDataset dataset = DatasetUtilities.createCategory Dataset(rowKeys, columnKeys, data); 2021销量2021 dataset
true
false
false????
String graphURL = request.getContextPath() + "/Dis playChart?filename=" + filename;
%>
<img src="<%= graphURL %>"width=500 height=30 0 border=0 usemap="#<%= filename %>">
该页面的运行效果如下图所示：
对比该例与前例，可看出createBarChart3D的倒数第三个参数修改成了true，该参数可用来显示下方的：。

上两例我们显示的只是一个城市的肉类销量，有时候我们有对比显示多个城市的不同肉类，只要将上例稍作修改即可。

例如要在图中表示广州、深圳、东莞、佛山四个城市的四个肉类的销售情况，只需要将如下三句稍做修改：
double[][] data = newdouble[][] {{1310}, {720}, {113 0},
例如修改成：
double[][] data = newdouble[][] {{1310, 1220, 1110, 100 0},
在运行该jsp页面，可看到如下界面：
在上述几例中，在某个柱子上都没有显示相应的数值，下面让我们为每个柱子都加上它的数值，我们新建一个sample4.jsp页面，其内容如下：
<%@ page contentType="text/html;charset=GBK"%> <%@ page import="org.jfree.chart.ChartFactor
y, org.jfree.chart.JFreeChart, org.jfree.cha rt.plot.PlotOrientation, org.jfree.chart.servlet.Servlet Utilities, org.jfree.data.category.CategoryDataset, org.jfree.data.general.DatasetUtilities,
org.jfree.chart.plot.*,
bels.*,
org.jfree.chart.renderer.category.BarRenderer3D,
java.awt.*,
org.jfree.ui.*, org.jfree.chart.axis.AxisL ocation"%>
<%
double[][] data = newdouble[][] {{1310, 1220, 1110, 100 0},
{720, 700, 680, 640},
{1130, 1020, 980, 800},
true,
true,
false);
CategoryPlot plot = chart.getCategoryPlot();
//设置网格背景颜色
plot.setBackgroundPaint(Color.white);
//设置网格竖线颜色
plot.setDomainGridlinePaint(Color.pink);
renderer.setBasePositiveItemLabelPosition(n ew ItemLabelPosition(ItemLabelAnchor.OUTSIDE12, Te xtAnchor.BASELINE_LEFT));
renderer.setItemLabelAnchorOffset(10D);
//设置每个地区所包含的平行柱的之间距离
//renderer.setItemMargin(0.3);
plot.setRenderer(renderer);
//设置地区、销量的显示位置
//将下方的“肉类”放到上方
plot.setDomainAxisLocation(AxisLocation.TOP_OR_RI GHT);
//将默认放在左边的“销量”放到右方
plot.setRangeAxisLocation(AxisLocation.BOTTOM_OR _RIGHT);
String filename = ServletUtilities.saveChartAsPNG(char t, 700, 400, null, session);
String graphURL = request.getContextPath() + "/Display Chart?filename=" + filename;
%>
<img src="<%= graphURL %>"width=700 height=40 0 border=0 usemap="#<%= filename %>">
运行效果如下所示：
注意：jfreechart的很多版本不兼容，请大家在运行此例时确认下载了对应的版本。

三．饼图
在WebRoot目录下建立名为pie的子目录，用来存放本教程中饼图的实例jsp页面。

下面让我们来看一个简单的三维饼图。

首先在pie目录下建立一个名为sample1.jsp的页面。

在JFreeChart中，与饼图绘制密切相关的类如下：
1） PiePlot
饼图绘制类，可以用来设置饼图的相关属性。

例如：
PiePlot pieplot = (PiePlot)jfreechart.getPlot(); pieplot.setLabelFont(new Font("SansSerif", 0, 12)); pieplot.setNoDataMessage("No data available"); pieplot.setCircular(false);
pieplot.setLabelGap(0.02D);
2） DefaultPieDataset
默认的饼图数据集类，用来存储饼图显示的相
关数据信息。

例如：
DefaultPieDataset dataset = new DefaultPieDataset(); dataset.setValue("品德", new Double(0.2D)); dataset.setValue("体育", new Double(0.2D)); dataset.setValue("音乐", new Double(0.2D));
datasetsetValue 2021其余成绩2021 new Double
??D??????
??） ChartFactory
可利用该制图工厂类createPieChart来创建一
个饼图的JFreeChart对象，例如：
JFreeChart??jfreechart??????ChartFactorycreatePie
Chart 2021饼图示例2021??dataset??true??true??fa
lse????
??下面让我们看一个简单的例子，修改sample js p的内容如下：
April@ page contentType??2021texthtml??charset??GBK 2021April
April@ page import??2021orgjfreechart??
org.jfree.chart.plot.PiePlot, org.jfree.d ata.general.DefaultPieDataset,
org.jfree.chart.servlet.ServletUtilities,
java.awt.*"%>
<%
//设置数据集
DefaultPieDataset dataset = new DefaultPieDataset(); dataset.setValue("初中高级程序员", 0.55); dataset.setValue("项目经理", 0.1);
dataset.setValue("系统分析师", 0.1);
dataset.setValue("软件架构师", 0.1);
dataset.setValue("其他", 0.2);
//通过工厂类生成JFreeChart对象
JFreeChart chart = ChartFactory.createPieChart3D("IT 行业职业分布图", dataset, true, false, false);
PiePlot pieplot = (PiePlot) chart.getPlot();
pieplot.setLabelFont(new Font("宋体", 0, 12));
//没有数据的时候显示的内容
pieplot.setNoDataMessage("无数据显示");
pieplot.setCircular(false);
pieplot.setLabelGap(0.02D);
String filename = ServletUtilities.saveChartAsPNG(char t, 500, 300, null, session);
String graphURL = request.getContextPath() + "/Display Chart?filename=" + filename;
%>
<img src="<%= graphURL %>"width=500 height=30 0 border=0 usemap="#<%= filename %>">
可以看出，饼图的绘制与柱状图的绘制类似，该例的运行效果如下：
有时候我们还想知道某块所占的具体分值，或者需要突出显示某一块。

这时候需要对上例进行部分修改：dataset.setValue("其他", 0.2);后的那段改成：
//通过工厂类生成JFreeChart对象
JFreeChart chart = ChartFactory.createPieChart3D("IT 行业职业分布图", dataset, true, false, false);
PiePlot pieplot = (PiePlot) chart.getPlot();
pieplot.setLabelFont(new Font("宋体", 0, 12));
//没有数据的时候显示的内容
pieplot.setNoDataMessage("无数据显示");
pieplot.setCircular(false);
setExplodePercent方法很重要，它将Label为某名称的某块挖出来突出显示，而后两句实现的效果是在“初中高级程序员”等名称后加上百分比，改成“初中高级程序员=55%”等。

加上如上的代码后，同时还需要将相关的两个java包：bels.Stan dardPieSectionLabelGenerator和java.text.NumberFormat 引入到该jsp页面中。

此时的运行结果如下：
通过JFreeChart还可以提供漂亮的水晶饼图效果，接着让我们新建一个sample3.jsp页面来体验一下超炫美图吧。

修改sample3.jsp页面如下：
April
设置数据集
设置开始角度
April
利用setForegroundAlpha()方法可以设置3D饼图的透明度，利用setStartAngle()可以设置其开始角度，利用setDirection()方法可以设置其方向。

该例的运行效果如下图所示：
四．曲线图
接着我们来介绍曲线图的使用。

在笔者日常的开发工作中，曲线图用得最多，它可以用来绘制趋势图、统计分析等。

首先我们在WebRoot下建立一个li ne目录，用来存放曲线图实例的jsp页面。

我们在该目录下建立sample1.jsp页面来做一个简单的曲线图的例子。

在开始编码前，让我们来看看与画曲线图密切相关的几个类：
1） TimeSeriesCollection
曲线数据的集合。

2） TimeSeries
曲线信息序列。

3） ChartFactory
可以利用该类的createTimeSeriesChart方法来创建曲线的JFreeChart对象。

在下例中，我们显示阿蜜果的blog在2007年度各月份的访问量情况，修改后的sample1.jsp的内容如下：
<%@ page contentType="text/html;charset=GBK"%> April@ page import ??2021orgjfreechartChartFactory orgjfreechartJFreeChart orgjfreechartservletServletUtilities orgjfreecharttitleTextTitle orgjfreedatatimeTimeSeries orgjfreedatatimeMonth orgjfreedatatimeTimeSeriesCollection
javaawtFont2021April
April
访问量统计时间线
TimeSeries timeSeries ?? new TimeSeries 2021阿蜜果bl og访问量统计2021 Monthclass????
时间曲线数据集合
TimeSeriesCollection lineDataset ?? new TimeSeriesColle ction ????
构造数据集合
timeSeriesadd new Month
????
????
timeSeriesadd new Month
??????
????
timeSeriesadd new Month ??
??????
????
timeSeriesadd new Month ??
??????
????
timeSeries.add(new Month(5, 2007), 8200); timeSeries.add(new Month(6, 2007), 12200); timeSeries.add(new Month(7, 2007), 13200); timeSeries.add(new Month(8, 2007), 8300); timeSeries.add(new Month(9, 2007), 12400); timeSeries.add(new Month(10, 2007), 12500); timeSeries.add(new Month(11, 2007), 13600); timeSeries.add(new Month(12, 2007), 12500); lineDataset.addSeries(timeSeries);
JFreeChart chart = ChartFactory.createTimeSeriesChart("访问量统计时间线", "月份", "访问量", lineDataset, tru e, true, true);
//设置子标题
TextTitle subtitle = new TextTitle("2007年度", new Fon
t("黑体", Font.BOLD, 12));
chart.addSubtitle(subtitle);
//设置主标题
chart.setTitle(new TextTitle("阿蜜果blog访问量统计", new Font("隶书", Font.ITALIC, 15)));
chart.setAntiAlias(true);
String filename = ServletUtilities.saveChartAsPNG(char t, 500, 300, null, session);
String graphURL ?? requestgetContextPath ??2021Dis playChart?filename??2021 filename??
April
img src??2021April?? graphURL April2021width????
height????
border??
usemap??202121April?? filename April2021
运行后的曲线效果如下图所示：
??有时我们需要显示各数据点及其数值，这是我们需要对上例进行一点改动，在JFreeChart??chart??????C hartFactory createTimeSeriesChart……后，TextTitle??sub title??????new??TextTitle……前加上如下的代码：
XYPlot plot ??XYPlot?? chartgetPlot ???? XYLineAndShapeRenderer xylineandshaperenderer ?? XYLineAndShapeRenderer??plotgetRenderer????
设置网格背景颜色
plotsetBackgroundPaint Colorwhite????
设置网格竖线颜色plotsetDomainGridlinePaint Colorpink????
设置网格横线颜色plotsetRangeGridlinePaint Colorpink????
设置曲线图与xy轴的距离
plotsetAxisOffset new RectangleInsets
D
D
D
D??????
//设置曲线是否显示数据点xylineandshaperenderer.setBaseShapesVisible(true);
//设置曲线显示各数据点的值XYItemRenderer xyitem = plot.getRenderer(); xyitem.s etBaseItemLabelsVisible(true); xyitem.setBasePositiveIte mLabelPosition(new ItemLabelPosition(ItemLabelAnchor. OUTSIDE12, TextAnchor.BASELINE_LEFT)); xyitem.setBaseItemLabelGenerator(new StandardXYItem LabelGenerator());
xyitem.setBaseItemLabelFont(new Font("Dialog", 1, 14)); plot.setRenderer(xyitem);
并引入了一些另外的包，引入包的语句变成：
April@ page import ??2021orgjfreechartChartFactory orgjfreecharttitleTextTitle orgjfreedatatimeTimeSeries orgjfreedatatimeMonth orgjfreedatatimeTimeSeriesCollection orgjfreechartplotXYPlot orgjfreechartrendererxyXYLineAndShapeRenderer javaawtColor
org.jfree.ui.RectangleInsets,
java.awt.Font,
org.jfree.chart.renderer.xy.XYItemRenderer, org.jfree.chart.JFreeChart,
org.jfree.chart.servlet.ServletUtilities,
bels.*,
org.jfree.ui.*"%>
??运行该实例，效果如下所示：
上面两例的曲线图都是单曲线的，有时候我们对两个曲线进行比较，例如对阿蜜果在
??年度和
??年度的blog访问量进行比较，在此种情况下，我们需要在一个曲线图中显示两个曲线。

在此种情况下，我们只需要在sample jsp的基础上新建一个TimeSeri es对象，给它添加数据后，将其添加到TimeSeriesCol lection型数据集合对象中，修改后的程序主体部分如下所示：
访问量统计时间线
TimeSeries timeSeries
???? new TimeSeries 2021
??年度2021 Monthclass????
TimeSeries timeSeries
???? new TimeSeries 2021
??年度2021 Monthclass????
时间曲线数据集合
TimeSeriesCollection lineDataset ?? new TimeSeriesColle ction ????
构造数据集合
timeSeries
??add new Month
??????
????
timeSeries
??add new Month ??????
????
timeSeries
??add new Month ?? ??????
????
timeSeries
??add new Month ??
??????
????
timeSeries
??add new Month ?? ????????
????
timeSeries
??add new Month ?? ??????
????
timeSeries
??add new Month ??
??????
????
timeSeries
??add new Month ?? ????????
????
timeSeries
??add new Month ?? ????????
????
timeSeries
??add new Month
????????
???? timeSeries
??add new Month ????????
???? timeSeries
??add new Month ????????
???? timeSeries
??add new Month
????
????
timeSeries
??add new Month ??????
????
timeSeries
??add new Month ?? ??????
????
timeSeries
??add new Month ??
??????
????
timeSeries2007.add(new Month(5, 2007), 8200); timeSeries2007.add(new Month(6, 2007), 11200); timeSeries2007.add(new Month(7, 2007), 13200); timeSeries2007.add(new Month(8, 2007), 8300); timeSeries2007.add(new Month(9, 2007), 10400); timeSeries2007.add(new Month(10, 2007), 12500); timeSeries2007.add(new Month(11, 2007), 10600); timeSeries2007.add(new Month(12, 2007), 10500); lineDataset.addSeries(timeSeries2006);
设置子标题
设置主标题
该例的运行效果如下：
五．总结
本文通过详尽的实例讲述了如何利用JFreeChart 开发常用的柱状图、饼图和曲线图。

从这些实例中可以看出，JFreeChart是我们开发图表或报表的理想选择，它简单易用，并且容易理解，是我们开发的利刃。

时间：2021.03.09 创作：欧阳法。