EasyExcel的使用

官网：EasyExcel官方文档 - 基于Java的Excel处理工具 | Easy Excel (alibaba.com)

依赖

        
        <dependency>
            <groupId>com.alibabagroupId>
            <artifactId>easyexcelartifactId>
            <version>3.1.1version>
        dependency>

WEB中的使用

首先：写个模板类吧

package com.example.entity;
 
import com.alibaba.excel.annotation.ExcelIgnore;
import com.alibaba.excel.annotation.ExcelProperty;
import com.baomidou.mybatisplus.annotation.*;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
 
import java.io.Serializable;
import java.time.LocalDateTime;
 
/**
 * @TableName t_company
 */
@TableName(value = "t_company")
@Data
@ApiModel("企业实体类")
public class TCompany implements Serializable {
    /**
     * 主键
     */
    @TableId(value = "id", type = IdType.AUTO)
    @ApiModelProperty("主键")
    @ExcelIgnore
    private Integer id;
 
    /**
     * 用户名
     */
    @TableField(value = "user_name")
    @ApiModelProperty("企业用户名")
    @ExcelProperty("企业用户名")
    private String userName;
 
    /**
     * 登录密码
     */
    @TableField(value = "password")
    @ApiModelProperty("登陆密码")
    @ExcelIgnore
    private String password;
 
    /**
     * 企业名
     */
    @TableField(value = "name")
    @ApiModelProperty("企业真实名")
    @ExcelProperty("企业真实名")
    private String name;
 
    /**
     * 工商注册号
     */
    @TableField(value = "gszch")
    @ApiModelProperty("工商注册号")
    @ExcelIgnore
    private String gszch;
 
    /**
     * 营业执照
     */
    @TableField(value = "yyzz")
    @ApiModelProperty("营业执照")
    @ExcelIgnore
    private String yyzz;
 
    /**
     * 公司图标
     */
    @TableField(value = "img")
    @ApiModelProperty("公司图标")
    @ExcelIgnore
    private String img;
 
    /**
     * 公司规模
     */
    @TableField(value = "gsgm")
    @ApiModelProperty("公司规模")
    @ExcelProperty("公司规模")
    private String gsgm;
 
    /**
     * 公司行业
     */
    @TableField(value = "gshy")
    @ApiModelProperty("公司行业")
    @ExcelProperty("公司行业")
    private String gshy;
 
    /**
     * 联系人
     */
    @TableField(value = "contact")
    @ApiModelProperty("联系人")
    @ExcelProperty("联系人")
    private String contact;
 
    /**
     * 联系电话
     */
    @TableField(value = "phone")
    @ApiModelProperty("联系电话")
    @ExcelProperty("联系电话")
    private String phone;
 
    /**
     * 公司介绍
     */
    @TableField(value = "company_desc")
    @ApiModelProperty("公司介绍")
    @ExcelProperty("公司介绍")
    private String companyDesc;
 
    /**
     * 公司地址
     */
    @TableField(value = "address")
    @ApiModelProperty("公司地址")
    @ExcelProperty("公司地址")
    private String address;
 
    /**
     * 审核状态
     */
    @TableField(value = "audit_status")
    @ApiModelProperty("审核状态")
    @ExcelIgnore
    private Integer auditStatus;
 
    /**
     * 注册时间
     */
    @TableField(value = "create_time", fill = FieldFill.INSERT)
    @ApiModelProperty("注册时间")
    @ExcelIgnore
    private LocalDateTime createTime;
 
    /**
     * 更新时间
     */
    @TableField(value = "update_time", fill = FieldFill.INSERT_UPDATE)
    @ApiModelProperty("更新时间")
    @ExcelIgnore
    private LocalDateTime updateTime;
 
 
    @TableField(exist = false)
    private static final long serialVersionUID = 1L;
}

最好使用注解,会自动对应我们的数据

读操作：

这里输入的参数讲解一下下，file.getInputStream(), 是前端上传的一个临时文件，我们获取他的一个输入流，TManger.class,是我们的一个实体类对象 

new myListener(companyServiice))是我们的一个监听器，传递了一个service进去，可以看监听器的代码，传进去的目的就是，监听器里直接调用service的存储数据库操作

.sheet()，是模板名称，不是文件名称

