echarts 图表导出到 Word

本篇文章主要介绍使用 poi-tl Java 类库实现前端 echarts 图表导出到 Word 的详细步骤。

版本：Word：2019，poi-tl：1.10.5，poi：4.1.2

poi-tl 官方文档

引入依赖

注意：poi-tl 版本要和 poi 版本对应上

dependency>
     groupId>org.apache.poigroupId>
     artifactId>poiartifactId>
     version>4.1.2version>
dependency>
dependency>
    groupId>org.apache.poigroupId>
    artifactId>poi-ooxmlartifactId>
    version>4.1.2version>
dependency>
dependency>
    groupId>org.apache.poigroupId>
    artifactId>poi-scratchpadartifactId>
    version>4.1.2version>
dependency>
dependency>
    groupId>com.deepoovegroupId>
    artifactId>poi-tlartifactId>
    version>1.10.5version>
dependency>

实现

主要就是三个步骤：编译模板、渲染数据、输出到流。实际使用实现导出的有条形图、圆环图，堆积条形图、饼图和组合图（柱形 + 折线），熟悉了一个图表的实现流程，再参照官方文档，其他图表也很好实现。下面以实现导出条形图为例，介绍各个步骤的具体实现。

1. 先准备一个 Word 模板，在模板中插入一个条形图。在条形图上右键，选择 查看可选文字，在文本框中输入 {{chart}}，chart 可以理解为图表的 ID，后面渲染数据时会用到。保存文件，格式为 .doc 或者 .docx 都可以，然后放到项目的 templates 目录下即可。

2. 代码实现。代码不多，但是包含了实现的所有步骤。如需添加其他图表，可以参照官方文档，构建固表模型，再放入 map 中即可。

public void exportWord(HttpServletResponse response) {
    
    InputStream inputStream = null;
    try {
        inputStream = new ClassPathResource("templates/template.doc").getInputStream();
    } catch (IOException e) {
        logger.error("读取 Word 模板失败，原因为：{}",e.getMessage());
        throw new RuntimeException(e);
    }
    
    XWPFTemplate template = XWPFTemplate.compile(inputStream);
    
    ListData> dataList = xxxxx;
    
    ChartMultiSeriesRenderData chart = null;
    if (!CollectionUtils.isEmpty(dataList)){
        chart = Charts
            .ofMultiSeries("图表标题", dataList.stream()
                           .map(Data::getDataName)
                           .collect(Collectors.toList())
                           .toArray(new String[dataList.size()]))
            .addSeries("系列名称", dataList.stream()
                       .map(Data::getDataValue)
                       .collect(Collectors.toList())
                       .toArray(new Double[dataList.size()]))
            .create();
    }
    
    MapString,Object> dataMap = new HashMap>();
    dataMap.put("chart", chart); 
    
    template.render(dataMap);
    try {
        
        response.setHeader(HttpHeaders.CONTENT_TYPE, "application/vnd.openxmlformats-					officedocument.wordprocessingml.document;charset=UTF-8");
        response.setHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=" + fileName + ".doc");
        OutputStream outputStream = response.getOutputStream();
        template.writeAndClose(outputStream);
    } catch (Exception e){
        e.printStackTrace();
    }
}

注意

• 多参照官方文档，按照官方文档的步骤来即可
• poi-tl 和 poi 版本要对应，否则程序执行会报错
• 图表系列的值只能为 Number[] 类型