关于java:SpringBoot实现Excel导入导出性能爆表用起来够优雅

52次阅读

共计 10118 个字符,预计需要花费 26 分钟才能阅读完成。

操作 Excel 实现导入导出是个十分常见的需要,之前介绍了一款十分好用的工具 EasyPoi。有读者提出在数据量大的状况下,EasyPoi 占用内存大,性能不够好。明天给大家举荐一款性能更好的 Excel 导入导出工具EasyExcel,心愿对大家有所帮忙!

SpringBoot 实战电商我的项目 mall(50k+star)地址:https://github.com/macrozheng/mall

EasyExcel 简介

EasyExcel 是一款阿里开源的 Excel 导入导出工具,具备解决疾速、占用内存小、使用方便的特点,在 Github 上已有22k+Star,可见其十分风行。

EasyExcel 读取 75M(46W 行 25 列)的 Excel,仅需应用 64M 内存,耗时 20s,极速模式还能够更快!

集成

在 SpringBoot 中集成 EasyExcel 非常简单,仅需一个依赖即可。

<!--EasyExcel 相干依赖 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.0.5</version>
</dependency>

应用

EasyExcel 和 EasyPoi 的应用十分相似,都是通过注解来管制导入导出。接下来咱们以会员信息和订单信息的导入导出为例,别离实现下简略的单表导出和具备一对多关系的简单导出。

简略导出

咱们以会员信息的导出为例,来体验下 EasyExcel 的导出性能。

  • 首先创立一个会员对象Member,封装会员信息,这里应用了 EasyExcel 的注解;
/**
 * 购物会员
 * Created by macro on 2021/10/12.
 */
@Data
@EqualsAndHashCode(callSuper = false)
public class Member {@ExcelProperty("ID")
    @ColumnWidth(10)
    private Long id;
    @ExcelProperty("用户名")
    @ColumnWidth(20)
    private String username;
    @ExcelIgnore
    private String password;
    @ExcelProperty("昵称")
    @ColumnWidth(20)
    private String nickname;
    @ExcelProperty("出生日期")
    @ColumnWidth(20)
    @DateTimeFormat("yyyy-MM-dd")
    private Date birthday;
    @ExcelProperty("手机号")
    @ColumnWidth(20)
    private String phone;
    @ExcelIgnore
    private String icon;
    @ExcelProperty(value = "性别", converter = GenderConverter.class)
    @ColumnWidth(10)
    private Integer gender;
}
  • 下面代码应用到了 EasyExcel 的外围注解,咱们别离来理解下:

    • @ExcelProperty:外围注解,value属性可用来设置表头名称,converter属性能够用来设置类型转换器;
    • @ColumnWidth:用于设置表格列的宽度;
    • @DateTimeFormat:用于设置日期转换格局。
  • 在 EasyExcel 中,如果你想实现枚举类型到字符串的转换(比方 gender 属性中,0-> 男 1-> 女),须要自定义转换器,上面为自定义的GenderConverter 代码实现;
/**
 * excel 性别转换器
 * Created by macro on 2021/12/29.
 */
public class GenderConverter implements Converter<Integer> {
    @Override
    public Class<?> supportJavaTypeKey() {
        // 对象属性类型
        return Integer.class;
    }

    @Override
    public CellDataTypeEnum supportExcelTypeKey() {
        //CellData 属性类型
        return CellDataTypeEnum.STRING;
    }

    @Override
    public Integer convertToJavaData(ReadConverterContext<?> context) throws Exception {
        //CellData 转对象属性
        String cellStr = context.getReadCellData().getStringValue();
        if (StrUtil.isEmpty(cellStr)) return null;
        if ("男".equals(cellStr)) {return 0;} else if ("女".equals(cellStr)) {return 1;} else {return null;}
    }

    @Override
    public WriteCellData<?> convertToExcelData(WriteConverterContext<Integer> context) throws Exception {
        // 对象属性转 CellData
        Integer cellValue = context.getValue();
        if (cellValue == null) {return new WriteCellData<>("");
        }
        if (cellValue == 0) {return new WriteCellData<>("男");
        } else if (cellValue == 1) {return new WriteCellData<>("女");
        } else {return new WriteCellData<>("");
        }
    }
}
  • 接下来咱们在 Controller 中增加一个接口,用于导出会员列表到 Excel,还需给响应头设置下载 excel 的属性,具体代码如下;
