在 Eclipse RCP 中运用 Open Flash Chart 展现图表

核心提示：Open Flash Chart（OFC） 是一个开源的 Flash 图表绘制工具。本文主要介绍如何在 Eclipse RCP 中使用 OFC 更好的展示图表。在文章的最后，对 JFreeChart 、BIRT Chart 、OFC 三种图表工具做了比较。

Open Flash Chart（OFC） 是一个开源的 Flash 图表绘制工具。本文主要介绍如何在 Eclipse RCP 中使用 OFC 更好的展示图表。在文章的最后，对 JFreeChart 、BIRT Chart 、OFC 三种图表工具做了比较。

Open Flash Chart 简介

Open Flash Chart（OFC）是一个开源的 Flash 图表绘制工具，提供了各种程序接口的数据生成方式，包括 PHP、Ruby、Perl、Python、Java、.Net、AS、JS 等，OFC 2.0 提供了对 JSON 格式数据的支持。通过 Flash 展示的功能，很简单的就生成一份直观形象的数据统计图表，是制作 Flash 图形报表的不错开源工具。

OFC 的出现，源自作者作为客户经历的一个不愉快的故事。OFC 的作者曾经使用了某个公司开发的 Flash 图表软件，但在使用时出现了一个问题，于是作者写信去询问什么时候可以解决这个问题。令作者感到不愉快的是，过了三四个星期都没有得到答复。作者想，他应 该学习下Flash 和 Actionscript，自己写一个软件来用。因此，OFC 出现了！作者把 OFC 放到 sourceforge，作为一个免费的开源软件来发布。作者最后说，千万不要招惹你的客户 (don't piss off your customers) 。

Open Flash Chart 提供了很强大的图形报表绘制功能，依赖于 Flash，使得图形美观、流畅，具有很好的动态效果，因此，越来越受开发人员和用户的欢迎。

Open Flash Chart 所支持的统计样式比较丰富，包括： Line Chart，Bar Chart，Sketch Bar Chart, Horizontal Bar Chart, Stacked Bar Chart, Area Chart, Pie Chart, Scatter Chart, Radar Chart 等等。下面是部分样式的示例图。

图 1. OFC 部分样式的示例图
 

Open Flash Chart 在 Web 上的应用

目前，Open Flash Chart 主要应用在 Web 开发上，实现了很好的图形效果。OFCGWT 项目是Google在 Web 方面应用 OFC 的一个实例。OFCGWT 基于 Open Flash Chart 2 开发，用于GWT 应用的开源图表制作组件。

Web 开发中，主要使用下面两个文件，

• open-flash-chart.swf: Flash 文件接口，通过该文件来生成 Flash 文件，备页面调用(在 web 目录下，与 WEB-INF 目录并级)。

• swfobject.js: Flash 文件依赖的 JS 文件(在 web 目录下，与 WEB-INF 目录并级)。

调用 open-flash-chart.swf

首先在页面中编写 script 脚本,保存页面为 chart.html。

1. < html >   
2. < head >   
3.   
4. < script   type = "text/javascript"   src = "js/swfobject.js" > </ script >   
5. < script   type = "text/javascript" >   
6. swfobject.embedSWF("open-flash-chart.swf", "my_chart", "250", "200", "9.0.0");   
7. </ script >   
8.     
9. </ head >   
10. < body >   
11. < p > Hello World </ p >   
12. < div   id = "my_chart" > </ div >   
13. </ body >   
14. </ html >   

其次，编写图表的 JSON 文本，将该文本保存为 data.json, 放在与 chart.html 同一个目录下。

1. {   
2.    "title" :{   
3.      "text" :   "Many data lines" ,   
4.      "style" :  "{font-size: 20px; color:#0000ff; font-family: Verdana; text-align: center;}"   
5.   },   
6.     
7.    "y_legend" :{   
8.      "text" :  "Open Flash Chart" ,   
9.      "style" :  "{color: #736AFF; font-size: 12px;}"   
10.   },   
11.     
12.    "elements" :[   
13.     {   
14.        "type" :       "bar" ,   
15.        "alpha" :      0.5 ,   
16.        "colour" :     "#9933CC" ,   
17.        "text" :       "Page views" ,   
18.        "font-size" :  10 ,   
19.        "values"  :   [ 9,6 , 7,9 , 5,7 , 6,9 , 7 ]   
20.     },   
21.     {   
22.        "type" :       "bar" ,   
23.        "alpha" :      0.5 ,   
24.        "colour" :     "#CC9933" ,   
25.        "text" :       "Page views 2" ,   
26.        "font-size" :  10 ,   
27.        "values"  :   [ 6,7 , 9,5 , 7,6 , 9,7 , 3 ]   
28.     }   
29.   ],   
30.     
31.    "x_axis" :{   
32.      "stroke" : 1 ,   
33.      "tick_height" : 10 ,   
34.      "colour" : "#d000d0" ,   
35.      "grid_colour" : "#00ff00" ,   
36.      "labels" : [ "January" , "February" , "March" , "April" , "May" ,   
37.                  "June" , "July" , "August" , "Spetember" ]   
38.    },   
39.     
40.    "y_axis" :{   
41.      "stroke" :       4 ,   
42.      "tick_length" :  3 ,   
43.      "colour" :       "#d000d0" ,   
44.      "grid_colour" :  "#00ff00" ,   
45.      "offset" :       0 ,   
46.      "max" :          20   
47.   }   
48. }   

在浏览器地址栏输入URL，比如：http://localhost:8080/chart/chart.html?ofc=data.json , 就可以看到的图表效果。

 

目前，有许多应用的 GUI 是基于 Eclipse RCP 或者 SWT 开发的。但是 OFC 这样强大的图形报表工具还没有出现在 Eclipse RCP 应用中。在这些应用中也需要绘制图形报表，需要 Open Flash Chart 这样的工具来实现很好的图形效果。

Open Flash Chart 2 在 Eclipse RCP 中的使用很简单。在 SWT 组件中，通过 Flash 播放器来播放 open-flash-chart.swf，然后再加载图表的 JSON 格式数据即可。

要使用 Open Flash Chart，我们需要播放 open-flash-chart.swf 这个文件。在 Window 平台，我们使用包 org.eclipse.swt.ole.win32 提供的 Ole 组件来实现 Flash 的播放。

1. 注册 Flash 组件

首先创建一个 OleFrame 对象来作为容纳 Ole 对象的容器，然后再创建一个 Flash 类型的 Ole对象。"ShockwaveFlash.ShockwaveFlash" 为 Macromedia Flash 的 ShockwaveFlash 控件在 Windows 平台上的唯一标识符，程序将自动使用当前控件的最新版本。打开 Windows 注册表,在注册表中可以找到 HKEY_CLASSES_ROOT/ShockwaveFlash.ShockwaveFlash 相关项及对应版本。

1. OleFrame oleFrame =  new  OleFrame(shell, SWT.NONE);   
2. oleFrame.setLayoutData( new  GridData(GridData.FILL_BOTH));   
3. OleControlSite controlSite =    
4.      new  OleControlSite(oleFrame, SWT.NONE,  "ShockwaveFlash.ShockwaveFlash" );   
5. controlSite.doVerb(OLE.OLEIVERB_SHOW);   //定义为显示控件   

1. 通过 OleAutomation 来调用注册组件

对 Active X 控件的操作通过 OleAutomation 对象来实现，并通过 automation.getIDsOfNames()来得到控件方法对应的 id 值。借助 OleView.exe 工具，可以查看 ActiveX 控件的方法。

1. final  OleAutomation automation =  new  OleAutomation(controlSite);   
2. int [] methodIDs = automation.getIDsOfNames( new  String[] {  "LoadMovie"  });   
3.     

1. 加载 JSON 文件

通过 automation.invoke(int, Variant[]) 来调用 Active X 控件的方法。其中的 int 参数表示要调用的 Active X 控件的方法的 ID，Variant[] 参数就是要传递给 Active X 控件的方法的参数。

1. Variant[] methodArgs = {    
2.      new  Variant( 0 ),  new  Variant(file+ "?data-file=jsonfile.txt " ) };    
3. automation.invoke(methodIDs[ 0 ], methodArgs);   

在清单5中，String file 是 open-flash-chart.swf 的绝对路径，jsonfile.txt 是需要加载的 JSON 数据的文件路径。

要通过 Open Flash Chart 来绘制图表，需要生成图表对应的 JSON 数据文件。我们使用 Json Tools 来对 JSON 进行处理。

1. 使用 JSON Tools

JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式，基于 ECMAScript 标准中对ObjectLiteral 的定义 (ECMA-262, 11.1.5)，通过一组键值对来定义一个对象。可以用 JSON 来描述一个图表，然后通过 Open Flash Chart 加载 JSON 数据持久化后的文本文本，就能展示这个图表。

JSON Tools 采用 Java 面向对象的方法对 JSON 的处理进行了封装。使用 JSON Tools 封装的API，可以很方便的对 JSON 格式的文本进行操作，进行 JSON 文本到 java 对象之间的相互转换。利用 JSON Tools，即使对 JSON 不是很了解的开发人员，也能很容易的构造出想要的 JSON 格式文本。在 http://developer.berlios.de/projects/jsontools/ 可以下载到 JSON Tools.

1. Chart 模型的设计

我们根据 Chart 需要支持的相关属性来设计 Chart 的模型。依赖于 JSON Tools，采用策略模式进行 Chart 模型和 JSON 对象间的转换。下面是简单的设计类图。

各种不同类型的 Chart 需要继承和扩展 Element 来实现。通过 Chart 模型，使用面向对象的编程方法，只需调用 ChartData 里的 buildJSON 方法就可以构建展示 Flash 图表所需要的 JSON 格式的文本文件。

buildJSON 方法是从 Chart 模型到 JSON 对象转换的桥梁，这个方法中，根据 Chart 的属性和 JSON 文本的映射关系进行转换。这里给出 AbstractAxis 中的 buildJSON 方法：

1. public  JSONValue buildJSON()   
2.  {   
3.     JSONObject json =  new  JSONObject();   
4.          if  (stroke !=  null )    
5.             json.getValue().put(   
6.                  "stroke" ,    
7.                  new  JSONInteger(BigInteger.valueOf(stroke)));   
8.          if  (colour !=  null )    
9.             json.getValue().put( "colour" ,  new  JSONString(colour));   
10.          if  (gridColour !=  null )    
11.             json.getValue().put( "grid-colour" ,  new  JSONString(gridColour));   
12.          if  (steps !=  null )    
13.             json.getValue().put( "steps" ,  new  JSONInteger(BigInteger.valueOf(steps)));   
14.          if  (offset !=  null )    
15.             json.getValue().put( "offset" ,  new  JSONInteger(BigInteger.valueOf(offset)));   
16.          if  (zdepth3d !=  null )    
17.             json.getValue().put( "3d" ,  new  JSONInteger(BigInteger.valueOf(zdepth3d)));   
18.          if  (min !=  null )    
19.             json.getValue().put( "min" ,  new  JSONInteger(BigInteger.valueOf(min)));   
20.          if  (max !=  null )    
21.             json.getValue().put( "max" ,  new  JSONInteger(BigInteger.valueOf(max)));          
22.          return  json;   
23.  }   
24.     

 

JFreeChart，BIRT Chart 和 Open Flash Chart 是3种应用较多的图表绘制工具。这三种工具各有自身的优势。为了更好的对这3中图表绘制工具进行比较，我们基于 RCP 实现了这3种绘制工具对比的示例，下图给出了 Bar Chart 和 Area Chart 两种类型 chart 的对比。

JFreeChart 是一种基于 JAVA 语言的图表开发技术。 JFreeChart 可用于 Servlet，JSP，applet，Java Appication 环境中。 JFeeChart 中有 DataSet 这个数据集对象，提供了很强的数据处理的功能，并且还能对已经生成的图形进行调整和配置操作。

BIRT Chart 是基于 Eclipse 的开源报表工具。BIRT 可以产生 PNG, JPG, BMP, SVG 格式的图形，使得图形的使用范围很广泛。另外，BIRT 有很强的数据访问的功能，提供了 JDBC, XML, Web Services 和 Flat File 数据源处理的支持。

Open Flash Chart 是 Flash 图形报表工具。它最大的特点就是使用简单，图形美观，拥有很好的动态效果。对于 OFC2，它只需加载一个图形对应的 JSON 格式文本，就能在 Flash 中展示图形报表，可以通过修改 JSON 文本来改变图形的数据和展现效果。

Name	License	Latest Version	OSSC Review Level 1 in IBM
JFreeChart	LGPL	1.0.11	No
BIRT Chart	Eclipse Public License 1.0	2.3.1	Yes
Open Flash Chart	LGPL	2	No

参考资料

• 查看 Open Flash Chart 官方网站 。
  
• 下载 Open Flash Chart 2 。
  
• 查看 Google OFCGWT 项目 。
  
• 如何使用 Flash 控件请参考《Eclipse从入门到精通》第 2 版的访问 ActiveX 章节。
  
• 在 Windows 中使用 Active X 控件，请参考 BlogJava 上相关文章 。
  
• OleView.exe 来自 Windows 资源工具包“Windows Resource Kit Tools”，可以从 Windows 网站上下载。
  
• 查看 Introducing JSON 。
  
• 下载 Java JSON Tools 。
  
• 了解 JFreeChart
  
• Business Intelligence and Reporting Tools
  
• 在 Eclipse Plugin 中使用 BIRT Chart 。
  
• 访问 developerWorks 开放源码专区 获得丰富的 how-to 信息、工具和项目更新，帮助您用开放源码技术进行开发，并将它们结合 IBM 产品使用。
  
• 查看 IBM developerWorks 的 Eclipse 项目资源 ，提高您的 Eclipse 技巧。

作者简介

		邵兵，IBM 中国研究院供应链分析与优化研究组研究员，目前从事供应链流程分析与优化方面的研究与开发工作。对 Eclipse RCP 开发有深入的了解。

		韦景琪，东北大学软件学院学生，目前为 IBM 中国研究院供应链分析与优化研究实习生，从事业务流程建模、Web 服务、RCP 相关的研发。

		任常锐，IBM 中国研究院供应链分析与优化研究经理，目前从事供应链仿真与优化、业务流程分析等相关的研发工作。

		王芹华，IBM中国研究院供应链分析与优化研究员，目前从事供应链分析与优化、供应链系统实施等相关的研究工作。