学步园

一、JFreeChart的介绍与获取

JFreeChart开发包是一个开源的Java图形开发包,它从柱形图，饼形图，到雷达图，蜡烛图等等无所不包,可以在c/s,b/s,甚至是实时环境都能一显身手。

当前的JFreeChart的最新版本为jfreechart-1.0.0-rc1.zip。可以到http://www.jfree.org/jfreechart/ind...ath环境变量中。

二、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都遵循以下的这个使用步骤：

1、建立Dataset。所有的数据都存放在Dataset中的。(创建一个数据源（dataset）来包含将要在图形中显示的数据)

2、建立JFreeChart。将dataset中的数据导入到JFreeChart中。(创建一个 JFreeChart 对象来代表要显示的图形 )

3、设置JFreeChart的显示属性。这一步可以省略，使用默认的JFreeChart显示属性。

3、渲染图表。即生成图片。

4、页面图片显示。

重要的类和接口：

org.jfree.data.general.Dataset 所有数据源类都要实现的接口

org.jfree.chart.ChartFactory 由它来产生 JFreeChart 对象

org.jfree.chart.JFreeChart 所有对图形的调整都是通过它噢！！

org.jfree.chart.plot.Plot 通过JFreeChart 对象获得它，然后再通过它对图形外部部分（例：坐标轴）调整

注意：它有很多子类，一般都下涉及到它的子类！

