阿里 EasyExcel 7 行代码优雅地实现 Excel 文件生成&下载功能

欢迎关注我的微信公众号: 小哈学Java, 文末 分享阿里 P8 高级架构师吐血总结的 《Java 核心知识整理&面试.pdf》资源连接！！

我的网站: https://www.exception.site/essay/how-to-create-excel-by-seven-line-code

目录

• 1、前言
• 2、Apache poi、jxl 的缺陷
• 3、阿里出品的 EasyExcel，安利一波
• 4、EasyExcel 解决了什么
• 5、快速上手
• 6、特殊场景支持
• 7、Web 下载示例代码
• 8、须要注意的点
• 9、总结

1、前言

关于导出 Excel 文件，能够说是大多数服务中都须要集成的功能。那么，要如何优雅快速地（偷懒地）去实现这个功能呢？

你可能第一想法是：这还不简单？用 Apache 开源框架 poi, 或者 jxl 均可以实现啊。面向百度编程，把代码模板 copy 下来，根据本身的业务再改改，能有多难？

嗯.. 的确不难，可是你的代码多是下面这个熊样子的：

上面这段代码看上去是否是又臭又长呢？今天，小哈将教您如何使用 7 行代码搞定 Excel 文件生成功能！

2、Apache poi、jxl 的缺陷

在说如何实现以前，咱们先来讨论一下传统 Excel 框架的不足！除了上面说的，Apache poi、jxl 都存在生成 excel 文件不够简单优雅快速外，它们都还存在一个严重的问题，那就是很是耗内存，严重时会致使内存溢出。

POI 虽然目前来讲，是 excel 解析框架中被使用最普遍的，但这个框架并不完美。

为何这么说呢？

开发者们大部分使用 POI，都是使用其 userModel 模式。而 userModel 的好处是上手容易使用简单，随便拷贝个代码跑一下，剩下就是写业务转换了，虽然转换也要写上百行代码，可是仍是可控的。

然而 userModel 模式最大的问题是在于，对内存消耗很是大，一个几兆的文件解析甚至要用掉上百兆的内存。现实状况是，不少应用如今都在采用这种模式，之因此还正常在跑是由于并发不大，并发上来后，必定会OOM或者频繁的 full gc。

3、阿里出品的 EasyExcel，安利一波

什么是 EasyExcel? 见名知意，就是让你操做 Excel 异常的酸爽。先来看下 EasyExcel GitHub 官方截图：

截止目前为止已有 5519 Star, 官方对其的简介是：

快速、简单避免OOM的java处理Excel工具！

如下是官方介绍：

4、EasyExcel 解决了什么

主要来讲，有如下几点：

• 传统 Excel 框架，如 Apache poi、jxl 都存在内存溢出的问题；
• 传统 excel 开源框架使用复杂、繁琐;
• EasyExcel 底层仍是使用的 poi, 可是作了不少优化，好比修复了并发状况下的一些 bug, 具体修复细节，可阅读官方文档 https://github.com/alibaba/easyexcel；

5、快速上手

5.1 添加依赖

<!--alibaba easyexcel-->
<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>easyexcel</artifactId>
  <version>1.1.2-beta5</version>
</dependency>

5.2 七行代码搞定 Excel 生成

@Test
public void writeExcel1() throws Exception {
  // 文件输出位置
  OutputStream out = new FileOutputStream("/Users/a123123/Work/tmp_files/test.xlsx");

  ExcelWriter writer = EasyExcelFactory.getWriter(out);

  // 写仅有一个 Sheet 的 Excel 文件, 此场景较为通用
  Sheet sheet1 = new Sheet(1, 0, WriteModel.class);

  // 第一个 sheet 名称
  sheet1.setSheetName("第一个sheet");

  // 写数据到 Writer 上下文中
  // 入参1: 建立要写入的模型数据
  // 入参2: 要写入的目标 sheet
  writer.write(createModelList(), sheet1);

  // 将上下文中的最终 outputStream 写入到指定文件中
  writer.finish();

  // 关闭流
  out.close();
}

上面这段示例代码中，有两个点很重要，小哈已经重点标注标：

• ①：WriteModel 这个对象就是要写入 Excel 的数据模型对象，**等等，你这好像不行吧？表头 head，以及每一个单元格内的数据顺序都没指定，能达到想要的效果么？别急，后面会讨论这块！
• ②：建立须要写入的数据集，固然了，正常业务中，这块都是从数据库中查询出来的。

