关于java:SpringBoot实现Excel导入导出好用到爆POI可以扔掉了

文章目录[隐藏]

EasyPoi简介
集成
应用
总结
参考资料
我的项目源码地址

在咱们平时工作中常常会遇到要操作Excel的性能，比方导出个用户信息或者订单信息的Excel报表。你必定据说过POI这个货色，能够实现。然而POI实现的API的确很麻烦，它须要写那种逐行解析的代码（相似Xml解析）。明天给大家举荐一款十分好用的Excel导入导出工具EasyPoi，心愿对大家有所帮忙！

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

EasyPoi简介

用惯了SpringBoot的敌人预计会想到，有没有什么方法能够间接定义好须要导出的数据对象，而后增加几个注解，间接主动实现Excel导入导出性能？

EasyPoi正是这么一款工具，如果你不太熟悉POI，想简略地实现Excel操作，用它就对了！

EasyPoi的指标不是代替POI，而是让一个不懂导入导出的人也能疾速应用POI实现Excel的各种操作，而不是看很多API才能够实现这样的工作。

集成

在SpringBoot中集成EasyPoi非常简单，只需增加如下一个依赖即可，真正的开箱即用！

<code class="xml"><dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>

应用

接下来介绍下EasyPoi的应用，以会员信息和订单信息的导入导出为例，别离实现下简略的单表导出和具备关联信息的简单导出。

简略导出

咱们以会员信息列表导出为例，应用EasyPoi来实现下导出性能，看看是不是够简略！

首先创立一个会员对象Member，封装会员信息；

<code class="java">/**
 * 购物会员
 * Created by macro on 2021/10/12.
 */
@Data
@EqualsAndHashCode(callSuper = false)
public class Member {
    @Excel(name = "ID", width = 10)
    private Long id;
    @Excel(name = "用户名", width = 20, needMerge = true)
    private String username;
    private String password;
    @Excel(name = "昵称", width = 20, needMerge = true)
    private String nickname;
    @Excel(name = "出生日期", width = 20, format = "yyyy-MM-dd")
    private Date birthday;
    @Excel(name = "手机号", width = 20, needMerge = true, desensitizationRule = "3_4")
    private String phone;
    private String icon;
    @Excel(name = "性别", width = 10, replace = {"男_0", "女_1"})
    private Integer gender;
}

在此咱们就能够看到EasyPoi的外围注解@Excel，通过在对象上增加@Excel注解，能够将对象信息间接导出到Excel中去，上面对注解中的属性做个介绍；
- name：Excel中的列名；
- width：指定列的宽度；
- needMerge：是否须要纵向合并单元格；
- format：当属性为工夫类型时，设置工夫的导出导出格局；
- desensitizationRule：数据脱敏解决，3_4示意只显示字符串的前3位和后4位，其余为*号；
- replace：对属性进行替换；
- suffix：对数据增加后缀。
接下来咱们在Controller中增加一个接口，用于导出会员列表到Excel，具体代码如下；