/**
 * EasyExcel 导入导出测试 Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyExcelController", description = "EasyExcel 导入导出测试")
@RequestMapping("/easyExcel")
public class EasyExcelController {@SneakyThrows(IOException.class)
    @ApiOperation(value = "导出会员列表 Excel")
    @RequestMapping(value = "/exportMemberList", method = RequestMethod.GET)
    public void exportMemberList(HttpServletResponse response) {setExcelRespProp(response, "会员列表");
        List<Member> memberList = LocalJsonUtil.getListFromJson("json/members.json", Member.class);
        EasyExcel.write(response.getOutputStream())
                .head(Member.class)
                .excelType(ExcelTypeEnum.XLSX)
                .sheet("会员列表")
                .doWrite(memberList);
    }
    
  /**
   * 设置 excel 下载响应头属性
   */
  private void setExcelRespProp(HttpServletResponse response, String rawFileName) throws UnsupportedEncodingException {response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    response.setCharacterEncoding("utf-8");
    String fileName = URLEncoder.encode(rawFileName, "UTF-8").replaceAll("\+", "%20");
    response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
  }
}
  • 运行我的项目,通过 Swagger 测试接口,留神在 Swagger 中拜访接口无奈间接下载,须要点击返回后果中的 下载按钮 才行,拜访地址:http://localhost:8088/swagger…

  • 下载实现后,查看下文件,一个规范的 Excel 文件曾经被导出了。

简略导入

接下来咱们以会员信息的导入为例,来体验下 EasyExcel 的导入性能。

  • 在 Controller 中增加会员信息导入的接口,这里须要留神的是应用 @RequestPart 注解润饰文件上传参数,否则在 Swagger 中就没法显示上传按钮了;
/**
 * EasyExcel 导入导出测试 Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyExcelController", description = "EasyExcel 导入导出测试")
@RequestMapping("/easyExcel")
public class EasyExcelController {
    
    @SneakyThrows
    @ApiOperation("从 Excel 导入会员列表")
    @RequestMapping(value = "/importMemberList", method = RequestMethod.POST)
    @ResponseBody
    public CommonResult importMemberList(@RequestPart("file") MultipartFile file) {List<Member> memberList = EasyExcel.read(file.getInputStream())
                .head(Member.class)
                .sheet()
                .doReadSync();
        return CommonResult.success(memberList);
    }
}
  • 而后在 Swagger 中测试接口,抉择之前导出的 Excel 文件即可,导入胜利后会返回解析到的数据。

简单导出

当然 EasyExcel 也能够实现更加简单的导出,比方导出一个嵌套了商品信息的订单列表,上面咱们来实现下!

应用 EasyPoi 实现

之前咱们应用过 EasyPoi 实现该性能,因为 EasyPoi 原本就反对嵌套对象的导出,间接应用内置的 @ExcelCollection 注解即可实现,十分不便也合乎面向对象的思维。

寻找计划

因为 EasyExcel 自身并不反对这种一对多的信息导出,所以咱们得自行实现下,这里分享一个我平时罕用的 疾速查找解决方案 的方法。

咱们能够间接从开源我的项目的 issues 外面去搜寻,比方搜寻下 一对多 ,会间接找到 有无一对多导出比拟优雅的计划 这个 issue。

从此 issue 的回复咱们能够发现,我的项目维护者倡议 创立自定义合并策略 来实现,有位回复的老哥曾经给出了实现代码,接下来咱们就用这个计划来实现下。

解决思路

为什么自定义单元格合并策略能实现一对多的列表信息的导出呢?首先咱们来看下将嵌套数据平铺,不进行合并导出的 Excel。

看完之后咱们很容易了解解决思路,只有把 订单 ID雷同的列中须要合并的列给合并了,就能够实现这种一对多嵌套信息的导出了。

实现过程

  • 首先咱们得把原来嵌套的订单商品信息给平铺了,创立一个专门的导出对象 OrderData,蕴含订单和商品信息,二级表头能够通过设置@ExcelProperty 的 value 为数组来实现;
/**
 * 订单导出
 * Created by macro on 2021/12/30.
 */
