poi-tl表格行循环嵌套LIST

### 使用 POI-TL 导出带有循环表格的 Word 文档 为了实现这一目标，可以利用 `poi-tl` 库的强大功能来处理复杂的 Word 文档生成任务。具体来说，在创建包含循环表格的文档时，关键是定义好模板并合理设置占位符。 #### 定义模板文件 首先准备一个 `.docx` 文件作为模板，其中应预先设计好表格结构，并在适当位置插入特定标记用于后续替换。对于需要重复的部分，建议采用自定义标签形式表示，比如 `${row}` 或其他不易冲突的独特字符串[^1]。 #### 编写 Java 代码逻辑 接下来通过编写程序读取上述模板并对指定区域执行批量操作： ```java import com.deepoove.poi.XWPFTemplate; import com.deepoove.poi.data.RowRenderData; import com.deepoove.poi.data.TableRenderData; import java.io.FileOutputStream; import java.util.ArrayList; import java.util.List; public class ExportWordWithLoopTable { public static void main(String[] args) throws Exception { List<RowRenderData> rows = new ArrayList<>(); // 假设这里是获取实际数据的地方... for (int i = 0; i < 5; ++i){ RowRenderData row = RowRenderData.build( "Cell A" + i, "Cell B" + i, "Cell C" + i); rows.add(row); } TableRenderData table = new TableRenderData(rows); XWPFTemplate template = XWPFTemplate.compile("path/to/template.docx").render(Map.of("table", table)); try(FileOutputStream out = new FileOutputStream("output.docx")) { template.write(out); } finally { template.close(); } } } ``` 这段代码展示了如何构建表格行对象列表以及将其封装成 `TableRenderData` 实例传递给渲染引擎完成最终输出[^2]。 值得注意的是，当涉及到更复杂的场景如嵌套循环或者单元格内含有图片等内容时，则需进一步细化每一行的数据模型，可能要用到更多高级特性，例如 `BlockRenderData` 来支持多样的内容组合[^3]。

### 使用 poi-tl 实现多层循环的操作 在使用 `poi-tl` 进行 Word 文档生成时，支持通过模板中的占位符来实现复杂的多层循环逻辑。以下是关于如何利用 `poi-tl` 完成多层循环的具体说明以及示例代码。 #### 1. 模板设计 为了实现多层循环，需要在模板中定义清晰的结构化占位符。例如： ```html {{?xxxList}} <w:tbl> {{#list xxxList as listKey}} <w:tr> <!-- 表格头 --> <w:tc><w:p>{{listKey.name}}</w:p></w:tc> </w:tr> {{?listKey.aaaaList}} {{#list listKey.aaaaList as act}} <w:tr> <w:tc><w:p>{{act.detail}}</w:p></w:tc> </w:tr> {{/list}} {{/if}} {{/list}} </w:tbl> {{/if}} ``` 此模板展示了两层嵌套循环的设计方式[^1]。外部循环遍历 `xxxList` 列表，内部则进一步迭代其子属性 `aaaaList` 的每一项。 #### 2. Java 示例代码 下面是一个完整的 Java 示例代码片段，用于演示如何加载模板并填充数据完成多层循环渲染。 ```java import com.deepoove.poi.XWPFTemplate; import com.deepoove.poi.data.TableRenderData; import com.deepoove.poi.data.TextRenderData; import java.io.FileOutputStream; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; public class PoiTLMultiLoopExample { public static void main(String[] args) throws Exception { // 准备数据模型 Map<String, Object> dataModel = new HashMap<>(); List<Map<String, Object>> outerList = new ArrayList<>(); for (int i = 0; i < 3; i++) { // 创建外层列表 Map<String, Object> outerItem = new HashMap<>(); outerItem.put("name", "Outer Item " + i); List<Map<String, String>> innerList = new ArrayList<>(); for (int j = 0; j < 2; j++) { // 创建内层列表 Map<String, String> innerItem = new HashMap<>(); innerItem.put("detail", "Inner Detail (" + i + "," + j + ")"); innerList.add(innerItem); } outerItem.put("aaaaList", innerList); // 将内层列表放入外层项目 outerList.add(outerItem); } dataModel.put("xxxList", outerList); // 加载模板文件 XWPFTemplate template = XWPFTemplate.compile("template.docx").render(dataModel); // 输出到目标文件 try (FileOutputStream out = new FileOutputStream("output.docx")) { template.write(out); } } } ``` 这段代码实现了以下功能： - 构建了一个包含三层嵌套的数据模型。 - 数据被传递给 `XWPFTemplate` 并渲染至指定模板。 - 渲染后的结果保存为新的 `.docx` 文件[^4]。 #### 关键点解析 - **外层循环**：由 `{{#list xxxList as listKey}}` 控制，每次迭代都会获取当前对象及其属性。 - **内层循环**：在外层循环的基础上访问子集合 `listKey.aaaaList`，并通过 `{{#list ... }}` 继续执行下一层级的迭代[^3]。 - **条件判断**：可以加入简单的条件控制语句（如 `{{?...}}`），以便根据实际情况决定是否显示某些部分。 --- ###