FusionCharts J2EE 导出

一、FusionCharts J2EE 导出处理程序包
==================================

1、FusionCharts J2EE 导出处理程序包是什么?

  FusionCharts Suite XT 采用 JavaScript 来在浏览器中生成图表,采用 SVG 和 VML(针对老版的 IE)。若要导出图表为图片或PDF文件,就需要服务器端辅助类库来将 SVG 转换为图片或PDF文件。这些导出处理程序包能从 FusionCharts 图表提取 SVG 并完成相应的转换。

2、该导出处理程序包是如何运行的?

  - 图表在浏览器中产生,当【导出为图片或PDF】按钮被点击时,该图表便会生成 SVG 字符串来呈现给当前状态并将其发送给导出处理程序包。该包的 URL 经  由图表属性配置而得。
  - 导出处理程序包根据图表配置(诸如图表类型、宽度、高度等)接受该 SVG 字符串,并用 InkScape 与 ImageMagick 库来将其格式转换为图片或PDF。
  - 导出处理程序包要么基于由图表提供的配置项对磁盘执行图片或PDF的写入操作,要么将其回流给浏览器。

二、版本
=======

  1.0

三、必备要求
============

1、Inkscape:

  Inkscape 是一款开源矢量图像编辑器。它与众不同之处在于将可绽放矢量图像(一种基于XML的开放式 W3C 标准化)用作其原生格式。Inkscape 具备强大的命令行工具接口,且可被用在执行大批量任务(诸如导出和格式转换)的脚本中。详情参见以下网页:
  http://inkscape.org/doc/inkscape-man.html


2、ImageMagick:

  ImageMagick 是一款免费开源软件套件,能够显示、转换并编辑光栅图像和矢量图像文件。该软件主要由一些操纵图像的命令行接口工具组成。详情参见以下网页:
  http://www.imagemagick.org/

四、安装
============

*  首先你得有一台 Windows 或 Linux 服务器,以管理员身份来安装软件。如果用的是共享主机服务的话,这一点就尤为重要。
*  两款必备软件 Inkscape 和 ImageMagick 均需安装,以便整个系统正常运行。请访问各自的网站,并根据以下操作指南进行安装。
*  编辑 web.xml 并在应用的 web.xml 中添加以下 servlet 映射:

	FCExporter
	FCExporter
	com.fusioncharts.exporter.servlet.FCExporter
	1


	FCExporter
	/JSP/ExportExample/FCExporter

*  按需对 URL-pattern 进行适当修改。
*  假设 jsp 渲染图表存在于 /JSP/ExportExample 文件夹中,则指定 exportHandler='FCExporter' 这一项 xml 属性。
*  要配置所生成图像要被保存到服务器的文件夹,在类目录下的 fusioncharts_export.properties 属性文件中进行。
*  配置 Inkscape 和 ImageMagick 这两款必备软件的路径(仅对 Windows 有效):打开类目录下提供的 fusioncharts_export.properties 属性文件并修改为以下值:

********************************fusioncharts_export.properties***********************************
#请确认对路径指向的文件夹拥有 WEB 应用根相对目录的写权限。
#导出的 图像/PDF 文件会被保存在此位置(对于 Linux 服务器来说 SAVEPATH 需相应被变更为相对或绝对路径)
SAVEPATH=/JSP/ExportExample/ExportedImages/

#持久化 HTTP_URI 存储 HTTP 指明的即将保存导出图表的文件夹。
#请输入请文件夹的 HTTP 代理在该持久项中,例如:http://www.yourdomain.com/images/
HTTP_URI=http://localhost:8081/ExportHandler/JSP/ExportExample/ExportedImages/

#设置了 OVERWRITEFILE 项为真后,导出处理程序包在创建新的导出的时会覆盖旧有文件;若将其设置为假,则导出文件不会覆盖。
#在此情形下,如果 INTELLIGENTFILENAMING 项被设置为真,则导出处理程序包会添加一个后缀(随机生成的 UUID)给新文件名。
#另外,也可添加时间戳或随机数作为附加前缀。
FILESUFFIXFORMAT=TIMESTAMP
OVERWRITEFILE=false
INTELLIGENTFILENAMING=true

#在此设置 Inkscape 的路径(仅对 Windows 有效)
INKSCAPE_PATH=C:\\_Prog\\Inkscape-0.91

#在此设置 ImageMagick 的路径(仅对 Windows 有效)
IMAGEMAGICK_PATH=C:\\_Prog\\ImageMagick-7.0.0-0-Q16
***********************************************************************************************

五、许可证
-------

  FUSIONCHARTS:

  版权所有 (c) FusionCharts 科技有限责任合伙公司
  许可信息位于 http://www.fusioncharts.com/license

六、已知问题、局限性:
---------------------------

*  当我们导出一个 SVG 文件时,该文件在浏览器中能正确渲染,但在其他图像软件中的渲染或有不足。
*  如果图表使用了外部图片作为其标识、背景或锚记,导出图片时将会无法获取该外部图片。
*  整个系统专为基于 Windows 或 Linux 的服务器而配置。