基于one2team框架的Highcharts图表图片导出方案

时间：2021-08-19 07:24:29

这篇文章已经没有什么意义了，新版的HIghcharts提供Java图片导出解决方案，你需要做的就是下个Maven，bulid一个war就Ok了。---addedy on 2012-11-15

多说一句废话：我觉得这个功能其实对于大多数应用场景来说是多余的。

Highcharts是一个纯JSWeb图表绘制解决方案，它的功能之丰富，使用之简单可能是目前开源领域排名比较考前的优秀解决方案，它对个人使用是免费的。

它的默认版本也有图片导出功能，不过导出服务器是Highcharts官方服务器，我开发的过程试了一下，好像特别慢，图片导出服务用自己的对商业用户来说也有“便利之处”。

官方的下载页面推荐的Java图片导出方案是one2team/highcharts-serverside-export，这个方案是基于apache的batik包的，也有人直接采用batik包开发了图片导出Servlet代码 (这个代码没好像没有解决中文问题)。我是比较轴的那种人，本来one2team和上面这个代码核心是一样，我还是研究了一下怎么使用这个官方推荐的导出框架。说实话，官方推荐的这个框架不是很好用，它采用JDK6的泛型特性，项目的编译器兼容性必须提高到1.6,否则编译会出错。其次这个框架的主HighchartsExporter类的功能是转换以Json数据或者Java语言对象为数据源的导出功能，而Highchart导出服务器是要转换Highchart图表post的SVG数据。所以需要对One2Team的框架稍加改造才能使用。One2team的框架的OO设计比较复杂，我就不画具体的UML图了。只列出需要引进的几个类：

首先继承SVGRendererInternal抽象类，重写callJavascript方法，这个方法的实际作用是把其他格式的数据源转换成SVG数据，我不是很明白为什么SVG数据生成非要在Java里面调用JavaScript来做，难道为了和浏览器的高度一致？，这个地方我们直接返回chartoption即可，这个chartoption在SVG源数据导出情况下就是SVG数据本书，所以无需处理，直接返回即可。

/**

 *

 */

package org.one2team.highcharts.server.export.util;  

import org.mozilla.javascript.ScriptableObject;

import org.one2team.highcharts.server.export.util.SVGRendererInternal;

import org.one2team.highcharts.shared.ChartOptions;  

/**

 * @author Dipolar

 *

 */

public class SVGRendererInternalSVG extends SVGRendererInternal<String> {

    @Override

    protected Object callJavascript (final String generalOptions, final String chartOptions) {

        //return ScriptableObject.callMethod (null, SCRIPTABLE, "renderSVGFromObject",  new Object [] {'(' + generalOptions + ')', chartOptions});

        return chartOptions;

    }

}

本来加这么一个类，导出图片就够了，我为了方便Servlet操作，我又模仿HighchartsExporter类重写了一个HttpHighchartsExporter类，代码如下：上面这两个类都放在了one2team的包类，因为涉及到的一些类是protected的，为了不改写人家的代码，所以只好放在人家的包里了。还有代码中的globalOptions参数可以省略不计，直接赋null即可，因为这个参数在实际转换中并没有用，实际转换中的globalOptions用的是一个框架本身预定义的常量。

package org.one2team.highcharts.server.export;

import java.io.File;

import java.io.FileNotFoundException;

import java.io.FileOutputStream;

import java.io.OutputStream;  

import org.apache.commons.io.IOUtils;

import org.one2team.highcharts.server.export.ExportType;

import org.one2team.highcharts.server.export.util.*;  

public class HttpHighchartsExporter<T> {  

    public HttpHighchartsExporter(ExportType type, SVGRendererInternal<T> internalRenderer) {

        this.type = type;

        this.renderer =

            new SVGStreamRenderer<T> (new SVGRenderer<T> (internalRenderer),

                                     type.getTranscoder ());

    }

    public HttpHighchartsExporter(ExportType type) {

        SVGRendererInternal svgRender=new SVGRendererInternalSVG();

        this.type = type;

        this.renderer =

            new SVGStreamRenderer<T> (new SVGRenderer<T> (svgRender),

                                     type.getTranscoder ());

    }  

    public void export (T chartOptions,

                            T globalOptions,

                            OutputStream out) {  

        OutputStream fos = null;

        try {

            fos = render (chartOptions, globalOptions, out);  

        } catch (Exception e) {

            e.printStackTrace ();

            throw (new RuntimeException (e));

        } finally {

            if (fos != null)

                IOUtils.closeQuietly (fos);

        }

    }  

    private OutputStream render (T chartOptions,

                                     T globalOptions,

                               OutputStream out) throws FileNotFoundException {  

        renderer.setChartOptions (chartOptions)

                    .setGlobalOptions (globalOptions)

                    .setOutputStream (out)

                    .render ();

        return out;

    }  

    public SVGStreamRenderer<T> getRenderer () {

        return renderer;

    }  

    public ExportType getType () {

        return type;

    }  

    private final SVGStreamRenderer<T> renderer;  

    private final ExportType type;

}

下面来一下真正的Servlet的 doPost的代码，这个代码虽然解决了jpg和png的中文乱码问题，但是没有解决SVG的导出的中文乱码问题，SVG导出采用svg2svgTranscoder的话，在框架内部的字体调用上出bug了，直接输出svg，不加OutputStreamWriter包装的情况下，chrome可以正常打开这个xml文件，但是中文是乱码)，IE8下在中文位置出问题，加了OutputStreamWriter包装器以后，Chrome下图片可以正常渲染但是报某元素属性值有问题，IE下报了另外一个错误。PDF的导出需要扩充下一下ExportType枚举，PDFTranscoder类也不在batik的包里在apache的fop项目里面，我尝试了一下报出Java堆空间不够的错误，我的生产服务器资源也有限，PDF导出功能就省略把。

public void doPost(HttpServletRequest request, HttpServletResponse response)

        throws ServletException, IOException {

     try{

         request.setCharacterEncoding("utf-8");//这一行解决了PNG、JPG的中文乱码问题。

         String filename=request.getParameter("filename");

         String type=request.getParameter("type");

         type=type.replace("svg+", "");

         MimeType mtype=new MimeType(type);

         response.addHeader("Content-Disposition", "attachment; filename="+ filename + "."+mtype.getSubType());

         response.addHeader("Content-Type", mtype.getBaseType()+"; charset=UTF-8");

         ServletOutputStream out=response.getOutputStream();

         String svg=request.getParameter("svg");

         if (mtype.getSubType().equals("xml")){

             //OutputStreamWriter writer = new OutputStreamWriter(out, "utf-8");

             //writer.write(svg);

         }else{

             HttpHighchartsExporter<String> httpExporter = new HttpHighchartsExporter<String> (Enum.valueOf(ExportType.class,mtype.getSubType()));

             httpExporter.export(svg,null,out);

         }

         out.flush();

         out.close();

     }catch(Exception e){

         e.printStackTrace();

     }  

}

结语：最后提示一下one2team虽然在做图片导出并不一定好，但是JSM系列类可以用来很方便地为前端生成图表绘制所需要的Json数据，当然这个Json数据可以你自己硬代码生成Json数据，但是既然有了与HighChart对象一一对象的Java类，为什么不用一下哪？

相关文章