使用EasyPoi导入、导出excel

最新推荐文章于 2024-09-29 10:45:34 发布
最新推荐文章于 2024-09-29 10:45:34 发布
阅读量5.6k 收藏 8
点赞数
分类专栏： java 文章标签： java excel
原文链接：https://juejin.cn/post/7051508403507560478
版权

前言

springboot版本：2.6.2

一、集成

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

<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>
复制代码

使用

接下来介绍下EasyPoi的使用，以会员信息和订单信息的导入导出为例，分别实现下简单的单表导出和具有关联信息的复杂导出。

简单导出

我们以会员信息列表导出为例，使用EasyPoi来实现下导出功能，看看是不是够简单！

  • 首先创建一个会员对象Member，封装会员信息；
package com.example.pojo;

import cn.afterturn.easypoi.excel.annotation.Excel;
import lombok.Data;
import lombok.EqualsAndHashCode;

import java.sql.Date;

/**
 * 购物会员
 * 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，具体代码如下；

/**
 * EasyPoi导入导出测试Controller
 * Created by macro on 2021/10/12.
 */
@Controller
@Api(tags = "EasyPoiController", description = "EasyPoi导入导出测试")
@RequestMapping("/easyPoi")
public class EasyPoiController {
    @Autowired
    private EasyPoiService easyPoiService;

    @ApiOperation(value = "导出会员列表Excel")
    @RequestMapping(value = "/exportMemberList", method = RequestMethod.GET)
    public void exportMemberList(ModelMap modelMap,
                                 HttpServletRequest request,
                                 HttpServletResponse response) {
        modelMap = easyPoiService.exportMemberExcel(modelMap);

        PoiBaseView.render(modelMap, request, response, NormalExcelConstants.EASYPOI_EXCEL_VIEW);
    }
}
复制代码
  • 对应的service及serviceImpl EasyPoiService：
package com.example.service;

import com.example.pojo.Member;
import org.springframework.ui.ModelMap;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

public interface EasyPoiService {

    /**
     * 导出会员excel数据
     * @param modelMap
     * @return
     */
    ModelMap exportMemberExcel(ModelMap modelMap);
}
复制代码

EasyPoiServiceImpl：

package com.example.service.impl;

import cn.afterturn.easypoi.entity.vo.NormalExcelConstants;
import cn.afterturn.easypoi.excel.ExcelImportUtil;
import cn.afterturn.easypoi.excel.entity.ExportParams;
import cn.afterturn.easypoi.excel.entity.ImportParams;
import cn.afterturn.easypoi.excel.entity.enmus.ExcelType;
import com.example.pojo.Member;
import com.example.pojo.Order;
import com.example.pojo.Product;
import com.example.service.EasyPoiService;
import com.example.util.LocalJsonUtil;
import com.example.util.MemberExcelDataHandler;
import org.springframework.stereotype.Service;
import org.springframework.ui.ModelMap;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

@Service("easyPoiService")
public class EasyPoiServiceImpl implements EasyPoiService {

    @Override
    public ModelMap exportMemberExcel(ModelMap modelMap) {

        List<Member> memberList = LocalJsonUtil.getListFromJson("json/members.json", Member.class);
                ExportParams params = new ExportParams("会员列表", "会员列表", ExcelType.XSSF);
                modelMap.put(NormalExcelConstants.DATA_LIST, memberList);
                modelMap.put(NormalExcelConstants.CLASS, Member.class);
                modelMap.put(NormalExcelConstants.PARAMS, params);
                modelMap.put(NormalExcelConstants.FILE_NAME, "memberList");

        return modelMap;
    }
}
复制代码
  • LocalJsonUtil工具类，可以直接从resources目录下获取JSON数据并转化为对象，例如此处使用的members.json；
package com.example.util;

import cn.hutool.core.io.IoUtil;
import cn.hutool.core.io.resource.ClassPathResource;
import cn.hutool.json.JSONArray;
import cn.hutool.json.JSONUtil;

import java.nio.charset.Charset;
import java.util.List;

/**
 * 从本地获取JSON数据的工具类
 * Created by macro on 2021/10/16.
 */
public class LocalJsonUtil {

    /**
     * 从指定路径获取JSON并转换为List
     * @param path json文件路径
     * @param elementType List元素类型
     */
    public static  <T> List<T> getListFromJson(String path, Class<T> elementType) {
        ClassPathResource resource = new ClassPathResource(path);
        String jsonStr = IoUtil.read(resource.getStream(), Charset.forName("UTF-8"));
        JSONArray jsonArray = new JSONArray(jsonStr);
        return JSONUtil.toList(jsonArray, elementType);
    }
}
复制代码

  • 下载完成后，查看下文件，一个标准的Excel文件已经被导出了。

简单导入

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

  • 在Controller中添加会员信息导入的接口，这里需要注意的是使用@RequestPart注解修饰文件上传参数，否则在Swagger中就没法显示上传按钮了；
/**
 * 这里需要注意的是使用@RequestPart注解修饰文件上传参数，
 * 否则在Swagger中就没法显示上传按钮了；
 * @param file
 * @return
 */
