当前位置：首页 > news >正文

Springboot项目中使用EasyPOI方式导出合同word文档

news 2026/3/26 21:40:45

在Java开发中，使用EasyPOI导出Word合同文档是一种高效且灵活的解决方案。通过模板驱动的方式，开发者可以轻松地将动态数据填充到预设的Word模板中，生成格式规范的合同文件。这种方法特别适合需要批量生成标准化合同、协议或报告的场景。

1、需求

使用easyPOI方式导出合同word文档。

前几篇文章，我们注重讲了使用EasyPoi操作Excel文件的详细流程，使用Word模板和Excel模板用法基本一致，支持的标签也是一致的，仅仅**支持07版本的word**也是只能生成后缀是docx的文档，本文我们就拿docx做导出功能，

2、导入依赖

版本兼容性
确保使用EasyPOI 4.3.0及以上版本，旧版本可能不支持多图片循环导出等高级功能。同时注意Spring Boot版本与EasyPOI的兼容性：

<dependency><groupId>cn.afterturn</groupId><artifactId>easypoi-spring-boot-starter</artifactId><version>4.4.0</version></dependency>

3、模板指令

EasyPOI提供了丰富的模板指令，可以处理各种复杂的合同导出需求。掌握这些指令能让你的合同文档更加灵活和强大。
下面列举下EasyPoi支持的指令以及作用，最主要的就是各种fe的用法：

三元运算{{test ? obj:obj2}}n: 表示 这个cell是数值类型{{n:}}le: 代表长度{{le:()}}在if/else 运用{{le:()>8? obj1:obj2}}fd: 格式化时间{{fd:(obj;yyyy-MM-dd)}}fn: 格式化数字{{fn:(obj;###.00)}}fe: 遍历数据,创建row!fe: 遍历数据不创建row$fe:下移插入,把当前行,下面的行全部下移.size()行,然后插入#fe: 横向遍历v_fe: 横向遍历值!if: 删除当前列{{!if:(test)}}单引号表示常量值 ‘’ 比如’1’ 那么输出的就是1&NULL&空格&INDEX&表示循环中的序号,自动添加]]换行符 多行遍历导出 sum： 统计数据

指令	功能描述	合同应用示例
{{fe:resourceList }}	遍历列表数据创建行	合同条款列表、附件清单
{{fd:date;yyyy-MM-dd}}	格式化日期	合同签署日期、生效日期
{{fn:amount;.00}}	格式化数字	合同金额、违约金计算
{{if:condition}}	条件判断显示/隐藏	可选条款、特殊约定
{{}}	换行符	多行地址、条款换行

对于复杂的合同表格，可以使用{{fe:tableData}}指令动态生成多行数据。例如在合同附件清单中，可以通过遍历List数据自动生成表格行，每行包含附件名称、编号、页数等信息。

4、制作模板

根据上述的指令要求，我们制作模板如下：
把制作好的模板放入到项目中

5、代码实现

5.1、UserController

修改原来的导出合同的方法：

@GetMapping(value="/downloadContract",name="导出用户合同")publicvoiddownloadContract(Longid,HttpServletResponseresponse)throwsException{// userService.downloadContract(id,response);userService.downloadContractWithEasyPOI(id,response);}

5.2、IUserService

voiddownloadContractWithEasyPOI(Longid,HttpServletResponseresponse)throwsException;

5.3、UserServiceImpl

@OverridepublicvoiddownloadContractWithEasyPOI(Longid,HttpServletResponseresponse)throwsException{FilerootPath=newFile(ResourceUtils.getURL("classpath:").getPath());//SpringBoot项目获取根目录的方式FiletemplatePath=newFile(rootPath.getAbsolutePath(),"/word_template/contract_template2.docx");// 先获取导出word需要的数据Useruser=this.findById(id);// 把需要的数据放到map中，方便替换SimpleDateFormatsimpleDateFormat=newSimpleDateFormat("yyyy-MM-dd");Map<String,Object>params=newHashMap<String,Object>();params.put("userName",user.getUserName());params.put("hireDate",simpleDateFormat.format(user.getHireDate()));params.put("address",user.getAddress());// 下面是表格中需要的数据List<Map>resourceList=newArrayList<>();Map<String,Object>map=null;for(Resourceresource:user.getResourceList()){map=newHashMap<String,Object>();map.put("name",resource.getName());map.put("price",resource.getPrice());map.put("needReturn",resource.getNeedReturn());ImageEntityimage=newImageEntity();image.setHeight(64);image.setWidth(72);image.setUrl(rootPath.getPath()+"\\static"+resource.getPhoto());map.put("photo",image);resourceList.add(map);}// 把组建好的表格需要的数据放到大map中params.put("resourceList",resourceList);// 根据模板+数据 导出文档XWPFDocumentxwpfDocument=WordExportUtil.exportWord07(templatePath.getPath(),params);Stringfilename=user.getUserName()+"_合同.docx";// 设置文件的打开方式和mime类型ServletOutputStreamoutputStream=response.getOutputStream();response.setHeader("Content-Disposition","attachment;filename="+newString(filename.getBytes(),"ISO8859-1"));response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");xwpfDocument.write(outputStream);}

其中findById方法代码如下：

@OverridepublicUserfindById(Longid)throwsException{Useruser=userMapper.selectById(id);List<Resource>resources=resourceMapper.selectList(newQueryWrapper<Resource>().in("user_id",id));user.setResourceList(resources);returnuser;}