JfreeChart使用经验总结

自己最近学习了JfreeChart的使用，觉得这个冬冬的功能非常强大，总结一下.

一、简介 
    WW 的发展使得基于因特网的应用程序不再局限于静态或者简单的动态内容提供。传统的一些以软件包形式发布应用程序例如报表系统等都在逐渐搬到因特网上。但是这两者之间有着天壤之别，虽然对于数据获取、业务处理等方面基本类似，但是最大的差别在于用户界面。为了能在web浏览器上显示要求用户界面使用 HTML以及图片的方式来展现数据，而传统的一些利用操作系统本身的控件来开发的用户界面无法适应琳琅满目的客户端，因此在这里也变得无能为力。回到本文的题目上来，为了创建一个可以在web浏览器上查看到图表一般有两种做法：第一种就是使用applet利用java本身对图形的支持来显示一个图表；第二 种就是直接在web服务器端生成好图表图片文件后发送给浏览器。第一种方式显然对于客户端要求太高，随着现在主流浏览器放弃对JAVA的支持后，这种方式 只适合一些局域网的应用，而对于因特网的环境就显得不太适合。因此我们下面将介绍一个JAVA的图表引擎JFreeChart用来产生基于WEB的图表。 
    JFreeChart 项目简介 JFreeChart是开放源代码站点SourceForge.net上的一个JAVA项目，它主要用来各种各样的图表，这些图表包括：饼图、柱状图(普 通柱状图以及堆栈柱状图)、线图、区域图、分布图、混合图、甘特图以及一些仪表盘等等。这些不同式样的图表基本上可以满足目前的要求。 

二、JFreeChart获取。 
         JFreeChart 是JFreeChart公司在开源网站SourceForge.net上的一个项目，该公司的主要产品有如下： 
         1.JFreeReport ：报表解决工具 
         2.JFreeChart:Java 图形解决方案（Application/Applet/Servlet/Jsp） 
         3.JCommon ：JFreeReport和JFreeChart的公共类库 
         4.JFreeDesigner ：JFreeReport的报表设计工具 
     我们可以从jfree官方网站上获取最新版本和相关资料（但是jfree的document需要40美金才能获取）， 
     获取地址：http://www.jfree.org/jfreechart/index.html（同时可以获得简明介绍） 
     我们以当前最新版本：jfreechart-1.0.1.zip为例子进行说明。 

三、JFreeChart配置安装 
     1 、解压jfreechart-1.0.1.zip.zip到指定位置，其中source是jfreechart的源码，jfreechart-1.0.1-demo.jar   是例子程序，可以先运行一下看看各种效果，就知道他的nb之处了。 
    2 、为了配置成功，我们需要关注的文件有如下三个： 
    设置classpath。加入下面三个jar包。 
    jfreechart-1.0.1.jar 、jcommon-1.0.0.jar、gnujaxp.jar 
    加上第三个jar包有时web.xml会报错，把它去掉就好了。 
        至此jfreechart的配置就完成了，下面就可以进行jfreechart的开发了。这里值得提出的是jfreechart的类 
        结构设计前后兼容性不是很好，不同版本的jfreechart中类库结构可能不一样，有时候可能需要查源码。如果是中文显示的时候可能依据观感需要改变源码的字体。 


四、JFreeChart功能介绍 
     JFreeChart 目前是最好的java图形解决方案，基本能够解决目前的图形方面的需求，主要包括如下几个方面： 
     pie   charts   (2D   and   3D) ：饼图（平面和立体） 
     bar   charts   (regular   and   stacked,   with   an   optional   3D   effect) ：柱状图 
     line   and   area   charts ：曲线图 
     scatter   plots   and   bubble   charts 
     time   series,   high/low/open/close   charts   and   candle   stick   charts ：时序图 
     combination   charts ：复合图 
     Pareto   charts 
     Gantt   charts ：甘特图 
     wind   plots,   meter   charts   and   symbol   charts 
     wafer   map   charts 
     ( 态图表,饼图(二维和三维)   ,   柱状图   ( 水平,垂直),线图,点图,时间变化图,甘特图,   股票行情图,混和图,   温度计图,   刻度图等常用商用图表) 
     图形可以导出成PNG和JPEG格式，同时还可以与PDF和EXCEL关联 
     JFreeChart 核心类库介绍： 
             研究jfreechart源码发现源码的主要由两个大的包组成：org.jfree.chart,org.jfree.data。其中前者主要与图形 
     本身有关，后者与图形显示的数据有关。具体研究如果大家有兴趣的话可以自己研究    。 
          核心类主要有： 
            org.jfree.chart.JFreeChart ：图表对象，任何类型的图表的最终表现形式都是在该对象进行一些属性的定制。JFreeChart引擎本身提供了一个工厂类用于创建不同类型的图表对象 
            org.jfree.data.category.XXXDataSet: 数据集对象，用于提供显示图表所用的数据。根据不同类型的图表对应着很多类型的数据集对象类 
            org.jfree.chart.plot.XXXPlot ：图表区域对象，基本上这个对象决定着什么样式的图表，创建该对象的时候需要Axis、Renderer以及数据集对象的支持 
            org.jfree.chart.axis.XXXAxis ：用于处理图表的两个轴：纵轴和横轴 
            org.jfree.chart.render.XXXRender ：负责如何显示一个图表对象 
            org.jfree.chart.urls.XXXURLGenerator: 用于生成Web图表中每个项目的鼠标点击链接 
            XXXXXToolTipGenerator: 用于生成图象的帮助提示，不同类型图表对应不同类型的工具提示类 

    个人感觉JFreeChart可以满足大部分图片创建的需要，美中不足的是：对字体的设置做的不够好，特别是使用中文的时候字体很不清晰。因为这个原因建议你自己去修改他的源代码，最好使用properties文件去设置字体.还有就是文档要钱所以要多花点时间去看源代码。或多上社区. 

