Easypoi进阶：实现一对多数据导出与智能行高适配

1. 为什么需要一对多数据导出与智能行高适配在日常开发中我们经常遇到需要将数据库中的一对多关系数据导出到Excel的场景。比如一个订单对应多个商品一个项目包含多个任务一个学生有多门课程成绩等。传统的导出方式往往会导致数据展示混乱要么是主表信息重复显示要么是子表数据无法正确关联。我最近在做一个项目管理系统的导出功能时就遇到了这个问题。系统需要导出项目详情每个项目下包含多个任务每个任务又包含多个操作步骤。最初使用简单的导出方式结果导出的Excel中项目名称重复显示任务信息也无法与项目对应用户体验非常差。更麻烦的是当单元格内容较长时比如操作步骤描述Excel默认的行高会导致文字显示不全。用户要么手动调整行高要么忍受被截断的文字。这个问题在导出操作日志、长文本备注等场景尤为突出。Easypoi作为一款优秀的Java导出工具提供了ExcelCollection注解来处理一对多关系通过needMerge属性可以合并相同内容的单元格。但对于行高自适应官方文档并没有详细说明。经过多次尝试我总结出一套可行的解决方案下面分享具体实现方法。2. 基础环境搭建与实体类设计2.1 引入Easypoi依赖首先需要在项目中引入Easypoi的Spring Boot Starter依赖。我推荐使用4.1.3版本这个版本比较稳定API也相对完善dependency groupIdcn.afterturn/groupId artifactIdeasypoi-spring-boot-starter/artifactId version4.1.3/version /dependency2.2 设计实体类结构实体类的设计是一对多导出的核心。我们需要使用ExcelCollection注解标记子集合用Excel注解配置字段的导出属性。以下是我在实际项目中使用的三层嵌套结构Data public class TestExportMainVo { Excel(name 项目, width 20, needMerge true) private String project; ExcelCollection(name ) private ListTestExportSub1Vo sub1VoList; // 构造方法省略 } Data public class TestExportSub1Vo { Excel(name 序号, width 8, needMerge true) private String sort; Excel(name 依据, width 30, needMerge true) private String basis; ExcelCollection(name ) private ListTestExportSub2Vo sub2VoList; // 构造方法省略 } Data public class TestExportSub2Vo { Excel(name 操作步骤, width 60) private String step; Excel(name 条款, width 12) private String clause; // 构造方法省略 }关键点说明needMerge true会让相同内容的单元格自动合并ExcelCollection的name属性设为空字符串可以隐藏子表的表头width属性建议根据字段内容长度合理设置避免列宽不合适3. 自定义样式工具类实现3.1 创建ExcelExportStylerUitlEasypoi允许通过实现IExcelExportStyler接口来自定义样式。我创建了ExcelExportStylerUitl类来统一管理表格样式public class ExcelExportStylerUitl implements IExcelExportStyler { private static final short STRING_FORMAT (short) BuiltinFormats.getBuiltinFormat(TEXT); private CellStyle headerStyle; // 大标题样式 private CellStyle titleStyle; // 列标题样式 private CellStyle styles; // 数据行样式 public ExcelExportStylerUitl(Workbook workbook) { this.init(workbook); } private void init(Workbook workbook) { this.headerStyle initHeaderStyle(workbook); this.titleStyle initTitleStyle(workbook); this.styles initStyles(workbook); } // 其他方法实现... }3.2 设置基础样式在工具类中我设置了以下通用样式规则统一的边框样式细线边框内容水平和垂直居中自动换行关键根据内容设置合适的字体大小private CellStyle getBaseCellStyle(Workbook workbook) { CellStyle style workbook.createCellStyle(); // 设置四周边框 style.setBorderBottom(BorderStyle.THIN); style.setBorderLeft(BorderStyle.THIN); style.setBorderTop(BorderStyle.THIN); style.setBorderRight(BorderStyle.THIN); // 设置对齐方式 style.setAlignment(HorizontalAlignment.CENTER); style.setVerticalAlignment(VerticalAlignment.CENTER); // 关键设置自动换行 style.setWrapText(true); return style; }4. 智能行高适配方案4.1 行高计算逻辑行高适配的核心是根据单元格内容的长度动态计算合适的行高。我的实现思路是获取行中最长内容的单元格计算内容长度与基准长度的比值根据比值设置行高倍数private static void setRowHeight(Row row) { int maxLength 0; for(int j 0; j row.getPhysicalNumberOfCells(); j) { int cellLength row.getCell(j).toString().length(); if (cellLength maxLength) { maxLength cellLength; } } // 基准行高35磅 row.setHeightInPoints(35); // 内容过长时调整行高 if(maxLength 35) { float ratio maxLength / 35f; float newHeight 35 * ratio; row.setHeightInPoints(newHeight); } }4.2 在导出工具类中应用在导出工具类中我们需要根据参数决定是否启用行高适配public static void exportExcel(List? list, String title, String sheetName, Class? pojoClass, String fileName, boolean setRowHeight, HttpServletResponse response) { ExportParams exportParams new ExportParams(title, sheetName); exportParams.setStyle(ExcelExportStylerUitl.class); Workbook workbook ExcelExportUtil.exportExcel(exportParams, pojoClass, list); if(setRowHeight workbook ! null) { Sheet sheet workbook.getSheetAt(0); for(int i 0; i sheet.getLastRowNum(); i) { Row row sheet.getRow(i); setRowHeight(row); } } downLoadExcel(fileName, response, workbook); }5. 实际应用中的优化技巧5.1 处理表头行高在实践中发现表头行标题行和列头行需要特殊处理。我通常这样设置// 在setRowHeight方法中添加特殊处理 if (i 0) { // 标题行 row.setHeightInPoints(35); } else if (i 1) { // 列头行 row.setHeightInPoints(25); } else { // 数据行 setRowHeight(row); }5.2 处理列宽问题有时候在实体类中设置的width属性不生效这时需要在导出时强制设置// 强制设置第4列宽度为60字符 sheet.setColumnWidth(3, 60 * 256);5.3 性能优化建议当导出数据量很大时超过1万行行高计算可能会影响性能。可以考虑对超长内容进行截断处理设置行高调整的上限分批处理数据// 设置行高上限 if(newHeight 100) { newHeight 100; } row.setHeightInPoints(newHeight);6. 完整工具类代码以下是整合了所有功能的完整工具类public class ExcelUtil { public static void exportExcel(List? list, String title, String sheetName, Class? pojoClass, String fileName, boolean setRowHeight, HttpServletResponse response) { ExportParams exportParams new ExportParams(title, sheetName); exportParams.setStyle(ExcelExportStylerUitl.class); Workbook workbook ExcelExportUtil.exportExcel(exportParams, pojoClass, list); if(workbook ! null) { Sheet sheet workbook.getSheetAt(0); // 强制设置列宽 sheet.setColumnWidth(3, 60 * 256); if(setRowHeight) { for(int i 0; i sheet.getLastRowNum(); i) { Row row sheet.getRow(i); if(i 0) { row.setHeightInPoints(35); } else if(i 1) { row.setHeightInPoints(25); } else { setRowHeight(row); } } } } downLoadExcel(fileName, response, workbook); } // 其他方法保持不变... }7. 效果对比与总结通过实际项目验证这套方案解决了以下问题一对多数据展示混乱的问题 - 通过ExcelCollection和needMerge实现长文本显示不全的问题 - 通过自动换行和动态行高解决表格美观度问题 - 统一样式让导出文件更专业在最近的一个项目中使用这套方案导出的Excel文件获得了客户的高度认可。特别是操作日志这类包含长文本的导出场景不再需要用户手动调整行高大大提升了用户体验。对于更复杂的导出需求比如动态列、多sheet页等Easypoi也提供了相应的支持。后续我会继续分享这方面的实践经验。如果你在实现过程中遇到问题建议多查看Easypoi的源码里面有很多实用的设计思路值得学习。