<code class="java">/**
 * EasyPoi导入导出测试Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyPoiController", description = "EasyPoi导入导出测试")
@RequestMapping("/easyPoi")
public class EasyPoiController {

    @ApiOperation(value = "导出会员列表Excel")
    @RequestMapping(value = "/exportMemberList", method = RequestMethod.GET)
    public void exportMemberList(ModelMap map,
                                 HttpServletRequest request,
                                 HttpServletResponse response) {
        List<Member> memberList = LocalJsonUtil.getListFromJson("json/members.json", Member.class);
        ExportParams params = new ExportParams("会员列表", "会员列表", ExcelType.XSSF);
        map.put(NormalExcelConstants.DATA_LIST, memberList);
        map.put(NormalExcelConstants.CLASS, Member.class);
        map.put(NormalExcelConstants.PARAMS, params);
        map.put(NormalExcelConstants.FILE_NAME, "memberList");
        PoiBaseView.render(map, request, response, NormalExcelConstants.EASYPOI_EXCEL_VIEW);
    }
}

LocalJsonUtil工具类，能够间接从resources目录下获取JSON数据并转化为对象，例如此处应用的members.json；

运行我的项目，间接通过Swagger拜访接口，留神在Swagger中拜访接口无奈间接下载，须要点击返回后果中的下载按钮才行，拜访地址：http://localhost:8088/swagger…

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

简略导入

导入性能实现起来也非常简单，上面以会员信息列表的导入为例。

在Controller中增加会员信息导入的接口，这里须要留神的是应用@RequestPart注解润饰文件上传参数，否则在Swagger中就没法显示上传按钮了；

<code class="java">/**
 * EasyPoi导入导出测试Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyPoiController", description = "EasyPoi导入导出测试")
@RequestMapping("/easyPoi")
public class EasyPoiController {

    @ApiOperation("从Excel导入会员列表")
    @RequestMapping(value = "/importMemberList", method = RequestMethod.POST)
    @ResponseBody
    public CommonResult importMemberList(@RequestPart("file") MultipartFile file) {
        ImportParams params = new ImportParams();
        params.setTitleRows(1);
        params.setHeadRows(1);
        try {
            List<Member> list = ExcelImportUtil.importExcel(
                    file.getInputStream(),
                    Member.class, params);
            return CommonResult.success(list);
        } catch (Exception e) {
            e.printStackTrace();
            return CommonResult.failed("导入失败！");
        }
    }
}

而后在Swagger中测试接口，抉择之前导出的Excel文件即可，导入胜利后会返回解析到的数据。

简单导出

当然EasyPoi也能够实现更加简单的Excel操作，比方导出一个嵌套了会员信息和商品信息的订单列表，上面咱们来实现下！

首先增加商品对象Product，用于封装商品信息；

<code class="java">/**
 * 商品
 * Created by macro on 2021/10/12.
 */
@Data
@EqualsAndHashCode(callSuper = false)
public class Product {
    @Excel(name = "ID", width = 10)
    private Long id;
    @Excel(name = "商品SN", width = 20)
    private String productSn;
    @Excel(name = "商品名称", width = 20)
    private String name;
    @Excel(name = "商品副标题", width = 30)
    private String subTitle;
    @Excel(name = "品牌名称", width = 20)
    private String brandName;
    @Excel(name = "商品价格", width = 10)
    private BigDecimal price;
    @Excel(name = "购买数量", width = 10, suffix = "件")
    private Integer count;
}

而后增加订单对象Order，订单和会员是一对一关系，应用 @ExcelEntity注解示意，订单和商品是一对多关系，应用@ExcelCollection注解示意，Order就是咱们须要导出的嵌套订单数据；

<code class="java">/**
 * 订单
 * Created by macro on 2021/10/12.
 */
@Data
@EqualsAndHashCode(callSuper = false)
public class Order {
    @Excel(name = "ID", width = 10,needMerge = true)
    private Long id;
    @Excel(name = "订单号", width = 20,needMerge = true)
    private String orderSn;
    @Excel(name = "创立工夫", width = 20, format = "yyyy-MM-dd HH:mm:ss",needMerge = true)
    private Date createTime;
    @Excel(name = "收货地址", width = 20,needMerge = true )
    private String receiverAddress;
    @ExcelEntity(name = "会员信息")
    private Member member;
    @ExcelCollection(name = "商品列表")
    private List<Product> productList;
}

接下来在Controller中增加导出订单列表的接口，因为有些会员信息咱们不须要导出，能够调用ExportParams中的setExclusions办法排除掉；