.doRead();读

 /**
     * 文件上传
     * 
     * 1. 创建excel对应的实体对象 参照{@link UploadData}
     * 
     * 2. 由于默认一行行的读取excel，所以需要创建excel一行一行的回调监听器，参照{@link UploadDataListener}
     * 
     * 3. 直接读即可
     */
    @PostMapping("upload")
    @ResponseBody
    public String upload(MultipartFile file) throws IOException {
        EasyExcel.read(file.getInputStream(), UploadData.class, new UploadDataListener(uploadDAO)).sheet().doRead();
        return "success";

监听器：

package com.example.common;
 
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.read.listener.ReadListener;
import com.alibaba.excel.util.ListUtils;
import com.alibaba.fastjson2.JSON;
import com.example.entity.TManger;
import com.example.service.TMangerService;
import com.example.service.impl.TMangerServiceImpl;
import lombok.extern.slf4j.Slf4j;
 
import java.util.List;
 
@Slf4j
public class myListener implements ReadListener {
 
 
    /**
     * 每隔5条存储数据库，实际使用中可以100条，然后清理list ，方便内存回收
     */
    private static final int BATCH_COUNT = 100;
    /**
     * 缓存的数据
     */
    private List cachedDataList = ListUtils.newArrayListWithExpectedSize(BATCH_COUNT);
    /**
     * 假设这个是一个DAO，当然有业务逻辑这个也可以是一个service。当然如果不用存储这个对象没用。
     */
    private TMangerService mangerService;
 
    public myListener() {
        // 这里是demo，所以随便new一个。实际使用如果到了spring,请使用下面的有参构造函数
        mangerService = new TMangerServiceImpl();
    }
 
    /**
     * 如果使用了spring,请使用这个构造方法。每次创建Listener的时候需要把spring管理的类传进来
     *
     * @param demoDAO
     */
    public myListener(TMangerServiceImpl demoDAO) {
        this.mangerService = demoDAO;
    }
 
    /**
     * 这个每一条数据解析都会来调用
     *
     * @param data    one row value. Is is same as {@link AnalysisContext#readRowHolder()}
     * @param context
     */
    @Override
    public void invoke(TManger data, AnalysisContext context) {
        log.info("解析到一条数据:{}", JSON.toJSONString(data));
        cachedDataList.add(data);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (cachedDataList.size() >= BATCH_COUNT) {
            saveData();
            // 存储完成清理 list
            cachedDataList = ListUtils.newArrayListWithExpectedSize(BATCH_COUNT);
        }
    }
 
    /**
     * 所有数据解析完成了 都会来调用
     *
     * @param context
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里也要保存数据，确保最后遗留的数据也存储到数据库
        saveData();
        log.info("所有数据解析完成！");
    }
 
    /**
     * 加上存储数据库
     */
    private void saveData() {
        log.info("{}条数据，开始存储数据库！", cachedDataList.size());
        mangerService.saveBatch(cachedDataList);
        log.info("存储数据库成功！");
    }
}

操作读

    /**
     * 文件上传
     * 
     * 1. 创建excel对应的实体对象 参照{@link UploadData}
     * 
     * 2. 由于默认一行行的读取excel，所以需要创建excel一行一行的回调监听器，参照{@link UploadDataListener}
     * 
     * 3. 直接读即可
     */
    @PostMapping("upload")
    @ResponseBody
    public String upload(MultipartFile file) throws IOException {
        EasyExcel.read(file.getInputStream(), UploadData.class, new UploadDataListener(uploadDAO)).sheet().doRead();
        return "success";
    }

监听器的异常处理：

    /**
     * 在转换异常 获取其他异常下会调用本接口。抛出异常则停止读取。如果这里不抛出异常则 继续读取下一行。
     *
     * @param exception
     * @param context
     * @throws Exception
     */
    @Override
    public void onException(Exception exception, AnalysisContext context) {
        log.error("解析失败，但是继续解析下一行:{}", exception.getMessage());
        // 如果是某一个单元格的转换异常 能获取到具体行号
        // 如果要获取头的信息 配合invokeHeadMap使用
        if (exception instanceof ExcelDataConvertException) {
            ExcelDataConvertException excelDataConvertException = (ExcelDataConvertException)exception;
            log.error("第{}行，第{}列解析异常，数据为:{}", excelDataConvertException.getRowIndex(),
                excelDataConvertException.getColumnIndex(), excelDataConvertException.getCellData());
        }
    }

这里的意思，应该是说，额，当一行数据解释失败的话，会打印出第几行解析失败，但是会继续解析，如果我们在方法里去抛出异常，就会停止解析

 看到了吗，他的默认方法时直接抛出异常，我们重写，就不抛出异常，这样他就一直读了

写操作

    /**
     * 文件下载（失败了会返回一个有部分数据的Excel）
     * 
     * 1. 创建excel对应的实体对象 参照{@link DownloadData}
     * 
     * 2. 设置返回的 参数
     * 
     * 3. 直接写，这里注意，finish的时候会自动关闭OutputStream,当然你外面再关闭流问题不大
     */
    @GetMapping("download")
    public void download(HttpServletResponse response) throws IOException {
        // 这里注意 有同学反应使用swagger 会导致各种问题，请直接用浏览器或者用postman
        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        response.setCharacterEncoding("utf-8");
        // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
        String fileName = URLEncoder.encode("测试", "UTF-8").replaceAll("\\+", "%20");
        response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
        EasyExcel.write(response.getOutputStream(), DownloadData.class).sheet("模板").doWrite(data());
    }

这个前面都时一些协议设置啥的，那个”测试“，时生成的文件名，还有最后的写操作，其他不关我们事

失败情况：

    /**
     * 文件下载并且失败的时候返回json（默认失败了会返回一个有部分数据的Excel）
     *
     * @since 2.1.1
     */
    @GetMapping("downloadFailedUsingJson")
    public void downloadFailedUsingJson(HttpServletResponse response) throws IOException {
        // 这里注意 有同学反应使用swagger 会导致各种问题，请直接用浏览器或者用postman
        try {
            response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
            response.setCharacterEncoding("utf-8");
            // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
            String fileName = URLEncoder.encode("测试", "UTF-8").replaceAll("\\+", "%20");
            response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
            // 这里需要设置不关闭流
            EasyExcel.write(response.getOutputStream(), DownloadData.class).autoCloseStream(Boolean.FALSE).sheet("模板")
                .doWrite(data());
        } catch (Exception e) {
            // 重置response
            response.reset();
            response.setContentType("application/json");
            response.setCharacterEncoding("utf-8");
            Map map = MapUtils.newHashMap();
            map.put("status", "failure");
            map.put("message", "下载文件失败" + e.getMessage());
            response.getWriter().println(JSON.toJSONString(map));
        }
    }

看的懂吗，翻译一下，就是说当遇到解析不了的数据时，就会抛出异常，然后我们可以捕获这个异常，给他处理方式就是，在输出的Excel尾部加上Sorry,解析失败了。但是上面成功解析的还是会输出的

以上没有测试，不想改我的代码，摆烂，但是，我感觉我看文档理解到的就是我要说的，然后这些代码都是直接官网复制的，哈哈