poi-tl导出集合为空的时候填默认值

### poi-tl 导出空集合时设置默认值的方法 在使用 `poi-tl` 进行 Excel 或 Word 文件导出的过程中，如果遇到集合为空的情况，可以通过模板配置或者自定义逻辑来设置默认值。以下是实现这一功能的具体方法： #### 方法一：通过模板占位符设置默认值 `poi-tl` 支持在模板中直接定义占位符的行为。当绑定的数据源为空时，可以在模板中指定默认显示的内容。 ```java // Java代码示例：初始化数据模型并渲染模板 Map<String, Object> data = new HashMap<>(); data.put("list", Collections.emptyList()); // 绑定空集合 TemplateExportUtil.export("template.xlsx", data, "output.xlsx"); ``` 在模板文件中，可以这样定义占位符： - 如果 `{@list}` 是一个列表，在模板中可以直接写入如下内容作为默认值： ``` {#if list.isEmpty()} 默认提示：无数据可用。 {#else} {@list} <!-- 列表项 --> {#/if} ``` 上述方式利用了 FreeMarker 的语法结构[^4]，允许开发者灵活处理空集合场景。 --- #### 方法二：通过程序预处理数据 另一种更通用的方式是在程序层面预先判断集合是否为空，并为其填充默认值后再传递给 `poi-tl` 渲染引擎。 ```java List<String> defaultData = Arrays.asList("默认条目1", "默认条目2"); Map<String, Object> data = new HashMap<>(); List<?> originalList = fetchOriginalList(); // 获取实际业务数据 if (originalList == null || originalList.isEmpty()) { data.put("list", defaultData); // 替换为空集合时提供默认值 } else { data.put("list", originalList); } TemplateExportUtil.export("template.xlsx", data, "output.xlsx"); ``` 这种方式的优点在于无需修改模板即可适配多种情况，缺点是增加了少量的代码复杂度。 --- #### 方法三：扩展 `RenderPolicy` 对于更加复杂的场景，还可以通过自定义 `RenderPolicy` 来控制如何渲染空集合。例如： ```java public class CustomListRenderPolicy extends ListRenderPolicy { @Override public void render(Cell cell, FieldMetadata field, Object value, int relativeRowIndex) throws Exception { if (value instanceof Collection && ((Collection<?>) value).isEmpty()) { setValue(cell, "默认提示：无数据可用."); // 自定义默认值 } else { super.render(cell, field, value, relativeRowIndex); } } } ``` 随后注册该策略到 `poi-tl` 中： ```java PoiConfig config = PoiConfig.create() .registerRenderPolicy(new CustomListRenderPolicy()); TemplateExportConfiguration configuration = TemplateExportConfiguration.builder(config) . templateUrl("template.xlsx").build(); new DefaultExcelExporter(configuration).export(dataModel, outputStream); ``` 这种方法提供了最大的灵活性，适用于需要高度定制化的需求。 --- ### 总结 以上三种方法分别对应不同的开发需求和技术背景： 1. **模板占位符法**适合轻量级应用，推荐优先尝试； 2. **程序预处理法**适合已有大量模板无法频繁调整的情况下使用； 3. **自定义 RenderPolicy 法**则针对高复杂度、高性能要求的应用场景设计。 无论采用哪种方案，均能有效解决 `poi-tl` 在导出空集合时未定义行为的问题。 ---