利用poi-tl循环插入图片

<think>好的，我现在需要帮助用户解决如何使用poi-tl库循环插入多张图片的问题。用户之前可能已经了解过poi-tl的基础用法，现在需要更具体的循环插入图片的示例。首先，我应该回忆一下poi-tl的文档和相关引用内容。 根据引用[3]和[4]，用户提到了循环插入图片和文字说明的需求，并且提供了依赖配置。引用[1]中的代码展示了如何获取图片的宽高比例，并生成PictureRenderData对象，这可能对调整图片尺寸有帮助。 接下来，我需要确定如何在模板中设置循环标签。poi-tl的循环语法通常是使用{{#list}}和{{/list}}包裹区域，然后在数据模型中提供对应的列表。每个列表元素中的变量可以在循环体内使用。 例如，用户需要在Word模板中创建一个循环块，其中包含图片和文字说明。模板可能如下所示： {{#images}} 图片：{{@image}} 说明：{{description}} {{/images}} 在Java代码中，需要构造一个包含多个图片和描述的列表，然后将这个列表作为数据模型传入。每个列表元素应包含图片的PictureRenderData和对应的描述文本。 需要注意的是，PictureRenderData需要指定宽度、高度、类型和图片数据。引用[1]中的代码展示了如何根据原图比例计算高度，保持图片不变形。这可能是一个重要的点，用户可能希望图片按比例缩放，避免拉伸。 因此，在生成PictureRenderData时，应该读取每张图片的实际尺寸，然后根据设定的宽度（比如600）计算相应的高度，保持宽高比。这一步可能需要使用ImageIO读取图片的BufferedImage，然后获取原始宽度和高度，进行计算。 然后，将处理后的图片数据和描述组成对象列表，放入数据模型中。使用LoopRowRenderData或者普通的列表结构，具体取决于模板标签的定义。 最后，调用poi-tl的API渲染模板并生成最终的Word文档。需要确保所有依赖正确，尤其是poi-tl的版本，如引用[4]中提到的1.10.0。 可能遇到的问题包括：图片路径错误、标签未正确闭合、循环结构的数据模型不正确等。需要提醒用户检查这些方面，确保模板标签与数据模型中的键对应，图片路径有效，以及正确处理异常情况。 总结步骤： 1. 准备Word模板，定义循环区域和图片、文本标签。 2. 读取所有图片文件，生成对应的PictureRenderData，保持宽高比。 3. 构建包含图片和描述的数据列表。 4. 将列表放入数据模型，绑定到模板的循环标签。 5. 渲染并生成Word文档。 需要提供具体的代码示例，包括模板结构、Java代码中的数据准备和渲染过程。同时，引用相关的引用内容，特别是处理图片比例的部分，确保用户能够正确应用这些方法。</think>以下是使用poi-tl循环插入多张图片的完整实现方案： ### 一、Word模板准备 创建包含循环结构的标签： ```text {{#images}} 图片：{{@img}} 描述：{{desc}} {{/images}} ``` *注：`{{#images}}`和`{{/images}}`定义循环区域，`{{@img}}`表示图片占位符，`{{desc}}`为文本描述* ### 二、Java代码实现 ```java // 根据引用[4]添加依赖 public class ImageLoopExample { public static void main(String[] args) throws Exception { // 1.准备模板路径 String templatePath = "template.docx"; String outputPath = "output.docx"; // 2.构建图片数据列表（参考引用[1]处理图片比例） List<Map<String, Object>> imageList = new ArrayList<>(); String[] imagePaths = { "img1.jpg", "img2.png", "img3.bmp" }; String[] descriptions = { "产品图1", "设计图2", "示意图3" }; for (int i = 0; i < imagePaths.length; i++) { Map<String, Object> data = new HashMap<>(); // 处理图片数据（引用[1]的比例计算逻辑） File picture = new File(imagePaths[i]); BufferedImage sourceImg = ImageIO.read(picture); int targetWidth = 600; int targetHeight = (sourceImg.getHeight() * targetWidth) / sourceImg.getWidth(); byte[] imageBytes = FileUtils.readFileToByteArray(picture); data.put("img", new PictureRenderData( targetWidth, targetHeight, FilenameUtils.getExtension(picture.getName()), imageBytes )); data.put("desc", descriptions[i]); imageList.add(data); } // 3.构造数据模型（参考引用[3]的Map结构） Map<String, Object> datas = new HashMap<>(); datas.put("images", imageList); // 4.渲染文档 XWPFTemplate template = XWPFTemplate.compile(templatePath).render(datas); template.writeToFile(outputPath); template.close(); } } ``` ### 三、关键实现说明 1. **图片比例处理**：通过`BufferedImage`读取原始尺寸，按目标宽度600px自动计算高度[^1] 2. **循环数据结构**：每个列表元素包含`img`(图片数据)和`desc`(描述文本) 3. **文件格式支持**：兼容JPG/PNG/BMP等常见格式（由`ImageIO`支持）