poitl生成word图片

### 使用 POI-TL 插入图片到 Word 文档 POI-TL 是一种基于 Microsoft Word 的模板引擎，允许通过简单的占位符替换机制来动态生成复杂的 Word 文档。以下是关于如何使用 POI-TL 在 Word 文档中插入或生成图片的具体方法。 #### 准备工作 为了实现图片的插入功能，需要准备以下内容： 1. **Word 模板文件**：创建一个 `.docx` 文件作为模板，在其中定义用于插入图片的位置占位符 `{{imageKey}}`。 2. **依赖库**：确保项目中引入了 POI 和 POI-TL 的相关 Maven 或 Gradle 依赖项[^1]。 #### Java 实现代码 下面是一个完整的示例代码片段，展示如何利用 POI-TL 向 Word 中插入图片： ```java import cn.afterturn.easypoi.word.WordExportUtil; import cn.afterturn.easypoi.word.entity.params.ImageEntity; import org.apache.poi.xwpf.usermodel.XWPFDocument; import java.io.FileOutputStream; import java.util.HashMap; import java.util.Map; public class PoiTlImageExample { public static void main(String[] args) { Map<String, Object> dataMap = new HashMap<>(); // 创建 ImageEntity 对象并设置图片路径和大小参数 ImageEntity imageEntity = new ImageEntity(); imageEntity.setUrl("d:/example.jpg"); // 图片本地路径 imageEntity.setWidth(200); // 宽度（像素） imageEntity.setHeight(150); // 高度（像素） // 将 ImageEntity 放入数据映射表中 dataMap.put("imageKey", imageEntity); try { // 加载模板文件并渲染数据 XWPFTemplate template = XWPFTemplate.compile("d:/template.docx").render(dataMap); // 输出生成的文档至指定位置 FileOutputStream fos = new FileOutputStream("d:/output_with_image.docx"); template.write(fos); fos.flush(); fos.close(); template.close(); } catch (Exception e) { e.printStackTrace(); } } } ``` 上述代码展示了以下几个关键点： - 利用 `ImageEntity` 类封装图片的相关属性，如路径、宽度和高度[^2]。 - 数据模型中的键名 (`imageKey`) 必须与模板文件内的占位符一致。 - 调用了 `XWPFTemplate.compile()` 方法加载模板，并通过调用其 `render()` 方法完成数据填充。 #### 循环区域支持 如果需要在一个循环区域内多次插入不同图片，则可以借助列表结构传递多个 `ImageEntity` 对象给模板处理逻辑。例如： ```java List<ImageEntity> images = Arrays.asList( createImage("path/to/image1.png", 300, 200), createImage("path/to/image2.png", 400, 300) ); dataMap.put("images", images); ``` 此时模板应设计为如下形式以匹配多张图片的需求： ``` {{?images}} {{@item.url}} {{/images}} ``` 此部分涉及更高级的功能配置，请参考官方文档说明进一步学习[^3]。 ---