@ApiOperation("从Excel导入会员列表")
@RequestMapping(value = "/importMemberList", method = RequestMethod.POST)
@ResponseBody
public ResponseResult importMemberList(@RequestPart("file") MultipartFile file) throws Exception {
    List<Member> memberList = easyPoiService.importMemberExcel(file);

    return ResponseResult.ok().data(memberList);
}
复制代码
  • 在service和serviceImpl添加对应的实现 service:
/**
 * 导入会员excel数据
 * @param file
 * @return
 */
List<Member> importMemberExcel(MultipartFile file) throws Exception;
复制代码

serviceImpl:

@Override
public List<Member> importMemberExcel(MultipartFile file) throws Exception {
    ImportParams importParams = new ImportParams();
    importParams.setTitleRows(1);
    importParams.setHeadRows(1);

    List<Member> list = ExcelImportUtil.importExcel(
            file.getInputStream(),
            Member.class, importParams);

    return list;
}
复制代码
  • 然后在Swagger中测试接口，选择之前导出的Excel文件即可，导入成功后会返回解析到的数据。

复杂导出

当然EasyPoi也可以实现更加复杂的Excel操作，比如导出一个嵌套了会员信息和商品信息的订单列表，下面我们来实现下！

  • 首先添加商品对象Product，用于封装商品信息；
package com.example.pojo;

import cn.afterturn.easypoi.excel.annotation.Excel;
import lombok.Data;
import lombok.EqualsAndHashCode;

import java.math.BigDecimal;

/**
 * 商品
 * 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就是我们需要导出的嵌套订单数据；
package com.example.pojo;

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

import lombok.Data;
import lombok.EqualsAndHashCode;

import java.sql.Date;
import java.util.List;

/**
 * 订单
 * 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方法排除掉；
@ApiOperation(value = "导出订单列表Excel")
@RequestMapping(value = "/exportOrderList", method = RequestMethod.GET)
public void exportOrderList(ModelMap modelMap,
                            HttpServletRequest request,
                            HttpServletResponse response) {
    modelMap = easyPoiService.exportOrderExcel(modelMap);
    PoiBaseView.render(modelMap, request, response, NormalExcelConstants.EASYPOI_EXCEL_VIEW);
}
复制代码

在service和serviceImpl中添加对应实现

service:

/**
 * 导出订单excel数据
 * @param modelMap
 * @return
 */
ModelMap exportOrderExcel(ModelMap modelMap);
复制代码

serviceImpl:

@Override
public ModelMap exportOrderExcel(ModelMap modelMap) {
    List<Order> orderList = getOrderList();
    ExportParams exportParams = new ExportParams("订单列表", "订单列表", ExcelType.XSSF);
    //导出时排除一些字段
    exportParams.setExclusions(new String[]{"ID", "出生日期", "性别"});
    modelMap.put(NormalExcelConstants.DATA_LIST, orderList);
    modelMap.put(NormalExcelConstants.CLASS, Order.class);
    modelMap.put(NormalExcelConstants.PARAMS, exportParams);
    modelMap.put(NormalExcelConstants.FILE_NAME, "orderList");

    return modelMap;
}

private List<Order> getOrderList() {
    List<Order> orderList = LocalJsonUtil.getListFromJson("json/orders.json", Order.class);
    List<Product> productList = LocalJsonUtil.getListFromJson("json/products.json", Product.class);
    List<Member> memberList = LocalJsonUtil.getListFromJson("json/members.json", Member.class);
    for (int i = 0; i < orderList.size(); i++) {
        Order order = orderList.get(i);
        order.setMember(memberList.get(i));
        order.setProductList(productList);
    }
    return orderList;
}
复制代码
  • 在Swagger中访问接口测试，导出订单列表对应Excel；

  • 下载完成后，查看下文件，EasyPoi导出复杂的Excel也是很简单的！

自定义处理

如果你想对导出字段进行一些自定义处理，EasyPoi也是支持的，比如在会员信息中，如果用户没有设置昵称，我们添加下暂未设置信息。

  • 我们需要添加一个处理器继承默认的ExcelDataHandlerDefaultImpl类，然后在exportHandler方法中实现自定义处理逻辑；
package com.example.util;

import cn.afterturn.easypoi.handler.impl.ExcelDataHandlerDefaultImpl;
import cn.hutool.core.util.StrUtil;
import com.example.pojo.Member;