五.Android中绘制图表解决方案：

1) 使用google 图表 api 　　

2) 使用Achartengine库(http://www.achartengine.org/) 　　

3) 使用chartdroid库(http://code.google.com/p/chartdroid/)

4) 使用 RChart 2库实现。

详情请见:http://blog.csdn.net/zxcvzxcv7/article/details/7686616

六,开发问题小结

问题一：在每次生成jfreechar图片的时候都会抛出异常，异常指出问题出在ChartFactory.createXYLineChart(picName, "时间轴", "数据", xydataset,true, true, false)这行代码上(或create其他类型的chart)

分析：由于jfreechart用到的画图库是Java AWT，所以需要确保JVM运行在headless模式下。如果在Unix系统中使用jfreechar，需要在tomcat的bin目录下catalina.sh文件中run和start两处添加-Djava.awt.headless=true \

问题二：在Unix系统下生成的jfreechart图片中的中文出现乱码

分析：乱码有两种情况：
        一种是中文显示为问号(?)，这种情况一般是由于汉字编码转换出错。需要对Unix系统中当前用户的.cshrc文件中setenv LC_CTYPE iso_8859_1修改为setenv LC_CTYPE zh即可。
        一种是中文显示为方框(□)，这种情况一般是由于jfreechart中用到的字体在当前Unix系统中不存在。jfreechart包中所用到的所有字体如下：
new Font("SansSerif", 1, 12)
new Font("foo", 1, 9)
new Font("Arial", 0, 10)
new Font("Dialog", 0, 12)
new Font("Bitstream Vera Sans", 0, 11)
其中new Font("Bitstream Vera Sans", 0, 11)字体用于对各颜色线条的注释信息，Unix系统中一般不存在这种字体，需要安装该字体或者修改package org.jfree.chart.block中LabelBlock文件的构造函数中所出现的这种字体。

问题三：jfreechart生成的图片时间轴中时间的显示格式问题

分析：在生成两组或者多组数据的chart时，分为以下两种情况：
        一种是X和Y轴数据都仅仅只是数据，则可以直接使用ChartFactory.createXYLineChart(picName, "X轴数据", "Y轴数据", xydataset,true, true, false)，xydataset是通过XYSeriesCollection收集XYSeries获取的数据生成：
XYSeries[] xyseries=new XYSeries[count];
for(int i = 0; i < count; i ++){
xyseries[i] = new XYSeries(name[i]);
}
xyseries[1].add(double arg0,double arg1);
xyseries[2].add(double arg0,double arg1);
两组数据都必须以双精度格式传入，在chart图中的X和Y轴数据也都会以双精度格式显示。
        一种是X轴数据是时间，Y轴数据为与这个时间对应的一个有一定精确度的数据，这种情况就得使用ChartFactory.createTimeSeriesChart(picName, "时间轴", "数据", xydataset,true, true, false)，xydataset是通过TimeSeriesCollection收集TimeSeries获取的数据生成：
TimeSeries timeseries[] = new TimeSeries[count];
for(int i = 0; i < count; i ++){
timeseries[i] = new TimeSeries(name[i],Minute.class);
}
timeseries[0].addOrUpdate(new Minute(minute,hour,date,month,year), double arg1);
timeseries[1].addOrUpdate(new Minute(minute,hour,date,month,year), double arg1);
(注：这里使用addOrUpdate而不使用add是有原因的，如果使用add的话，送入一次数据，生成一个chart图片，当下一次其他某个地方再调用这个方法生成chart图片的时候，就会报出数据冲突的异常信息，估计是上次送入的数据没有清除掉，所以为了防止这种情况一般都使用addOrUpdate)
两组数据是以(时间，双精度数据)成对送入的，X轴将会是一个时间轴，而且会以通用的时间格式进行显示，显示的时间格式可以在代码中定制，详细代码如下：
DateAxis dateaxis = (DateAxis)xyplot.getDomainAxis();
dateaxis.setDateFormatOverride(new SimpleDateFormat("时间格式"));
还有一个地方需要说明一下，时间轴上显示的时间精度可以根据自己的需要选择设定，最大可以精确到年，最小可以精确到毫秒，设置的位置在timeseries[i] = new TimeSeries(name[i],Minute.class)代码中，目前精确度设置为分(Minute.class)，所有可选精确度如下：Year.class Month.class Week.class Day.class Hour.class Minute.class Seconds.class Millisecond.class，然后在timeseries[0].addOrUpdate(new Minute(minute,hour,date,month,year), double arg1)代码中也做相应调整即可。