SSM框架集成导出Word文档功能 XDocReport +FreeMarker

网上有很多关于使用XDocReport导出Word的文章，都差不多试用了一下，也看了一些评论，发现实现功能的过程当中大家还是会出现各种问题。现在我来把我自己实现的过程说一下，顺便总结一下会出现的问题怎么样解决。

一、集成环境

目前我用的SSM框架是maven工程创建的，只要在pom.xml文件当中配置，自动下载到本地maven仓库即可。

<dependency><groupId>fr.opensagres.xdocreport</groupId><artifactId>fr.opensagres.xdocreport.core</artifactId><version>2.0.2</version>
</dependency>
<dependency><groupId>fr.opensagres.xdocreport</groupId><artifactId>fr.opensagres.xdocreport.document</artifactId><version>2.0.2</version>
</dependency>
<dependency><groupId>fr.opensagres.xdocreport</groupId><artifactId>fr.opensagres.xdocreport.template</artifactId><version>2.0.2</version>
</dependency>
<dependency><groupId>fr.opensagres.xdocreport</groupId><artifactId>fr.opensagres.xdocreport.document.docx</artifactId><version>2.0.2</version>
</dependency>
<dependency><groupId>fr.opensagres.xdocreport</groupId><artifactId>fr.opensagres.xdocreport.template.freemarker</artifactId><version>2.0.2</version>
</dependency>
<dependency><groupId>org.freemarker</groupId><artifactId>freemarker</artifactId><version>2.3.23</version>
</dependency>

目前我的项目里面已经集成了io和poi，如果需要的话也需要加上，我这里就不做赘述。

<dependency><groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.5</version>
</dependency>

二、制作模板

这里注意wps和office有点不同：

1、office编辑域的界面

2、wps编辑域的界面

三、编写代码

package com.alibaba.controller;import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;import com.fitech.jgbbvalidate.vo.Goods;import fr.opensagres.xdocreport.core.XDocReportException;
import fr.opensagres.xdocreport.document.IXDocReport;
import fr.opensagres.xdocreport.document.registry.XDocReportRegistry;
import fr.opensagres.xdocreport.template.IContext;
import fr.opensagres.xdocreport.template.TemplateEngineKind;
import fr.opensagres.xdocreport.template.formatter.FieldsMetadata;@RestController
public class ExportWordController {@GetMapping("jgbb/exportWord")public void generateWord() throws IOException, XDocReportException {//获取Word模板，模板存放路径在项目的resources目录下InputStream ins = new FileInputStream("D:\\123.docx");//注册xdocreport实例并加载FreeMarker模板引擎IXDocReport report = XDocReportRegistry.getRegistry().loadReport(ins,TemplateEngineKind.Freemarker);//创建xdocreport上下文对象IContext context = report.createContext();//创建要替换的文本变量context.put("city", "北京市");context.put("startDate", "2020-09-17");context.put("endDate", "2020-10-16");context.put("totCnt", "3638763");context.put("totAmt", "6521");context.put("onCnt", "2874036");context.put("onAmt", "4768");context.put("offCnt", "764727");context.put("offAmt", "1753");context.put("typeCnt", "36");List<Goods> goodsList = new ArrayList<Goods>();Goods goods1 = new Goods();goods1.setNum("1");goods1.setType("臭美毁肤");goods1.setSv("675512");goods1.setSa("589");goodsList.add(goods1);context.put("goods", goodsList);//创建字段元数据FieldsMetadata fm = report.createFieldsMetadata();//Word模板中的表格数据对应的集合类型fm.load("goods", Goods.class, true);//输出到本地目录FileOutputStream out = new FileOutputStream(new File("D://商品销售报表1.docx"));report.process(context, out);}}

代码上面我说两点我遇到的问题：

1、InputStream ins = this.getClass().getResourceAsStream("/模板.docx");有的博主会用到这个来获取word模板文档，模板存放路径在项目的resources目录下，这就会遇到找不到模板文档的情况，就会报错：

fr.opensagres.xdocreport.core.XDocReportException: Impossible to create report for the input stream. The report loader supports only [docx] files type.

所以我直接把模板文档放到了D盘，因为在实际项目部署也是在服务器上的。

InputStream ins = new FileInputStream("D:\\123.docx");

2、第二个问题就是：

在生成表格的时候因为设置的模板原因，在创建Goods对象的时候有int类型的也会报错，得把属性变成String就可以了。

public class Goods {String num;String type;String sv;String sa;public String getNum() {return num;}public void setNum(String num) {this.num = num;}public String getType() {return type;}public void setType(String type) {this.type = type;}public String getSv() {return sv;}public void setSv(String sv) {this.sv = sv;}public String getSa() {return sa;}public void setSa(String sa) {this.sa = sa;}
}

以上就是我在实现导出word文档的时候遇到的问题，希望对你们有所帮助，如果有什么问题可以私聊我，想要代码和模板文档也可以问我要！