java使用poi-tl自定义word模板导出

server/2025/1/17 7:04:07/

文章目录

概要
整体架构流程
创建word模板
核心代码
导出结果

概要

在软件开发领域，自定义Word模板的使用是导出格式化数据的一种常见做法。poi-tl（Apache POI Template Language）作为一款基于广受认可的Apache POI库的Word模板引擎，它以纯Java组件的形式提供服务，确保了跨平台的兼容性。poi-tl以其简洁高效的代码著称，不仅易于集成，还通过其插件机制实现了功能的高度可扩展性，允许开发者根据项目需求灵活定制。这一特性使得poi-tl成为处理Word文档生成任务时的一个强有力工具。

整体架构流程

官网：poi-tl

java"> <!--    POI 依赖 使用xlsx xml的格式(即XSSFWorkbook)   --><dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>5.2.2</version></dependency><dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>5.2.2</version></dependency><dependency><groupId>org.apache.poi</groupId><artifactId>poi-scratchpad</artifactId><version>3.17</version></dependency><!--     poi模板导入，主力包      --><dependency><groupId>com.deepoove</groupId><artifactId>poi-tl</artifactId><version>1.12.1</version></dependency>

创建word模板

核心代码

java">       try {String pictureUrl = "D:\\file\\test\\image\\bigPicture10.jpeg";if (pictureUrl != null && !pictureUrl.isEmpty()) {PictureRenderData picture = Pictures.ofLocal(pictureUrl).size(40, 30).create();finalMap.put("signPicture", picture);}} catch (Exception e) {e.printStackTrace();}// 从classpath加载Word模板文件到临时文件try (InputStream inputStream = TestWord.class.getClassLoader().getResourceAsStream("template.docx")) {if (inputStream == null) {throw new RuntimeException("无法找到模板文件：template.docx");}// 创建一个临时文件用于XWPFTemplate处理Path tempFilePath = Files.createTempFile("word-template-", ".docx");Files.copy(inputStream, tempFilePath, StandardCopyOption.REPLACE_EXISTING);// 使用临时文件作为模板File wordTemplate = tempFilePath.toFile();LoopRowTableRenderPolicy policy = new LoopRowTableRenderPolicy();Configure build = Configure.builder().bind(policy, "workList").build();XWPFTemplate render = XWPFTemplate.compile(wordTemplate, build).render(finalMap);// 定义输出路径String outputPath = "D:\\file\\htht\\project\\260\\开发\\output.docx"; // 修改为期望的输出文件路径File outputFile = new File(outputPath);try {if (!outputFile.getParentFile().exists()) {outputFile.getParentFile().mkdirs(); // 确保父目录存在}render.writeToFile(outputFile.getAbsolutePath());System.out.println("Word文档成功导出到: " + outputPath);} catch (IOException e) {throw new RuntimeException("无法写入文件: " + e.getMessage(), e);}// 删除临时文件（可选）Files.deleteIfExists(tempFilePath);} catch (IOException e) {throw new RuntimeException("读取模板文件失败: " + e.getMessage(), e);}