PS: 若是说写入的数据量很大，须要作分片查询再写入的处理，不然可能会 OOM（Out of Memory）.

回过头来，咱们来看看 WriteModel 这个对象内部到底有什么幺蛾子！

/**
 * @author 微信公众号: 小哈学Java
 * @Site： www.exception.site
 * @date 2019/5/9
 * @time 下午2:07
 * @discription 写入Excel模型对象
 **/
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class WriteModel extends BaseRowModel {

    @ExcelProperty(value = "姓名", index = 0)
    private String name;

    @ExcelProperty(value = "密码", index = 1)
    private String password;

    @ExcelProperty(value = "年龄", index = 2)
    private Integer age;
}

ExayExcel 提供注解的方式, 来方便的定义 Excel 须要的数据模型：

• ①：首先，定义的写入模型必需要继承自 BaseRowModel.java;
• ②：经过 @ExcelProperty 注解来指定每一个字段的列名称，以及下标位置；

同时，上面定义的 createModelList() 方法也很简单，经过循环，建立一个写入模型的 List 集合：

")

废话很少说，这个快速接入的案例也介绍的差很少了，跑一跑单元测试看下实际效果：

怎么样，效果仍是挺棒棒的！

6、特殊场景支持

在实际的业务中，咱们还会有一些特需的需求，好比说下面这些。

6.1 动态生成 Excel 内容

上面的例子是基于注解的，也就是说表头 head, 以及内容都是写死的，换句话说，我定义好了一个数据模型，那么，生成的 Excel 文件也就是只能遵循这种模型来了，可是，实际业务中可能会存在动态变化的需求，要怎么作呢？

@Test
public void writeExcel2() throws Exception {
  // 文件输出位置
  OutputStream out = new FileOutputStream("/Users/a123123/Work/tmp_files/test2.xlsx");

  ExcelWriter writer = EasyExcelFactory.getWriter(out);

  // 动态添加表头，适用一些表头动态变化的场景
  Sheet sheet1 = new Sheet(1, 0);

  sheet1.setSheetName("第一个sheet");

  // 建立一个表格，用于 Sheet 中使用
  Table table1 = new Table(1);

  // 无注解的模式，动态添加表头
  table1.setHead(DataUtil.createTestListStringHead());
  // 写数据
  writer.write1(createDynamicModelList(), sheet1, table1);

  // 将上下文中的最终 outputStream 写入到指定文件中
  writer.finish();

  // 关闭流
  out.close();
}

• ①：无注解模式，动态添加表头，也可自由组合复杂表头，代码以下：

public static List<List<String>> createTestListStringHead(){
    // 模型上没有注解，表头数据动态传入
    List<List<String>> head = new ArrayList<List<String>>();
    List<String> headCoulumn1 = new ArrayList<String>();
    List<String> headCoulumn2 = new ArrayList<String>();
    List<String> headCoulumn3 = new ArrayList<String>();
    List<String> headCoulumn4 = new ArrayList<String>();
    List<String> headCoulumn5 = new ArrayList<String>();

    headCoulumn1.add("第一列");headCoulumn1.add("第一列");headCoulumn1.add("第一列");
    headCoulumn2.add("第一列");headCoulumn2.add("第一列");headCoulumn2.add("第一列");

    headCoulumn3.add("第二列");headCoulumn3.add("第二列");headCoulumn3.add("第二列");
    headCoulumn4.add("第三列");headCoulumn4.add("第三列2");headCoulumn4.add("第三列2");
    headCoulumn5.add("第一列");headCoulumn5.add("第3列");headCoulumn5.add("第4列");

    head.add(headCoulumn1);
    head.add(headCoulumn2);
    head.add(headCoulumn3);
    head.add(headCoulumn4);
    head.add(headCoulumn5);
    return head;
}

• ②：建立动态数据，注意这里的数据类型是 Object:

跑一下单元测试，看下效果：

6.2 自定义表头以及内容样式

我想自定义表头，内容样式，咋办？

咱们复用了上面的示例代码，并额外添加了设置自定义表格样式的代码, createTableStytle() 具体内容以下：

