poi-tl如何动态生成好几个表格

### 如何使用 Poi-tl 动态生成多个表格 要通过 `poi-tl` 实现动态生成多个表格的功能，可以利用其强大的模板渲染能力以及自定义策略来完成。以下是详细的解决方案： #### 1. 多表格生成的核心逻辑 在 `poi-tl` 中，可以通过绑定不同的数据集合到同一个文档的不同占位符位置，从而实现多个表格的动态生成。具体来说，需要为每一个表格创建独立的数据结构并将其映射至对应的模板区域。 对于多表格场景，推荐使用 `LoopRowTableRenderPolicy` 插件，并结合 Spring EL 表达式支持复杂的条件判断和循环操作[^1]。 --- #### 2. 示例代码展示 以下是一个完整的示例代码片段，演示如何通过 `poi-tl` 动态生成两个不同内容的表格： ```java import cn.afterturn.easypoi.word.template.XWPFTemplate; import cn.afterturn.easypoi.word.util.Configure; import cn.afterturn.easypoi.word.entity.params.LoopRowTableRenderData; import java.io.InputStream; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; public class MultiTableExample { @Test @SneakyThrows public void generateMultipleTables() { // 加载 Word 模板文件 InputStream templateStream = getClass().getClassLoader() .getResourceAsStream("template/MultiTableTemplate.docx"); if (templateStream == null) { throw new RuntimeException("无法加载模板文件！"); } // 定义第一个表格的数据集 List<Map<String, Object>> tableOneData = new ArrayList<>(); Map<String, Object> rowData1 = new HashMap<>(); rowData1.put("name", "张三"); rowData1.put("age", 28); tableOneData.add(rowData1); Map<String, Object> rowData2 = new HashMap<>(); rowData2.put("name", "李四"); rowData2.put("age", 30); tableOneData.add(rowData2); // 将第一个表格封装成 Render 数据 LoopRowTableRenderData tableOneRenderData = new LoopRowTableRenderData(tableOneData); // 定义第二个表格的数据集 List<Map<String, Object>> tableTwoData = new ArrayList<>(); Map<String, Object> secondRowData1 = new HashMap<>(); secondRowData1.put("productName", "苹果手机"); secondRowData1.put("price", 6999); tableTwoData.add(secondRowData1); Map<String, Object> secondRowData2 = new HashMap<>(); secondRowData2.put("productName", "华为电脑"); secondRowData2.put("price", 7999); tableTwoData.add(secondRowData2); // 将第二个表格封装成 Render 数据 LoopRowTableRenderData tableTwoRenderData = new LoopRowTableRenderData(tableTwoData); // 配置渲染器 Configure configure = Configure.builder() .useSpringEL() // 使用 Spring EL 支持复杂表达式 .bind("tableOne", tableOneRenderData) // 绑定第一个表格 .bind("tableTwo", tableTwoRenderData) // 绑定第二个表格 .build(); // 编译模板并渲染数据 XWPFTemplate.compile(templateStream, configure) .render(null) // 如果有额外全局变量可传入此处 .writeToFile("output/generatedDocument.docx"); System.out.println("文档已成功生成！"); } } ``` --- #### 3. 关键点说明 - **模板设计** 在 `.docx` 文件中，需预先设置好两处或多处用于放置表格的位置，并分别命名为 `${tableOne}` 和 `${tableTwo}` 等唯一标识名。这些名称会作为绑定的关键字，在程序运行时被替换为实际数据[^1]。 - **数据准备** 对于每个表格，都需要构建一个单独的 `List<Map<String, Object>>` 结构体存储对应列字段及其值的关系。随后调用 `LoopRowTableRenderData` 方法将列表转换为适合渲染的形式。 - **配置绑定** 利用 `Configure.builder()` 的链式方法依次指定各个占位符所关联的具体数据源。此过程决定了最终输出文档中的布局效果。 --- #### 4. 常见注意事项 - 若某些单元格存在跨行或跨列的情况，则可能需要调整原始 Excel 或者手动修改生成后的 DOCX 文件样式。 - 当前版本仅适用于简单的纯文本填充；如果涉及图片嵌套或其他高级功能，请查阅官方扩展指南进一步学习[^1]。 ---