easypoi 导出多级表头

### 使用 Easypoi 实现带多级表头的 Excel 导出

为了实现带有多个层级表头的 Excel 文件导出，可以利用 `Easypoi` 提供的强大功能来简化这一过程。以下是具体的操作指南和示例代码。

#### 准备工作
首先，在项目中引入必要的依赖项：

<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-base</artifactId>
    <version>4.5.0</version>
</dependency>

<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-annotation</artifactId>
    <version>4.5.0</version>
</dependency>

#### 定义实体类并配置注解
定义用于映射表格结构的数据模型，并通过自定义注解指定各字段对应的显示名称及其所在层次位置。

import cn.afterturn.easypoi.excel.annotation.Excel;
import cn.afterturn.easypoi.excel.annotation.ExcelCollection;

public class MultiLevelHeaderEntity {
    
    @Excel(name="基本信息", orderNum = "1", isImportField = "true")
    private String baseInfo; 

    @Excel(name="财务信息", mergeVertical = true, height = 20)
    public List<FinanceDetail> financeDetails;

    // Getters and Setters
    
}

对于更复杂的嵌套关系，则可以通过 `@ExcelCollection` 注解关联子对象集合属性；同时还可以借助于 `mergeVertical=true` 参数控制垂直方向上的合并行为[^2]。

#### 创建控制器方法处理请求逻辑
编写 Spring MVC 控制器中的相应处理器函数完成最终文件流响应给客户端浏览器保存操作。

@RequestMapping("/exportMultiLevelHeaders")
@ResponseBody
public void exportMultiLevelHeaders(HttpServletResponse response){
    try{
        Workbook workbook = new HSSFWorkbook();
        
        Sheet sheet = workbook.createSheet("Sample");
        
        // 设置标题栏样式...
        
        int rowIndex = 0;
        Row rowTitle = sheet.createRow(rowIndex++);
        Cell cellBaseInfo = rowTitle.createCell(0);
        cellBaseInfo.setCellValue("基本信息");

        Cell cellFinancialData = rowTitle.createCell(1);
        cellFinancialData.setCellValue("财务信息");
        
        // 添加更多行...

        ByteArrayOutputStream bos = new ByteArrayOutputStream();
        workbook.write(bos);

        byte[] bytes = bos.toByteArray();

        ByteArrayInputStream bis = new ByteArrayInputStream(bytes);  
          
        EasyPOIUtil.exportExcel(response,"multi_level_headers.xlsx","sheetName",new ExportParams(), MultiLevelHeaderEntity.class,bis );
         
     } catch (Exception e) { 
         throw new RuntimeException(e.getMessage());   
     }
}

上述代码片段展示了如何创建一个多层标题的工作簿实例，并将其转换成字节数组形式以便传递至辅助工具类进行进一步加工处理[^3]。