<code class="java">/**
 * EasyPoi导入导出测试Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyPoiController", description = "EasyPoi导入导出测试")
@RequestMapping("/easyPoi")
public class EasyPoiController {

    @ApiOperation(value = "导出订单列表Excel")
    @RequestMapping(value = "/exportOrderList", method = RequestMethod.GET)
    public void exportOrderList(ModelMap map,
                                HttpServletRequest request,
                                HttpServletResponse response) {
        List<Order> orderList = getOrderList();
        ExportParams params = new ExportParams("订单列表", "订单列表", ExcelType.XSSF);
        //导出时排除一些字段
        params.setExclusions(new String[]{"ID", "出生日期", "性别"});
        map.put(NormalExcelConstants.DATA_LIST, orderList);
        map.put(NormalExcelConstants.CLASS, Order.class);
        map.put(NormalExcelConstants.PARAMS, params);
        map.put(NormalExcelConstants.FILE_NAME, "orderList");
        PoiBaseView.render(map, request, response, NormalExcelConstants.EASYPOI_EXCEL_VIEW);
    }
}

在Swagger中拜访接口测试，导出订单列表对应Excel；

下载实现后，查看下文件，EasyPoi导出简单的Excel也是很简略的！

自定义解决

如果你想对导出字段进行一些自定义解决，EasyPoi也是反对的，比方在会员信息中，如果用户没有设置昵称，咱们增加下暂未设置信息。

咱们须要增加一个处理器继承默认的ExcelDataHandlerDefaultImpl类，而后在exportHandler办法中实现自定义解决逻辑；

<code class="java">/**
 * 自定义字段解决
 * Created by macro on 2021/10/13.
 */
public class MemberExcelDataHandler extends ExcelDataHandlerDefaultImpl<Member> {

  @Override
  public Object exportHandler(Member obj, String name, Object value) {
    if("昵称".equals(name)){
      String emptyValue = "暂未设置";
      if(value==null){
        return super.exportHandler(obj,name,emptyValue);
      }
      if(value instanceof String&&StrUtil.isBlank((String) value)){
        return super.exportHandler(obj,name,emptyValue);
      }
    }
    return super.exportHandler(obj, name, value);
  }

  @Override
  public Object importHandler(Member obj, String name, Object value) {
    return super.importHandler(obj, name, value);
  }
}

而后批改Controller中的接口，调用MemberExcelDataHandler处理器的setNeedHandlerFields设置须要自定义解决的字段，并调用ExportParams的setDataHandler设置自定义处理器；

<code class="java">/**
 * EasyPoi导入导出测试Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyPoiController", description = "EasyPoi导入导出测试")
@RequestMapping("/easyPoi")
public class EasyPoiController {

    @ApiOperation(value = "导出会员列表Excel")
    @RequestMapping(value = "/exportMemberList", method = RequestMethod.GET)
    public void exportMemberList(ModelMap map,
                                 HttpServletRequest request,
                                 HttpServletResponse response) {
        List<Member> memberList = LocalJsonUtil.getListFromJson("json/members.json", Member.class);
        ExportParams params = new ExportParams("会员列表", "会员列表", ExcelType.XSSF);
        //对导出后果进行自定义解决
        MemberExcelDataHandler handler = new MemberExcelDataHandler();
        handler.setNeedHandlerFields(new String[]{"昵称"});
        params.setDataHandler(handler);
        map.put(NormalExcelConstants.DATA_LIST, memberList);
        map.put(NormalExcelConstants.CLASS, Member.class);
        map.put(NormalExcelConstants.PARAMS, params);
        map.put(NormalExcelConstants.FILE_NAME, "memberList");
        PoiBaseView.render(map, request, response, NormalExcelConstants.EASYPOI_EXCEL_VIEW);
    }
}

再次调用导出接口，咱们能够发现昵称曾经增加默认设置了。

总结

体验了一波EasyPoi，它应用注解来操作Excel的形式的确十分好用。如果你想生成更为简单的Excel的话，能够思考下它的模板性能。

参考资料

我的项目官网：https://gitee.com/lemur/easypoi

我的项目源码地址

https://github.com/macrozheng…

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

搞代码网（gaodaima.com）提供的所有资源部分来自互联网，如果有侵犯您的版权或其他权益，请说明详细缘由并提供版权或权益证明然后发送到邮箱[email protected]‍，我们会在看到邮件的第一时间内为您处理，或直接联系QQ：872152909。本网站采用BY-NC-SA协议进行授权
转载请注明原文链接：关于java:SpringBoot实现Excel导入导出好用到爆POI可以扔掉了