@Data
@EqualsAndHashCode(callSuper = false)
public class OrderData {@ExcelProperty(value = "订单 ID")
    @ColumnWidth(10)
    @CustomMerge(needMerge = true, isPk = true)
    private String id;
    @ExcelProperty(value = "订单编码")
    @ColumnWidth(20)
    @CustomMerge(needMerge = true)
    private String orderSn;
    @ExcelProperty(value = "创立工夫")
    @ColumnWidth(20)
    @DateTimeFormat("yyyy-MM-dd")
    @CustomMerge(needMerge = true)
    private Date createTime;
    @ExcelProperty(value = "收货地址")
    @CustomMerge(needMerge = true)
    @ColumnWidth(20)
    private String receiverAddress;
    @ExcelProperty(value = {"商品信息", "商品编码"})
    @ColumnWidth(20)
    private String productSn;
    @ExcelProperty(value = {"商品信息", "商品名称"})
    @ColumnWidth(20)
    private String name;
    @ExcelProperty(value = {"商品信息", "商品题目"})
    @ColumnWidth(30)
    private String subTitle;
    @ExcelProperty(value = {"商品信息", "品牌名称"})
    @ColumnWidth(20)
    private String brandName;
    @ExcelProperty(value = {"商品信息", "商品价格"})
    @ColumnWidth(20)
    private BigDecimal price;
    @ExcelProperty(value = {"商品信息", "商品数量"})
    @ColumnWidth(20)
    private Integer count;
}
  • 而后将原来嵌套的 Order 对象列表转换为 OrderData 对象列表;
/**
 * EasyExcel 导入导出测试 Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyExcelController", description = "EasyExcel 导入导出测试")
@RequestMapping("/easyExcel")
public class EasyExcelController {private List<OrderData> convert(List<Order> orderList) {List<OrderData> result = new ArrayList<>();
        for (Order order : orderList) {List<Product> productList = order.getProductList();
            for (Product product : productList) {OrderData orderData = new OrderData();
                BeanUtil.copyProperties(product,orderData);
                BeanUtil.copyProperties(order,orderData);
                result.add(orderData);
            }
        }
        return result;
    }
}
  • 再创立一个自定义注解CustomMerge,用于标记哪些属性须要合并,哪个是主键;
/**
 * 自定义注解,用于判断是否须要合并以及合并的主键
 */
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface CustomMerge {

    /**
     * 是否须要合并单元格
     */
    boolean needMerge() default false;

    /**
     * 是否是主键, 即该字段雷同的行合并
     */
    boolean isPk() default false;}
  • 再创立自定义单元格合并策略类CustomMergeStrategy,当 Excel 中两列主键雷同时,合并被标记须要合并的列;
/**
 * 自定义单元格合并策略
 */
public class CustomMergeStrategy implements RowWriteHandler {
    /**
     * 主键下标
     */
    private Integer pkIndex;

    /**
     * 须要合并的列的下标汇合
     */
    private List<Integer> needMergeColumnIndex = new ArrayList<>();

    /**
     * DTO 数据类型
     */
    private Class<?> elementType;

    public CustomMergeStrategy(Class<?> elementType) {this.elementType = elementType;}

    @Override
    public void afterRowDispose(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Integer relativeRowIndex, Boolean isHead) {
        // 如果是题目, 则间接返回
        if (isHead) {return;}

        // 获取以后 sheet
        Sheet sheet = writeSheetHolder.getSheet();

        // 获取题目行
        Row titleRow = sheet.getRow(0);

        if (null == pkIndex) {this.lazyInit(writeSheetHolder);
        }

        // 判断是否须要和上一行进行合并
        // 不能和题目合并,只能数据行之间合并
        if (row.getRowNum() <= 1) {return;}
        // 获取上一行数据
        Row lastRow = sheet.getRow(row.getRowNum() - 1);
        // 将本行和上一行是同一类型的数据(通过主键字段进行判断),则须要合并
        if (lastRow.getCell(pkIndex).getStringCellValue().equalsIgnoreCase(row.getCell(pkIndex).getStringCellValue())) {for (Integer needMerIndex : needMergeColumnIndex) {CellRangeAddress cellRangeAddress = new CellRangeAddress(row.getRowNum() - 1, row.getRowNum(),
                        needMerIndex, needMerIndex);
                sheet.addMergedRegionUnsafe(cellRangeAddress);
            }
        }
    }

