JFreeChart在JSP开发中的应用心得

WWW的发展使得基于因特网的应用程序不再局限于静态或者简单的动态内容提供。传统的一些以软件包形式发布的应用程序，例如报表系统等，都被逐渐搬到了因特网上。但是这两者之间有着天壤之别，虽然对于数据获取、业务处理等方面基本类似，但是最大的差别在于用户界面。为了能在web浏览器上显示所需的用户界面，需要使用HTML以及图片的方式来展现数据。传统的一些利用操作系统本身的控件来开发的用户界面就无法适应琳琅满目的客户端需求。为了可以在web浏览器上查看到图表，一般有两种做法：第一种就是使用applet利用java本身对图形的支持来显示一个图表；第二种就是直接在web服务器端生成好图表图片文件后发送给浏览器。第一种方式显然对于客户端要求太高，随着现在主流浏览器放弃对JAVA的支持后，这种方式只适合一些局域网的应用，而对于因特网的环境就显得不太适合。因此，可以选用JAVA的图表引擎JFreeChart用以产生基于WEB的图表。
JFreeChart是一个开源的JAVA项目，它主要用来开发各种各样的图表，这些图表包括：饼图、柱状图(普通柱状图以及堆栈柱状图)、线图、区域图、分布图、混合图、甘特图以及一些仪表盘等等。在这些不同式样的图表上可以满足目前商业系统的要求。JFreeChart是一种基于JAVA语言的图表开发技术。JFreeChart可用于Servlet、JSP、Applet、Java Appication环境中，通过JDBC可动态显示任何数据库数据，结合Itext可以输出至PDF文件。
JFreeChart主要是由三个类构成：
A）org.jfree.chart.servlet.ChartDeleter继承自HttpSessionBindingListener，用于实现当Session 关闭时，删除临时目中的图象文件。
B）org.jfree.chart.servlet.DisplayChart继承自Httpservlet 用于处理显示图象。
C）org.jfree.chart.servlet.ServletUtilities有一系列方法，例如，saveChartAs*;saveChartAs*是把图表按照不同的形式存储为图象；sendTempFile方法被重载了很多次，用于把文件流发送response。
下面以柱状图和饼图为例，介绍图形创建方法。
1 柱状图
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。
具体实现步骤：
1）创建用于图形生成所要的数据集对象。
CategoryDataset dataset = DatasetUtilities.createCategoryDataset(rowKeys, columnKeys, data)；
其中：rowKeys表示X轴数据，columnKeys表示Y轴数据，data表示填充柱状图所要的实际数据（来自于数据库）。
2）创建图形对象。
JFreeChart chart = ChartFactory.createBarChart3D("标题", null，null，dataset，PlotOrientation.VERTICAL,，true，false，false)；
createBarChart3D方法是ChartFactory工厂类里的一个方法，用于3D柱状图的生成，该类继承自JFreeChart。其中的八个参数分别代表：图形的标题、X轴标题、Y轴标题、dataset就是CategoryDataset类的实例对象、显示标题、启用热键、启用超键接。
3）设置图形显示的属性。
a ) ValueAxis类，设置柱到图上下边的距离。实现方法是：
ValueAxis rangeAxis = plot.getRangeAxis();
设置最高的一个柱与图片顶端的距离：
rangeAxis.setUpperMargin(0.15)
设置最低的一个柱与图片底端的距离：
rangeAxis.setLowerMargin(0.15)
b）org.jfree.chart.renderer.BarRenderer3D类，设置图形上显示的数值。实现方法如下：
BarRenderer3D renderer = new BarRenderer3D();
renderer.setBaseOutlinePaint(Color.BLACK);
设置 Wall 的颜色：
renderer.setWallPaint(Color.gray);
设置每个柱的颜色：
renderer.setSeriesPaint(0, new Color(0, 0, 255));
renderer.setSeriesPaint(1, new Color(0, 100, 255));
renderer.setSeriesPaint(2, Color.GREEN);
设置每个柱的 Outline 颜色
renderer.setSeriesOutlinePaint(0, Color.BLACK);
renderer.setSeriesOutlinePaint(1, Color.BLACK);
renderer.setSeriesOutlinePaint(2, Color.BLACK);
设置每个地区所包含的平行柱之间的距离
renderer.setItemMargin(0.1);
显示每个柱的数值，并修改该数值的字体属性
renderer.setItemLabelGenerator(new StandardCategoryItemLabelGenerator());
renderer.setItemLabelFont(new Font("黑体",Font.PLAIN,12));
renderer.setItemLabelsVisible(true);
为图形加入超连接
renderer.setItemURLGenerator(new StandardCategoryURLGenerator());
renderer.setToolTipGenerator(new StandardCategoryToolTipGenerator());
2 饼图
org.jfree.chart.plot包，包含创建饼形图的所有方法和属性。
笔者根据业务需求创建了setURLGenerator(PieURLGenerator generator)方法，在图片上建立连接，就是图片不同部分连接不同的资源。
setSectionLabelType(int type)方法：
指定 section 标签的类型，共有 7 种类型。如果不指定，默认是 NAME_LABELS，其中类型分别是：
PiePlot.NO_LABELS
PiePlot.NAME_LABELS
PiePlot.VALUE_LABELS
PiePlot.PERCENT_LABELS 、PiePlot.NAME_AND_VALUE_LABELS、PiePlot. NAME_AND_PERCENT_LABELS、PiePlot.VALUE_AND_PERCENT_LABELS。
setDefaultOutlinePaint(java.awt.Paint paint)方法，指定 section 轮廓线的颜色，如果不指定，默认值为NULL。
setDefaultOutlineStroke(java.awt.Stroke stroke)方法，指定 section 轮廓线的厚度。
setRadius(double percent) 和 setExplodePercent(int section, double percent)方法，抽离 section，就是把某一section从饼形图剥离出来，需要两个方法一起使用。
setStartAngle(double angle)方法，设置第一个section开始位置，默认从12点钟方向开始。
setPaint(int section, java.awt.Paint paint)方法指定section的颜色。
setDirection(int direction)方法指定section顺序，默认是顺时针方向。顺时针：PiePlot.CLOCKWISE；逆时针：PiePlot.ANTICLOCKWISE。
具体实现步骤：
1）创建用于图形生成所要的数据集对象。
首先实例化类DefaultPieDataset dataset = new DefaultPieDataset()。然后利用DefaultPieDataset类提供的setValue（value1,value2）方法，把从数据库里提取的数据存入DefaultPieDataset对象。其中value1是数据名称、value2是数据值。
2）创建图形对象。
首先实例化JFreeChart chart = ChartFactory.createPieChart3D(title, dataset, true, true, false)createPieChart3D方法是用于饼图生成的主要方法。其中title代表图形的标题、dataset就是DefaultPieDataset对象的实例。 3）设置图形显示的属性。
String filename = ServletUtilities.saveChartAsPNG(jFreeChart, 700, 450, info, session);
ChartUtilities.writeImageMap(pw, filename, info);
pw.flush()
saveChartAsPNG方法在ServletUtilities工厂类定义完成。主要用于把图形对象JFreeChart以图片的形式保存。其中的jFreeChart就是JFreeChart对象的实例。该方法返回一个文件名。
writeImageMap（pw, filename, info）方法用于把保存的图片文件以字节流的形式写入用户界面。
其中pw是java.io包的PrintWriter类的实例对象，该对象创建一个图形输出流。Filename是输出图片的文件名。该文件名来自ServletUtilities.saveChartAsPNG方法创建。
参数info用于图形信息的显示。
用ChartRenderingInfo info=new ChartRenderingInfo(new StandardEntityCollection())创建。
最后输出完成图形，调用pw.flush()方法关闭IO流。