动态表头导出EasyExcel

在 Spring Boot 中联合 EasyExcel 实现动态表头导出（无实体类，表头和字段（前端传表名，字段值动态查询，返回List<Map<String,Object>>）由前端传递）可以通过以下步骤实现。以下是完整示例：

---

1. 前端请求数据结构

假设前端传递的 JSON 格式如下：

1. {
2.   "headers": [
3.     {"title": "姓名", "field": "name"},
4.     {"title": "年龄", "field": "age"},
5.     {"title": "城市", "field": "city"}
6.   ],
7.   "data": [
8.     {"name": "张三", "age": 25, "city": "北京"},
9.     {"name": "李四", "age": 30, "city": "上海"}
10.   ]
11. }

复制代码

---

2. 后端 DTO 界说

界说吸收参数的 DTO 类：

1. @Data
2. public class ExportRequest {
3.     private List<Header> headers;
4.     private List<Map<String, Object>> data;
6.     @Data
7.     public static class Header {
8.         private String title;  // 表头名称
9.         private String field;  // 数据字段名
10.     }
11. }

复制代码

---

3. Controller 层接口

处置惩罚导出请求：

1. @RestController
2. public class ExportController {
4.     @Autowired
5.     private ExportService exportService;
7.     @PostMapping("/export")
8.     public void exportExcel(@RequestBody ExportRequest request, HttpServletResponse response) {
9.         exportService.export(request, response);
10.     }
11. }

复制代码

---

4. Service 层实现

焦点导出逻辑：

1. @Service
2. public class ExportService {
4.     public void export(ExportRequest request, HttpServletResponse response) {
5.         try {
6.             // 设置响应头
7.             response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
8.             response.setCharacterEncoding("UTF-8");
9.             String fileName = URLEncoder.encode("动态导出.xlsx", "UTF-8");
10.             response.setHeader("Content-Disposition", "attachment; filename=" + fileName);
12.             // 获取输出流
13.             OutputStream outputStream = response.getOutputStream();
15.             // 动态构建表头和数据
16.             WriteSheet writeSheet = EasyExcel.writerSheet("Sheet1").build();
17.             ExcelWriter excelWriter = EasyExcel.write(outputStream).build();
19.             // 动态添加表头
20.             WriteTable writeTable = new WriteTable();
21.             List<List<String>> head = buildHead(request.getHeaders());
22.             writeTable.setHead(head);
24.             // 动态填充数据
25.             List<List<Object>> data = buildData(request.getHeaders(), request.getData());
26.             excelWriter.write(data, writeSheet, writeTable);
28.             // 关闭流
29.             excelWriter.finish();
30.             outputStream.flush();
31.         } catch (IOException e) {
32.             throw new RuntimeException("导出失败", e);
33.         }
34.     }
36.     // 构建表头
37.     private List<List<String>> buildHead(List<ExportRequest.Header> headers) {
38.         List<List<String>> head = new ArrayList<>();
39.         for (ExportRequest.Header header : headers) {
40.             List<String> columnHead = Collections.singletonList(header.getTitle());
41.             head.add(columnHead);
42.         }
43.         return head;
44.     }
46.     // 构建数据行
47.     private List<List<Object>> buildData(List<ExportRequest.Header> headers, List<Map<String, Object>> dataList) {
48.         List<List<Object>> data = new ArrayList<>();
49.         for (Map<String, Object> rowData : dataList) {
50.             List<Object> row = new ArrayList<>();
51.             for (ExportRequest.Header header : headers) {
52.                 row.add(rowData.get(header.getField()));
53.             }
54.             data.add(row);
55.         }
56.         return data;
57.     }
58. }

复制代码

---

5. 关键点说明

• 动态表头
  
  
  
  • 通过 buildHead() 方法将前端传递的 headers 转换为 EasyExcel 必要的 List<List<String>> 格式。
    
  
  
• 动态数据
  
  
  
  • 通过 buildData() 方法，根据 headers 中界说的 field 字段次序，从 data 中提取对应值，构建数据行。
    
  
  
• 流式导出
  
  
  
  • 使用 ExcelWriter 直接操作输出流，制止内存溢出（得当大数据量）。
    
  
  

---

6. 测试与验证

使用 Postman 发送请求：

• URL: POST http://localhost:8080/export
  
• Body（JSON）：
  
  1. {
  2.   "headers": [
  3.     {"title": "姓名", "field": "name"},
  4.     {"title": "年龄", "field": "age"},
  5.     {"title": "城市", "field": "city"}
  6.   ],
  7.   "data": [
  8.     {"name": "张三", "age": 25, "city": "北京"},
  9.     {"name": "李四", "age": 30, "city": "上海"}
  10.   ]
  11. }

  复制代码
• 响应：浏览器自动下载 动态导出.xlsx，内容如下：
     姓名年龄城市张三25北京李四30上海
  

---

7. 扩展优化

• 字段校验：确保前端传递的 field 在 data 中存在对应值。
  
• 大数据量分页：如果数据量过大，可分页查询后分批写入。
  
• 自界说样式：通过 WriteHandler 动态设置单元格样式（如字体、颜色）。
  

---

通过这种方式，无需界说实体类即可实现完全动态的 Excel 导出功能，表头和字段完全由前端控制。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。