虽然 Apache POI 是非常强大的针对 Microsoft Office 读写的工具，但是其太过于复杂，往往不太好编写代码，且编写出的代码不宜维护(也可能只是网上大家分享的代码大多都不好好整理的原因)。所以在导出读取 Excel 方面有阿里简化后的 easyexcel 可供使用，关于导出 word 我们可以使用 freemarker 模板引擎。

1、在 springboot 项目中添加 freemarker 的依赖

org.springframework.boot

spring-boot-starter-freemarker

2、使用 word 做一个你需要的文件模板，并将其中需要改变的部分编程变量(注：图片建议先贴上大小相等的其他图片)，类似下面：

test.docx

3、制作完成之后，将其另存为xml格式

test.docx 转存 xml 格式

4、将转存的 xml 文件使用文本编辑器例如 notepad++ 等打开，将其中红色区域的删除掉，那些是图片的base64编码后的信息，然后替换为一个图片变量，传入新的图片的 base64 编码即可导出你所要的图片，一般来说导出的图片都是由前台 echarts 等工具生成的。

test.xml

改图片变量

5、导出列表的话还需要在 xml 中找到

，在其前加入 (注意第一个list 不能变，第二个list 为变量名，第三个list 为别名)，和 后加入 #list> ，此外需将 name 改成 list.name，gender 改成 list.gender 。

6、复制 xml 粘贴至项目文件中，并将后缀名更改为 .ftl

test.ftl

7、编写导出 Word 工具类

@Slf4j

public class ExportWordUtil {

private Configuration config;

public ExportWordUtil() {

config = new Configuration(DEFAULT_INCOMPATIBLE_IMPROVEMENTS);

config.setDefaultEncoding("utf-8");

}

/**

* FreeMarker生成Word

* @param dataMap 数据

* @param templateName 模板名

* @param response HttpServletResponse

* @param fileName 导出的word文件名

*/

public void exportWord(Map dataMap, String templateName, HttpServletResponse response, String fileName) {

//加载模板(路径)数据，也可使用setServletContextForTemplateLoading()方法放入到web文件夹下

config.setClassForTemplateLoading(this.getClass(), "/templates");

//设置异常处理器 这样的话 即使没有属性也不会出错 如：${list.name}...不会报错

config.setTemplateExceptionHandler(TemplateExceptionHandler.IGNORE_HANDLER);

try {

if(templateName.endsWith(".ftl")) {

templateName = templateName.substring(0, templateName.indexOf(".ftl"));

}

Template template = config.getTemplate(templateName + ".ftl");

response.setContentType("application/msword");

response.setHeader("Content-disposition", "attachment;filename="+ URLEncoder.encode(fileName, StandardCharsets.UTF_8));

OutputStream outputStream = response.getOutputStream();

Writer out = new BufferedWriter(new OutputStreamWriter(outputStream));

//将模板中的预先的代码替换为数据

template.process(dataMap, out);

log.info("由模板文件：" + templateName + ".ftl" + " 生成Word文件 " + fileName + " 成功！！");

out.flush();

} catch (TemplateNotFoundException e) {

log.info("模板文件未找到");

e.printStackTrace();

} catch (MalformedTemplateNameException e) {

log.info("模板类型不正确");

e.printStackTrace();

} catch (TemplateException e) {

log.info("填充模板时异常");

e.printStackTrace();

} catch (IOException e) {

log.info("IO异常");

e.printStackTrace();

}

}

}

8、编写简单的Controller方法

@RestController

public class Controller {

/**

* @param image 注意该image参数为前台传过来图片

*/

@PostMapping("/exportWord")

public void exportWord(HttpServletResponse response, @RequestParam("image") MultipartFile image){

ExportWordUtil ewUtil = new ExportWordUtil();

Map dataMap = new HashMap<>();

dataMap.put("title", "荒野大镖客2人物");

Base64.Encoder base64 = Base64.getEncoder();

try {

dataMap.put("image", base64.encodeToString(image.getBytes()));

} catch (Exception e){

}

List userList = new ArrayList<>();

userList.add(new User("亚当·摩根","男"));

userList.add(new User("达奇","男"));

userList.add(new User("阿比盖尔·马斯顿","女"));

dataMap.put("list", userList);

ewUtil.exportWord(dataMap, "test.ftl", response, "荒野大镖客2人物.doc");

}

}

9、application.yml 中设置下 size，防止图片的字节数过大

spring:

servlet:

multipart:

max-file-size: 1024MB

max-request-size: 1024MB

10、启动项目，传入某个图片进行测试【注意：尽量前台直接传图片，而不是传图片的 base64 编码的字符串，这可能导致 word 中图片显示不完整】

导出的 word

参考如下：