    /**
     * 初始化主键下标和须要合并字段的下标
     */
    private void lazyInit(WriteSheetHolder writeSheetHolder) {

        // 获取以后 sheet
        Sheet sheet = writeSheetHolder.getSheet();

        // 获取题目行
        Row titleRow = sheet.getRow(0);
        // 获取 DTO 的类型
        Class<?> eleType = this.elementType;

        // 获取 DTO 所有的属性
        Field[] fields = eleType.getDeclaredFields();

        // 遍历所有的字段,因为是基于 DTO 的字段来构建 excel,所以字段数 >= excel 的列数
        for (Field theField : fields) {
            // 获取 @ExcelProperty 注解,用于获取该字段对应在 excel 中的列的下标
            ExcelProperty easyExcelAnno = theField.getAnnotation(ExcelProperty.class);
            // 为空, 则示意该字段不须要导入到 excel, 间接解决下一个字段
            if (null == easyExcelAnno) {continue;}
            // 获取自定义的注解,用于合并单元格
            CustomMerge customMerge = theField.getAnnotation(CustomMerge.class);

            // 没有 @CustomMerge 注解的默认不合并
            if (null == customMerge) {continue;}

            for (int index = 0; index < fields.length; index++) {Cell theCell = titleRow.getCell(index);
                // 当配置为不须要导出时,返回的为 null,这里作一下判断,避免 NPE
                if (null == theCell) {continue;}
                // 将字段和 excel 的表头匹配上
                if (easyExcelAnno.value()[0].equalsIgnoreCase(theCell.getStringCellValue())) {if (customMerge.isPk()) {pkIndex = index;}

                    if (customMerge.needMerge()) {needMergeColumnIndex.add(index);
                    }
                }
            }
        }

        // 没有指定主键,则异样
        if (null == this.pkIndex) {throw new IllegalStateException("应用 @CustomMerge 注解必须指定主键");
        }

    }
}
  • 接下来在 Controller 中增加导出订单列表的接口,将咱们自定义的合并策略 CustomMergeStrategy 给注册下来;
/**
 * EasyExcel 导入导出测试 Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyExcelController", description = "EasyExcel 导入导出测试")
@RequestMapping("/easyExcel")
public class EasyExcelController {
    
    @SneakyThrows
    @ApiOperation(value = "导出订单列表 Excel")
    @RequestMapping(value = "/exportOrderList", method = RequestMethod.GET)
    public void exportOrderList(HttpServletResponse response) {List<Order> orderList = getOrderList();
        List<OrderData> orderDataList = convert(orderList);
        setExcelRespProp(response, "订单列表");
        EasyExcel.write(response.getOutputStream())
                .head(OrderData.class)
                .registerWriteHandler(new CustomMergeStrategy(OrderData.class))
                .excelType(ExcelTypeEnum.XLSX)
                .sheet("订单列表")
                .doWrite(orderDataList);
    }
}
  • 在 Swagger 中拜访接口测试,导出订单列表对应 Excel;

  • 下载实现后,查看下文件,因为 EasyExcel 须要本人来实现,比照之前应用 EasyPoi 来实现麻烦了不少。

其余应用

因为 EasyExcel 的官网文档介绍的比较简单,如果你想要更深刻地进行应用的话,倡议大家看下官网 Demo。

总结

体验了一把 EasyExcel,应用还是挺不便的,性能也很优良。然而比拟常见的一对多导出实现比较复杂,而且性能也不如 EasyPoi 弱小。如果你的 Excel 导出数据量不大的话,能够应用 EasyPoi,如果数据量大,比拟在意性能的话,还是应用 EasyExcel 吧。

参考资料

  • 我的项目地址:https://github.com/alibaba/ea…
  • 官网文档:https://www.yuque.com/easyexc…

我的项目源码地址

https://github.com/macrozheng…

本文 GitHub https://github.com/macrozheng/mall-learning 曾经收录,欢送大家 Star!

正文完
 0