org.jfree.chart.renderer.AbstractRenderer 通过JFreeChart 对象获得它，然后再通过它对图形内部部分(例：折线的类型）调整。同样，针对不同类型的报表图，它有着不同的子类实现！在下面我们简称它为 Renderer

四、JFreeChart使用的具体例子

在web应用中的例子

/*

* 创建日期 2006-8-1

* @author:hong

* FileName:LineXYChart.java

*/

package com.hong.bean;

import java.awt.Color;

import java.awt.Font;

import java.io.IOException;

import java.io.PrintWriter;

import java.text.NumberFormat;

import java.text.SimpleDateFormat;

import javax.servlet.http.HttpSession;

import org.jfree.chart.ChartFactory;

import org.jfree.chart.ChartRenderingInfo;

import org.jfree.chart.ChartUtilities;

import org.jfree.chart.JFreeChart;

import org.jfree.chart.axis.DateAxis;

import org.jfree.chart.axis.NumberAxis;

import org.jfree.chart.entity.StandardEntityCollection;

import org.jfree.chart.labels.StandardXYToolTipGenerator;

import org.jfree.chart.plot.XYPlot;

import org.jfree.chart.renderer.xy.XYItemRenderer;

import org.jfree.chart.renderer.xy.XYLineAndShapeRenderer;

import org.jfree.chart.servlet.ServletUtilities;

import org.jfree.chart.title.TextTitle;

import org.jfree.data.time.Day;

import org.jfree.data.time.TimeSeries;

import org.jfree.data.time.TimeSeriesCollection;

import org.jfree.data.xy.XYDataset;

import org.jfree.ui.RectangleInsets;

/**

* @author hong 曲线图的绘制

*/

public class LineXYChart

{

/**

* 返回生成图片的文件名

* @param session

* @param pw

* @return 生成图片的文件名

*/

public String getLineXYChart(HttpSession session, PrintWriter pw)

{

XYDataset dataset = this.createDateSet();//建立数据集

String fileName = null;

//建立JFreeChart

JFreeChart chart = ChartFactory.createTimeSeriesChart(

"JFreeChart时间曲线序列图", // title

"Date", // x-axis label

"Price", // y-axis label

dataset, // data

true, // create legend?

true, // generate tooltips?

false // generate URLs?

);

//设置JFreeChart的显示属性,对图形外部部分进行调整

chart.setBackgroundPaint(Color.red);//设置曲线图背景色

//设置字体大小，形状

Font font = new Font("宋体", Font.BOLD, 16);

TextTitle title = new TextTitle("JFreeChart时间曲线序列图", font);

chart.setTitle(title);

XYPlot plot = (XYPlot) chart.getPlot();//获取图形的画布

plot.setBackgroundPaint(Color.lightGray);//设置网格背景色

plot.setDomainGridlinePaint(Color.green);//设置网格竖线(Domain轴)颜色

plot.setRangeGridlinePaint(Color.white);//设置网格横线颜色

plot.setAxisOffset(new RectangleInsets(5.0, 5.0, 5.0, 5.0));//设置曲线图与xy轴的距离

plot.setDomainCrosshairVisible(true);

plot.setRangeCrosshairVisible(true);

XYItemRenderer r = plot.getRenderer();

if (r instanceof XYLineAndShapeRenderer)

{

XYLineAndShapeRenderer renderer = (XYLineAndShapeRenderer) r;

//renderer.setDefaultShapesVisible(true);

//renderer.setDefaultShapesFilled(true);

renderer.setShapesFilled(true);

renderer.setShapesVisible(true);//设置曲线是否显示数据点

}

//设置Y轴

NumberAxis numAxis = (NumberAxis) plot.getRangeAxis();

NumberFormat numFormater = NumberFormat.getNumberInstance();

numFormater.setMinimumFractionDigits(2);

numAxis.setNumberFormatOverride(numFormater);

//设置提示信息

StandardXYToolTipGenerator tipGenerator = new StandardXYToolTipGenerator(

"{1},{2})", new SimpleDateFormat("MM-dd"),

numFormater);

r.setToolTipGenerator(tipGenerator);

//设置X轴（日期轴）

DateAxis axis = (DateAxis) plot.getDomainAxis();

axis.setDateFormatOverride(new SimpleDateFormat("MM-dd"));

ChartRenderingInfo info = new ChartRenderingInfo(

new StandardEntityCollection());

try

{

fileName = ServletUtilities.saveChartAsPNG(chart, 500, 300, info,

session);//生成图片

// Write the image map to the PrintWriter

ChartUtilities.writeImageMap(pw, fileName, info, false);

}

catch (IOException e)

{

e.printStackTrace();

}

pw.flush();

return fileName;//返回生成图片的文件名

}

/**

* 建立生成图形所需的数据集

* @return 返回数据集

*/

private XYDataset createDateSet()

{

TimeSeriesCollection dataset = new TimeSeriesCollection();//时间曲线数据集合

TimeSeries s1 = new TimeSeries("历史曲线", Day.class);//创建时间数据源，每一个//TimeSeries在图上是一条曲线

//s1.add(new Day(day,month,year),value),添加数据点信息

s1.add(new Day(1, 2, 2006), 123.51);

s1.add(new Day(2, 2, 2006), 122.1);

s1.add(new Day(3, 2, 2006), 120.86);

s1.add(new Day(4, 2, 2006), 122.50);

s1.add(new Day(5, 2, 2006), 123.12);

s1.add(new Day(6, 2, 2006), 123.9);

s1.add(new Day(7, 2, 2006), 124.47);

s1.add(new Day(8, 2, 2006), 124.08);

s1.add(new Day(9, 2, 2006), 123.55);

s1.add(new Day(10, 2, 2006), 122.53);

dataset.addSeries(s1);

dataset.setDomainIsPointsInTime(true);

return dataset;

}

}

在jsp文件中显示图片

首先在Web应用程序部署文件web.xml中添加以下代码:

<!-- 图片显示，使用专用的servlet来进行显示，它会完成路径的搜索及映射 -->

<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>

然后在jsp中显示图片

完整的jsp文件：

<!--文件名称：timeLine.jsp-->

<%@ page contentType="text/html;charset=gb2312" pageEncoding="GB2312"%>

<%@ page import="com.hong.bean.LineXYChart"%>

<%@ page import = "java.io.PrintWriter" %>

<%

LineXYChart xyChart=new LineXYChart();

String fileName=xyChart.getLineXYChart(session,new PrintWriter(out));

String graphURL = request.getContextPath() + "/servlet/DisplayChart?filename=" + fileName;

%>

<html>

</head>

<title> JFreeChart使用例子</title>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

</head>

<body>

<img src="<%= graphURL %>" width=500 height=300 border=0 usemap="#<%= fileName %>">

</body>

</html>

 

常见生成方式：

对JfreeChart有了初步了解并做好准备工作之后，开始作例子程序试验。在这里我只介绍饼图的做法，而这张图采用不同的方式进行输出，其他类型的图片可以参考jfreechart提供的例子，做法都差不多。

1） 直接生成图片

代码

 

1. public class PieChartPicture {  
2. public static void main(String[] args)   
3. {  
4.  PieDataset dataset = getDataSet();  
5.  JFreeChart chart = ChartFactory.createPieChart3D(  
6.     " 项目进度分布", // chart title  
7.     dataset,// data  
8.     true,// include legend  
9.     true,  
10.     false  
11.    );  
12.   PiePlot3D  plot=(PiePlot3D)chart.getPlot();  
13.     // 图片中显示百分比:默认方式  
14.     //plot.setLabelGenerator(new           StandardPieSectionLabelGenerator(StandardPieToolTipGenerator.DEFAULT_TOOLTIP_FORMAT));  
15. // 图片中显示百分比:自定义方式，{0} 表示选项， {1} 表示数值， {2} 表示所占比例 ,小数点后两位  
16.  plot.setLabelGenerator(new StandardPieSectionLabelGenerator("{0}={1}({2})", NumberFormat.getNumberInstance(), new DecimalFormat("0.00%")));   
17. // 图例显示百分比:自定义方式， {0} 表示选项， {1} 表示数值， {2} 表示所占比例                  
18.  plot.setLegendLabelGenerator(new StandardPieSectionLabelGenerator("{0}={1}({2})"));   
19. // 设置背景色为白色   
20. chart.setBackgroundPaint(Color.white);   
21. // 指定图片的透明度(0.0-1.0)   
22.  plot.setForegroundAlpha(1.0f);   
23. // 指定显示的饼图上圆形(false)还椭圆形(true)   
24. plot.setCircular(true);   
25. // 设置图标题的字体   
26. Font font = new Font(" 黑体",Font.CENTER_BASELINE,20);   
27. TextTitle title = new TextTitle(" 项目状态分布");   
28. title.setFont(font);    
29. chart.setTitle(title);   
30. FileOutputStream fos_jpg = null;   
31. try {   
32.      fos_jpg=new FileOutputStream("D:// 项目状态分布.jpg");   
33.      ChartUtilities.writeChartAsJPEG(fos_jpg,100,chart,640,480,null);   
34.      fos_jpg.close();   
35. } catch (Exception e) {   
36.  }   
37. }   
38. private static PieDataset getDataSet() {   
39. DefaultPieDataset dataset = new DefaultPieDataset();   
40. dataset.setValue(" 市场前期", new Double(10));   
41. dataset.setValue(" 立项", new Double(15));   
42. dataset.setValue(" 计划", new Double(10));   
43. dataset.setValue(" 需求与设计", new Double(10));   
44. dataset.setValue(" 执行控制", new Double(35));   
45. dataset.setValue(" 收尾", new Double(10));   
46. dataset.setValue(" 运维",new Double(10));   
47. return dataset;          
48. }  
49. }   

 

2) 采用servlet和struts的action方式输出