public static TableStyle createTableStyle() {
    TableStyle tableStyle = new TableStyle();
    // 设置表头样式
    Font headFont = new Font();
    // 字体是否加粗
    headFont.setBold(true);
    // 字体大小
    headFont.setFontHeightInPoints((short)12);
    // 字体
    headFont.setFontName("楷体");
    tableStyle.setTableHeadFont(headFont);
    // 背景色
    tableStyle.setTableHeadBackGroundColor(IndexedColors.BLUE);


    // 设置表格主体样式
    Font contentFont = new Font();
    contentFont.setBold(true);
    contentFont.setFontHeightInPoints((short)12);
    contentFont.setFontName("黑体");
    tableStyle.setTableContentFont(contentFont);
    tableStyle.setTableContentBackGroundColor(IndexedColors.GREEN);
    return tableStyle;
}

咱们能够经过 TableStyle 这个类来设置表头、表格主题的样式。

6.3 合并单元格

咱们能够经过 merge() 方法来合并单元格：

注意下标是从 0 开始的，也就是说合并了第六行到第七行，其中的第一列到第五列，跑下代码，看下效果：

6.4 自定义处理

对于更复杂的处理，EasyExcel 预留了 WriterHandler 接口来，容许你自定义处理代码：

接口中定义了三个方法:

• sheet(): 在建立每一个 sheet 后自定义业务逻辑处理；
• row(): 在建立每一个 row 后自定义业务逻辑处理；
• cell(): 在建立每一个 cell 后自定义业务逻辑处理；

咱们实现了该接口后，编写自定义逻辑处理代码，而后调用 getWriterWithTempAndHandler() 静态方法获取 ExcelWriter 对象时，传入 WriterHandler 的实现类便可。

好比下面的示例代码：

ExcelWriter writer = EasyExcelFactory.getWriterWithTempAndHandler(null, out, ExcelTypeEnum.XLSX, true, new MyWriterHandler());

7、Web 下载示例代码

public class Down {
    @GetMapping("/a.htm")
    public void cooperation(HttpServletRequest request, HttpServletResponse response) {
        ServletOutputStream out = response.getOutputStream();
        ExcelWriter writer = new ExcelWriter(out, ExcelTypeEnum.XLSX, true);
        String fileName = new String(("UserInfo " + new SimpleDateFormat("yyyy-MM-dd").format(new Date()))
                .getBytes(), "UTF-8");
        Sheet sheet1 = new Sheet(1, 0);
        sheet1.setSheetName("第一个sheet");
        writer.write0(getListString(), sheet1);
        writer.finish();
        response.setContentType("multipart/form-data");
        response.setCharacterEncoding("utf-8");
        response.setHeader("Content-disposition", "attachment;filename="+fileName+".xlsx");
        out.flush();
        }
    }

8、须要注意的点

8.1 写入大数据时，需分片

好比说，咱们须要从数据库中查询出数据量较大时，咱们须要在业务层作分片处理，也就是，咱们须要分屡次查询，再写入，防止内存溢出 OOM.

8.2 Excel 最大行数问题

Excel 03, 07 版本均有行数、列数的限制：

版本	最大行	最大列
Excel 2003	65536	256
Excel 2007	1048576	16384

csv 因为是文本文件，实际上没有最大行数的限制，可是用 Excel 客户端打开仍是多了不显示。

也就是说，若是你想写入更多的行数是不行的，强行这么作，程序会报相似以下异常

Invalid row number (1048576) outside allowable range (0..1048575)

如何解决呢？

1. 分多个 Excel 文件写入;
2. 同一个 Excel 文件，分多个 Sheet 写入；

9、总结

小哈今天主要给小伙伴介绍了 EasyExcel, 为何要使用它，以及演示了相关示例代码。固然了，EasyExcel 除了写 Excel 文件外，它还有快速读取 Excel 的功能，因为本文主要介绍的是：如何优雅地实现 Excel 文件生成，因此就没有介绍了，有兴趣的小伙伴们，也能够去 GitHub 官网去去查看相关文档。

最后，祝您看完本文后有所收获，下期见！

10、GitHub 源码地址

https://github.com/weiwosuoai/spring-boot-tutorial/tree/master/spring-boot-excel

11、Ref

https://github.com/alibaba/easyexcel

免费分享 | 面试&学习福利资源

最近在网上发现一个不错的 PDF 资源《Java 核心知识&面试.pdf》分享给你们，不光是面试，学习，你都值得拥有！！！

获取方式: 关注公众号: 小哈学Java, 后台回复资源，既可免费无套路获取资源连接，下面是目录以及部分截图：

重要的事情说两遍，关注公众号: 小哈学Java, 后台回复资源，既可免费无套路获取资源连接 ！！！

欢迎关注微信公众号: 小哈学Java