/**
 * 自定义字段处理
 * 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设置自定义处理器；
@Override
public ModelMap exportMemberExcel(ModelMap modelMap) {
    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);
    modelMap.put(NormalExcelConstants.DATA_LIST, memberList);
    modelMap.put(NormalExcelConstants.CLASS, Member.class);
    modelMap.put(NormalExcelConstants.PARAMS, params);
    modelMap.put(NormalExcelConstants.FILE_NAME, "memberList");

    return modelMap;
}
复制代码
  • 再次调用导出接口，我们可以发现昵称已经添加默认设置了。

总结

体验了一波EasyPoi，它使用注解来操作Excel的方式确实非常好用。如果你想生成更为复杂的Excel的话，可以考虑下它的模板功能。

蒙奇D啊哈
关注
专栏目录
easypoi html转excel,全网最全最简单使用easypoi导入导出Excel的操作手册
weixin_32101685的博客
06-11 680
list;/*** 是否存在校验失败*/private boolean verfiyFail;/*** 数据源*/private Workbook workbook;```一个是集合,是一个是是否有校验失败的数据,一个原本的文档,但是在文档后面追加了错误信息注意,这里的list,有两种返回一种是只返回正确的数据一种是返回全部的数据,但是要求这个对象必须实现IExcelModel接口,如下**IE...
springboot+easypoi导入导出excel表
weixin_46883635的博客
01-18 2393
springboot+easypoi导入导出excel数据 1.导出数据 导入依赖 <!--easypoi依赖（表格导入导出）--> <dependency> <groupId>cn.afterturn</groupId> <artifactId>easypoi-spring-boot-starter</artifactId> &lt
easy-poi导入导出excel实例
03-15
easy-poi导入导出excel实例,包含所需jar包,可直接使用
EasyPoi实现简单的Excel导出、导入
2301_81922209的博客
04-17 1843
EasyPoi实现Excel导出、导入。下面这种方式不需要模板，更加方便但是不能进行复杂的导出。
使用easypoi根据Excel模板导出复杂Excel表 教程
最新发布
来一杯Java的博客
09-29 1478
前提：需要使用easypoi根据Excel模板导出复杂Excel表，表中有合并单元格，图片等内容。
easypoi Excel的导入导出（完整示例）
qq_14962815的博客
04-26 9058
EasyPoi教程_V1.01. 前言 - Powered by MinDoc。
EasyPoi实现excel文件导入导出
热门推荐
学习技术的路上不断沉淀自己
09-12 1万+
EasyPoi 学习实践 1 简介 easypoi功能如同名字easy,主打的功能就是容易,让一个没见接触过poi的人员 就可以方便的写出Excel导出,Excel模板导出,Excel导入,Word模板导出,通过简单的注解和模板 语言(熟悉的表达式语法),完成以前复杂的写法. gitee开源: https://gitee.com/lemur/easypoi 官方文档1: http://easypoi.mydoc.io/ 官方文档2: http://doc.wupaas.com/docs/easypoi/ea
EasyPoi（excel导入导出）
优秀的判断力来自经验，但经验来自于错误的判断
12-24 2823
这个是必须使用的注解,如果需求简单只使用这一个注解也是可以的,涵盖了常用的Excel需求,需要大家熟悉这个功能,主要分为基础,图片处理,时间处理,合并处理几块,name_id是上面讲的id用法,这里就不累言了。easypoi起因就是Excel的导入导出,最初的模板是实体和Excel的对应,model–row,filed–col 这样利用注解我们可以和容易做到excel到导入导出。校验字段,看看这个字段是不是导入的Excel中有,如果没有说明是错误的Excel,读取失败,支持name_id。
easypoi导入导出excel表格.pdf
07-19
在使用easypoi库进行Java项目的Excel表格导入导出时，开发者需要重视其依赖的引入，理解各注解的用途，以及能够解决使用过程中可能出现的类找不到或者依赖冲突等错误。另外，合理使用文档资源，跟进库的版本更新，也...
easypoi导入导出实例
10-24
在这个“easypoi导入导出实例”中，我们能够看到一个完整的项目示例，包括了必要的代码和一个名为"user.xls"的Excel模板文件，以及一个名为"easyPoi_demo"的演示程序。 1. **Easypoi基本概念** Easypoi的核心思想...
springm使用easypoi导入导出
12-25
现在让我们来看看如何在SpringMVC项目中集成并使用Easypoi实现数据的导入导出： 1. **集成Easypoi**：首先，你需要在你的项目中引入Easypoi的依赖。如果你使用的是Maven，可以在pom.xml文件中添加对应的依赖项，如...
使用EasyPoi进行对Excel表格的导入、导出
weixin_42326851的博客
04-07 1627
使用EasyPoi进行对Excel表格的导入、导出
使用EasyPoi导出Excel
qq_60676778的博客
07-14 1万+
springcloud导出easy poi，简单
EasyPio导入导出excel表格
weixin_58724261的博客
07-04 5281
EasyPoi是一个功能强大且易于使用的Java Excel操作框架。
使用easyPoi导出excel
泉眼和溪流的关系，大概是泉眼会被溪流一点一滴的占据
03-08 6659
引入依赖 <!-- easyPoi --> <dependency> <groupId>cn.afterturn</groupId> <artifactId>easypoi-base</artifactId> <version>3.0.3</version> </dependency> <dependency> <groupId>cn.a
easypoi导入excel
jah
12-06 8565
easypoi导入excel
easypoi 导出Excel
大哥的阔落
05-08 1281
复杂表头导出
使用EasyPoi实现Excel文件导入
m0_74268633的博客
03-14 1896
使用EasyPoi将Excel文件中的数据导入数据库并显示的实现过程。
easy-poi导入excel数据
greenhandp的博客
07-02 790
使用easy-poi导入excel数据
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值