采用这种方式输出，不用生成图片。

A ．servlet输出

代码

 

1. public class PieByServlet extends HttpServlet{   
2. public void service(ServletRequest req, ServletResponse res)   
3. throws ServletException, IOException   
4. {   
5.    res.setContentType("image/jpeg");   
6.    PieDataset dataset = getDataSet();   
7.    JFreeChart chart = ChartFactory.createPieChart3D(   
8.    " 水果饼图", // chart title   
9.    dataset,// data   
10.    true, // include legend   
11.    true,   
12.    false );   
13.    //设置图表属性  
14. // 输出图片   
15.  ChartUtilities.writeChartAsJPEG(res.getOutputStream(),100,chart,800,600,null);   
16. }   

 

B ．struts的action方式输出

只将这条语句加上try catch即可，并返回null。

代码

 

1. try{         
2. ChartUtilities.writeChartAsJPEG(response.getOutputStream(),100,chart,800,600,null);   
3.  } catch (Exception e) {   
4. }  
5. return null;   

 

其实采用这两种方式与生成图片的方式改动并不大

加上语句response.setContentType("image/jpeg");

ChartUtilities.writeChartAsJPEG(new FileOutputStream("D:// 项目状态分布.jpg");,100,chart,640,480,null);

文件流改成response的输出流就可以了

hartUtilities.writeChartAsJPEG(response.getOutputStream(),100,chart,800,600,null);

3）jsp＋servlet＋javabean方式

1. Create ChartViewer servlet

代码

 

1. public class ChartViewer extends HttpServlet {   
2. public void init() throws ServletException {  
3. }   
4. //Process the HTTP Get request  
5. public void doGet(HttpServletRequest request, HttpServletResponse response)  throws ServletException, IOException {   
6. // get the chart from session  
7. HttpSession session = request.getSession();   
8. BufferedImage chartImage = (BufferedImage) session.getAttribute("chartImage");   
9. // set the content type so the browser can see this as a picture   
10. response.setContentType("image/png");   
11. // send the picture   
12. PngEncoder encoder = new PngEncoder(chartImage, false, 0, 9);   
13. response.getOutputStream().write(encoder.pngEncode());  
14. }   
15. //Process the HTTP Post request   
16. public void doPost(HttpServletRequest request, HttpServletResponse response)  throws ServletException, IOException {   
17. doGet(request, response);   
18. }   
19. //Process the HTTP Put request   
20. public void doPut(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {   
21. }   
22. //Clean up resources   
23. public void destroy() { }   
24. }   

 

2. Create a servlet map in web.xml

代码

 

1. <?xml version="1.0" encoding="UTF-8"?>   
2. <web-app>   
3.  <servlet>   
4.  <servlet-name>ChartViewer</servlet-name>   
5.  <servlet-class>myapp.webwork.servlets.ChartViewer</servlet-class>   
6. </servlet>   
7. <servlet-mapping>   
8. <servlet-name>ChartViewer</servlet-name>   
9. <url-pattern>/servlet/ChartViewer</url-pattern>   
10. </servlet-mapping>   
11. </web-app>   

 

3. Create a chart in a java bean (Pie3DDemo.java)

代码

 

1. public class Pie3DDemo {   
2. private DefaultPieDataset getDataset() {   
3. // categories...   
4. String[] section = new String[] { "Jan","Feb","Mar","Apr","May","Jun", "Jul","Aug","Sep","Oct","Nov","Dec" };   
5. // data...   
6. double[] data = new double[section.length];   
7.  for (int i = 0; i < data.length; i++) {   
8.      data[i] = 10 + (Math.random() * 10);   
9. }   
10. // create the dataset...   
11. DefaultPieDataset dataset = new DefaultPieDataset();   
12. for (int i = 0; i < data.length; i++) {   
13.        dataset.setValue(section[i], data[i]);   
14. }   
15. return dataset;   
16. }   
17. public String getChartViewer(HttpServletRequest request, HttpServletResponse response) {   
18.  DefaultPieDataset dataset = getDataset();   
19. // create the chart...   
20.  JFreeChart chart = ChartFactory.createPie3DChart(   
21.   "Pie3D Chart Demo",  // chart title   
22.   dataset,             // data   
23.   true,                // include legend   
24.   true,   
25.   false   
26.  );   
27. // set the background color for the chart...   
28. chart.setBackgroundPaint(Color.cyan);   
29. PiePlot plot = (PiePlot) chart.getPlot();   
30. plot.setNoDataMessage("No data available");   
31. // set drilldown capability...   
32.  plot.setURLGenerator(new StandardPieURLGenerator("Bar3DDemo.jsp","section"));   
33. plot.setLabelGenerator(null);   
34. // OPTIONAL CUSTOMISATION COMPLETED.   
35. ChartRenderingInfo info = null;   
36. HttpSession session = request.getSession();   
37. try {   
38. //Create RenderingInfo object   
39.  response.setContentType("text/html");   
40.  info = new ChartRenderingInfo(new StandardEntityCollection());   
41.  BufferedImage chartImage = chart.createBufferedImage(640, 400, info);   
42. // putting chart as BufferedImage in session,   
43. // thus making it available for the image reading action Action.   
44. session.setAttribute("chartImage", chartImage);   
45. PrintWriter writer = new PrintWriter(response.getWriter());   
46. ChartUtilities.writeImageMap(writer, "imageMap", info);   
47. writer.flush();   
48. } catch (Exception e) { }   
49.   
50. String pathInfo = "http://";   
51. pathInfo += request.getServerName();   
52. int port = request.getServerPort();   
53. pathInfo += ":"+String.valueOf(port);   
54. pathInfo += request.getContextPath();   
55. String chartViewer = pathInfo + "/servlet/ChartViewer";   
56. return chartViewer;   
57. }   

 

6. 页面

代码

 

1.    
2. <html>   
3. <head>   
4. <title>Pie Chart Demo</title>   
5. </head>   
6. <jsp:useBeanidjsp:useBeanid="myChart"scope="session"class="myapp.webwork.beans.Pie3DDemo" />   
7. <body>   
8. <h2>Pie Chart Demo</h2>   
9. <%String chartViewer = myChart.getChartViewer(request, response);%>   
10. <img src="<%=chartViewer%>" border=0 usemap="#imageMap">   
11. </body>   
12. </html>   

 

4）采用工具类ChartUtil和DisplayChart（jfreechart的servlet）输出

我用了上面的几个方法输出图片，发现页面里只能输出一个图片，

不过下面的方法可以输出多个图片,而且是几种方式中最简单的一个，推荐使用。

这种方式和上面的三种比较类似，是将javabean里的生成图片的方法写的一个工具类ChartUtil里面。

1 ．添加工具类ChartUtil

public class ChartUtil {

// 产生时间序列图，返回图片名称

代码

 

1. public  static String generatePieChart(DefaultPieDataset dataset,String title,int width,int height,HttpSession session, PrintWriter pw) {   
2.   
3. String filename = null;   
4.  try {   
5.  if (session != null)   
6.  {   
7. ChartDeleter deleter = (ChartDeleter)session.getAttribute("JFreeChart_Deleter");   
8.  session.removeAttribute("JFreeChart_Deleter");   
9.  session.setAttribute("JFreeChart_Deleter", deleter);   
10. }   
11. JFreeChart chart = ChartFactory.createPieChart3D(   
12. title,  // chart title   
13. dataset, // data   
14. true,  // include legend   
15. true,   
16. false );   
17. //  Write the chart image to the temporary directory   
18. ChartRenderingInfo info = new ChartRenderingInfo(new StandardEntityCollection());   
19. //If the last parameter is null, the chart is a "one time"-chart and will be deleted after the first serving.   
20. //If the last parameter is a session object, the chart remains until session time out.   
21. filename = ServletUtilities.saveChartAsPNG(chart, width, height, info, session);   
22. //  Write the image map to the PrintWriter   
23.  ChartUtilities.writeImageMap(pw, filename, info,true);   
24.  pw.flush();   
25. } catch (Exception e) {   
26.  System.out.println("Exception - " + e.toString());   
27.  e.printStackTrace(System.out);   
28.  filename = "picture_error.png"; }   
29. return filename;   
30. }   
31. }   

 

2、在action里统计数据，设置好数据集dataset。传到页面

3、 在页面里取出

DefaultPieDataset piedataset=(DefaultPieDataset)request.getAttribute("piedataset");

// 用ChartUtil工具类产生图片

代码

 

1. String p = ChartUtil.generatePieChart(piedataset," 项目收支线图",500,300,null, new PrintWriter(out));   
2. String p1 = request.getContextPath() + "/servlet/DisplayChart?filename=" + p;   

 

通过以下方式输出

代码

 

1. <td><img src="<%= p1 %>" width=500 height=300 border=0 usemap="#<%= p %>"></td>  

 

4、在web.xml中添加

代码

 

1. <servlet>  
2.   <servlet-name>DisplayChart</servlet-name>  
3.   <servlet-class>org.jfree.chart.servlet.DisplayChart</servlet-class>  
4. </servlet>  
5. <servlet-mapping>  
6.     <servlet-name>DisplayChart</servlet-name>  
7.     <url-pattern>/servlet/DisplayChart</url-pattern>  
8. </servlet-mapping>  

 

5） ApplicationFrame 方式

代码

 

1. public class PieChartDemo1 extends ApplicationFrame {   
2. public PieChartDemo1(String title) {   
3. super(title);   
4. setContentPane(createDemoPanel());   
5. }   
6. private static JFreeChart createChart(PieDataset dataset) {   
7. JFreeChart chart = ChartFactory.createPieChart(   
8. .......  
9. return chart;   
10. }   
11.   
12. public static JPanel createDemoPanel() {   
13. JFreeChart chart = createChart(createDataset());   
14. return new ChartPanel(chart);   
15. }   
16.   
17. public static void main(String[] args) {   
18. PieChartDemo1 demo = new PieChartDemo1("Pie Chart Demo 1");   
19. demo.pack();   
20. RefineryUtilities.centerFrameOnScreen(demo);   
21. demo.setVisible(true);   
22. }   
23. }