EasyExcel学习笔记

最新推荐文章于 2023-04-20 11:06:28 发布
最新推荐文章于 2023-04-20 11:06:28 发布
阅读量931 收藏 17
点赞数 2
分类专栏： # Java学习笔记 文章标签： javascript java easyexcel alibaba
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/A233666/article/details/120590285
版权

EasyExcel使用经验

视频教程：2小时快速掌握EasyExcel报表导入导出-黑马程序员杭州校区出品

参考博客：Alibaba-EasyExcel-简单高效完成Excel报表导入导出)

说明：参考的博客是基于课程讲师提前做好的资料进行整理；本文章是基于老师课上的内容、案例进行整理，并在此基础上增加了自己的理解

文章目录

有过报表导入导出经验的同学，应该听过或者使用POI，对其又爱又恨，爱的是帮你实现Office文档的导入导出，恨得的不好用。本文将带着你轻松高效高性能的实现Excel报表的导入导出，期间会结合优雅编程Lombok，让你的更轻松优雅的完成甲方爸爸的需求。

一、初识EasyExcel

1. Apache POI

先说POI，有过报表导入导出经验的同学，应该听过或者使用。

Apache POI是Apache软件基金会的开源函式库，提供跨平台的Java API实现Microsoft Office格式档案读写。但是存在如下一些问题：

1.1 学习使用成本较高

对POI有过深入了解的才知道原来POI还有SAX模式（Dom解析模式）。但SAX模式相对比较复杂，excel有03和07两种版本，两个版本数据存储方式截然不同，sax解析方式也各不一样。

想要了解清楚这两种解析方式，才去写代码测试，估计两天时间是需要的。再加上即使解析完，要转换到自己业务模型还要很多繁琐的代码。总体下来感觉至少需要三天，由于代码复杂，后续维护成本巨大。

POI的SAX模式的API可以一定程度的解决一些内存溢出的问题，但是POI还是有一些缺陷，比如07版Excel解压缩以及解压后存储都是在内存中完成的，内存消耗依然很大，一个3M的Excel用POI的SAX解析，依然需要100M左右内存。

1.2 POI的内存消耗较大

大部分使用POI都是使用他的userModel模式。userModel的好处是上手容易使用简单，随便拷贝个代码跑一下，剩下就是写业务转换了，虽然转换也要写上百行代码，相对比较好理解。然而userModel模式最大的问题是在于非常大的内存消耗，一个几兆的文件解析要用掉上百兆的内存。现在很多应用采用这种模式，之所以还正常在跑一定是并发不大，并发上来后一定会OOM或者频繁的full gc。

总体上来说，简单写法重度依赖内存，复杂写法学习成本高。

特点
  1. 功能强大
  2. 代码书写冗余繁杂
  3. 读写大文件耗费内存较大，容易OOM

2. EasyExcel

2.1 重写了POI对07版Excel的解析
  • EasyExcel重写了POI对07版Excel的解析，可以把内存消耗从100M左右降低到10M以内，并且再大的Excel不会出现内存溢出，03版仍依赖POI的SAX模式。
  • 下图为64M内存1分钟内读取75M(46W行25列)的Excel（当然还有急速模式能更快，但是内存占用会在100M多一点）

  • 在上层做了模型转换的封装，让使用者更加简单方便
特点
  1. 在数据模型层面进行了封装，使用简单
  2. 重写了07版本的Excel的解析代码，降低内存消耗，能有效避免OOM
  3. 只能操作Excel
  4. 不能读取图片
  5. 使用程序读写excel，数据在excel文件、程序<实体类、Map>这两个载体中间相互流转。

优雅编程 lombok

二、快速入门

0、导入依赖坐标

<!-- EasyExcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>2.1.6</version>
</dependency>
<!-- lombok 优雅编程 -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.10</version>
</dependency>
<!-- junit -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>

导入easyexcel-2.1.6坐标的时候，以依赖传递导入poi-3.17的POI。

1、最简单的读

1.1、需求、准备工作

准备Excel表格

image-20211002193108074

1.2、编写导出数据的实体
@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
public class Student {
    private String name;
    private String gender;
    private Date birthday;
    private String id;
}
1.3、读取Excel文件

调用EasyExcel的API读取的Excel文件的测试类StudentReadDemo

/**
 * 测试 EasyExcel的简单读写
 */
public class Test01_StudentRead {
    public static void main(String[] args) {
        
        String fileanme="briup学员表.xlsx";
        
        // 读取文件，读取完之后会自动关闭
        // 封装工作簿对象
        //参数说明：pathName 文件路径，head 每行数据对应的实体的Class，readListener 读监听器，每读一样就会调用一次该监听器的invoke方法
        ExcelReaderBuilder workBook = EasyExcel.read(fileanme, Student.class,new StudentReadListener());

        // 封装工作表
        //sheet方法参数： 工作表(对应Excel中的Sheet)的顺序号（从0开始）或者工作表的名字，不传默认为0
        ExcelReaderSheetBuilder sheet1 = workBook.sheet();
        // 读取
        sheet1.doRead();
    }
}

创建读取Excel的监听器，用于处理读取产生的数据

public class StudentReadListener extends AnalysisEventListener<Student> {

    // 每读一行会调用该invoke方法一次
    @Override
    public void invoke(Student data, AnalysisContext context) {
        System.out.println(data.toString());
    }

    //读取表头内容
    @Override
    public void invokeHeadMap(Map<Integer, String> headMap, AnalysisContext context) {
        System.out.println("表头："+headMap);
    }

    // 全部读完之后，会调用该方法
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        System.out.println("全部数据都已经读取完毕!!!");
    }
}

2、最简单的写

2.1、需求、准备工作
2.2、编写导出数据的实体
@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
public class Student {
    private String name;
    private String gender;
    private Date birthday;
    private String id;
}
2.3、准备数据并写入到文件
public class Test02_StudentWrite {
    public static void main(String[] args) {
        //准备数据
        List<Student> students = initData();
        //String pathName 写入文件的路径，Class head 写入文件的对象类型
        ExcelWriterBuilder workBook = EasyExcel.write("briup学员表.xlsx", Student.class);
        // sheet方法参数： 工作表的顺序号（从0开始）或者工作表的名字
        ExcelWriterSheetBuilder sheet = workBook.sheet();
        //向 Sheet中写数据
        sheet.doWrite(students);
    }

    private static List<Student> initData() {
        ArrayList<Student> arrayList = new ArrayList<Student>();
        for (int i = 0; i < 10; i++) {
            Student student = new Student();
            student.setName("学生"+i);
            student.setGender("男");
            student.setBirthday(new Date());
            arrayList.add(student);
        }
        return arrayList;
    }
}

image-20211002192445112

2.4、一些注解的简单使用

自定义表头，自定义列宽，自定义行高，修改列的插入顺序，日期格式，忽略某一列 @ExcelIgnore

如果index设置不是连续的，则会在Excel中为空缺的index创建空的一列

修改实体类

@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
//@ContentRowHeight(20)//为整张表设置每一行行高
//@HeadRowHeight(20)//为这张表设置表头的行高
public class Student {

    @ExcelProperty(value = "学生姓名",index = 1)
    private String name;

    @ExcelProperty(value = "学生性别",index = 2)
    private String gender;

    @ExcelProperty(value = "出生日期",index = 3)
    @ColumnWidth(20) //设置行宽，可以用在类上，属性上
    @DateTimeFormat("yyyy-MM-dd")
    private Date birthday;

    //index 从0开始，这表示在Excel中的第一列
    @ExcelProperty(value = "学生ID",index = 0)
    private String id;
}

image-20211002195523852

分割单元格与合并单元格

案例1:

    @ExcelProperty(value = {"学生性别","学生信息表"},index = 2)
    private String gender;

image-20211002195839760

案例2:

@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
//@ContentRowHeight(20)//为整张表设置每一行行高
//@HeadRowHeight(20)//为这张表设置表头的行高
public class Student {

    @ExcelProperty(value = {"学生信息表","学生姓名"},index = 1)
    private String name;

    @ExcelProperty(value = {"学生信息表","学生性别"},index = 2)
    private String gender;

    @ExcelProperty(value = {"学生信息表","出生日期"},index = 3)
    @ColumnWidth(20) //设置行宽，可以用在类上，属性上
    @DateTimeFormat("yyyy-MM-dd")
    private Date birthday;

    //index 从0开始，这表示在Excel中的第一列
    @ExcelProperty(value = {"学生信息表","学生ID"},index = 0)
    private String id;
}

image-20211002200012909

三、文件的上传和下载

上文，我们完成了简单的导入导出，但是是单体环境的读和写。实际成产环境一般都在web环境中，那我们这篇就结合SpringMVC实现文件上传和下载。请在保证熟悉SpringMVC相关知识后食用。

1、准备工作

基于SpringMVC的文件上传和下载

0. 导入依赖

<!-- EasyExcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>2.0.5</version>
</dependency>
<!-- lombok -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.10</version>
    <scope>provided</scope>
</dependency>
<!-- junit -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-nop</artifactId>
    <version>1.7.2</version>
</dependency>
<!-- SpringMVC（Spring） -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.0.5.RELEASE</version>
</dependency>
<!-- Servlet -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>
<!-- 文件上传 -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

2、文件上传

编写excel中每一行对应的实体类

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Student {
    private String name;
    private String gender;
    private Date birthday;
    private String id;
}

编写回调监听器 StudentReadListener

@Component
@Scope("prototype") // 作用域：多实例，根据作者要求每次读取都要使用新的Listener
public class StudentReadListener extends AnalysisEventListener<Student> {

    @Autowired
    private StudentService studentService;

    private final int BATCH_SAVE_NUM = 5;
    ArrayList<Student> students = new ArrayList<>();

    private int count = 0;

    // 每读一样，会调用该invoke方法一次
    @Override
    public void invoke(Student data, AnalysisContext context) {
        students.add(data);
        if (++count % BATCH_SAVE_NUM == 0) {
            studentService.save(students);
            students.clear();
        }
    }

    // 全部读完之后，会调用该方法
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // TODO......
    }
}

业务代码接口StudentService 和 实现类StudentServiceImpl

public interface StudentService {
    void save(ArrayList<Student> students);
}

@Service
public class StudentServiceImpl implements StudentService {
    @Override
    public void save(ArrayList<Student> students) {
        System.out.println("students in service = " + students);
    }
}

Spring配置文件

<!-- 组件扫描-->
<context:component-scan base-package="net.sunxiaowei"/>

SpringMVC配置文件

<!-- 组件扫描-->
<context:component-scan base-package="net.sunxiaowei.demo"/>

<!-- MVC文件上传多部件解析器 -->
<bean class="org.springframework.web.multipart.commons.CommonsMultipartResolver"
      id="multipartResolver"/>

编码读取上传的Excel文件

@Controller
public class WebUploadAndDownload {
    /**
     * 文件上传
     * 1. 编写excel中每一行对应的实体类
     * 2. 由于默认异步读取excel，所以需要逐行读取的回调监听器
     * 3. 开始读取Excel
     */
    @PostMapping("upload")
    @ResponseBody
    public String upload(MultipartFile file) throws IOException {
        ExcelReaderBuilder workBook = EasyExcel.read(file.getInputStream(), Student.class, studentReadListener);
        workBook.sheet().doRead();
        return "success";
    }

3、文件下载

编写实体类并创建对象以便写入表格

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Student {

    @ExcelIgnore
    private String id;

    //@ExcelProperty({"学员信息表", "学生姓名"})
    @ExcelProperty("学生姓名")
    private String name;

    //@ExcelProperty({"学员信息表", "学生性别"})
    @ExcelProperty("学生性别")
    private String gender;

    //@ExcelProperty({"学员信息表", "学生出生日期"})
    @ExcelProperty("学生出生日期")
    private Date birthday;
}

// 循环生成10个学生对象
private static List<Student> initData() {
    ArrayList<Student> students = new ArrayList<>();
    for (int i = 0; i < 10; i++) {
        Student data = new Student();
        data.setName("模拟学号0" + i);
        data.setBirthday(new Date());
        data.setGender("男");
        students.add(data);
    }
    return students;
}

编码将数据写入到响应体实现下载

public class WebUploadAndDownload {

    /**
     * 文件下载
     * 1. 编写实体类并创建对象以便写入表格
     * 2. 设置响应参数：文件的ContentType和文件名，同时设置编码避免乱码
     * 3. 直接写，内部会调用finish方法自动关闭OutputStream
     */
    @GetMapping("download")
    public void download(HttpServletResponse response) throws IOException {
        response.setContentType("application/vnd.ms-excel");
        response.setCharacterEncoding("utf-8");
        // 防止中文乱码 
        String fileName = URLEncoder.encode("测试", "UTF-8");
        response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''" + fileName + ".xlsx");
        ExcelWriterBuilder workBook = EasyExcel.write(response.getOutputStream(), Student.class);

        ExcelWriterSheetBuilder sheet = workBook.sheet("模板");

        sheet.doWrite(initData());
    }
}

四、模板填充：自定义单元格样式

EasyExcel支持调整行高、列宽、背景色、字体大小等内容，但是控制方式与使用原生POI无异，比较繁琐，不建议使用。

但是可以使用模板填充的方式，向预设样式的表格中直接写入数据，写入数据的时候会保持原有样式。

原生POI控制操作Excel很冗余繁杂，EasyExcel也不能免俗；但是如果不设置样式，Excel的样式又太素了。所以在工作中最常见的方式就是使用模板，模板中的所有样式都已经设置好了，只需要把需要的数据填充到设置好样式的模板中。

1、填充一组数据

1.1 准备模板

Excel表格中用{} 来包裹要填充的变量，如果单元格文本中本来就有{、}左右大括号，需要在括号前面使用斜杠转义\{、\}。

代码中用来填充数据的实体对象的成员变量名或被填充map集合的key需要和Excel中被{}包裹的变量名称一致。

image-20211002214855239

操作后Excel表中的样式不会被改变

1.2 封装数据

编写封装填充数据的类或选用Map

/**
 * 使用实体类封装填充数据
 *  实体中成员变量名称需要和Excel表各种{}包裹的变量名匹配
 */
@Data
public class FillData {
    private String name;
    private int age;
}
1.3 填充

使用对象的方式

    /**
     * 单组填充
     */
    @Test
    public void test01(){
        //1.准备模板
        String templateFile="briup学员表-demo01.xlsx";
        //2.创建工作簿对象：参数列表：目标文件，模板类对象，，，模板文件
        ExcelWriterBuilder excelWriterBuilder = EasyExcel.write("单组数据填充.xlsx",FillData.class).withTemplate(templateFile);
        //3.创建工作表对象
        ExcelWriterSheetBuilder sheet = excelWriterBuilder.sheet();

        //4.准备填充的数据：使用对象的方式
        FillData fillData=new FillData();
        fillData.setName("张三");
        fillData.setAge(18);

        //5.填充，doWrite会自动关闭流
        sheet.doFill(fillData);

    }

使用Map的方式

    /**
     * 单组填充，使用Map
     */
    @Test
    public void test001(){
        //1.准备模板
        String templateFile="briup学员表-demo01.xlsx";
        //2.创建工作簿对象
        ExcelWriterBuilder excelWriterBuilder = EasyExcel.write("单组数据填充.xlsx",FillData.class).withTemplate(templateFile);
        //3.创建工作表对象
        ExcelWriterSheetBuilder sheet = excelWriterBuilder.sheet();

        //4.准备填充的数据：使用Map的方式
        Map<String,Object> map=new HashMap<>();
        map.put("name","张三");
        map.put("age",18);

        //5.填充，doWrite会自动关闭流
        sheet.doFill(map);

    }
1.4 效果

image-20211002215005584

2、填充多组数据

2.1 准备模板

Excel表格中用{.}来表示包裹要填充的变量，如果单元格文本中本来就有{、}左右大括号，需要在括号前面使用斜杠转义\{ 、\}。

代码中被填充数据的实体对象的成员变量名或被填充map集合的key需要和Excel中被{}包裹的变量名称一致。

image-20211002215500795

2.2 封装数据

编写封装填充数据的类或选用Map

// 同上
2.3 填充

准备数据并填充到文件

   /**
     * 多组填充
     */
    @Test
    public void test02() {
        //1.准备模板
        String templateFile = "briup学员表-demo02.xlsx";
        //2.创建工作簿对象
        ExcelWriterBuilder excelWriterBuilder = EasyExcel.write("多组数据填充.xlsx",
                FillData.class).withTemplate(templateFile);
        //3.创建工作表对象
        ExcelWriterSheetBuilder sheet = excelWriterBuilder.sheet();

        //4.准备填充的数据：多组数据
        List<FillData> fillData = initFillData();

        //5.填充，doWrite会自动关闭流
        sheet.doFill(fillData);

    }


    //生成多组数据代码
    private static List<FillData> initFillData() {
        ArrayList<FillData> fillDatas = new ArrayList<FillData>();
        for (int i = 0; i < 10; i++) {
            FillData fillData = new FillData();
            fillData.setName("学生" + i);
            fillData.setAge(10 + i);
            fillDatas.add(fillData);
        }
        return fillDatas;
    }
2.4 效果

image-20211002215933987

3、组合填充

3.1 准备模板

即有多组数据填充，又有单一数据填充，为了避免两者数据出现冲突覆盖的情况，在多组填充时需要通过FillConfig对象设置换行。

image-20211002220200724

3.2 封装数据

编写封装填充数据的类或选用Map

// 同上
3.3 填充：错误演示

注意：使用组合填充时API已经发生了改变

准备数据并填充到文件

    /**
     * 组合填充（错误演示）
     */
    @Test
    public void test03() {
        //1.准备模板
        String templateFile = "briup学员表-demo03.xlsx";
        //2.创建工作簿对象
        ExcelWriter workBook = EasyExcel.write("组合数据填充.xlsx",
                FillData.class).withTemplate(templateFile).build();
        //3.创建工作表对象
        WriteSheet sheet = EasyExcel.writerSheet().build();

        //4.准备填充的数据：多组数据
        List<FillData> fillData = initFillData();
        //6.多组填充
        workBook.fill(fillData,sheet);

        //7.准备填充的数据：单组数据
        Map<String,Object> map=new HashMap<>();
        map.put("date","2021/10/2");
        map.put("total",10000);
        //8.单组填充
        workBook.fill(map,sheet);

        //9.自己关闭流
        workBook.finish();
    }

效果：填充的单行数据没有出现再我们预期的位置

image-20211002221307992

解决：添加换行

3.4 填充：添加换行

核心代码

        //组合填充时，因为多组填充的数量不确定，需要在多组填充完之后另起一行
        FillConfig fillConfig=FillConfig.builder().forceNewRow(true).build();
        //6.多组填充,并换行
        workBook.fill(fillData,fillConfig,sheet);

完整代码

    /**
     * 组合填充（错误演示）
     */
    @Test
    public void test04() {
        //1.准备模板
        String templateFile = "briup学员表-demo03.xlsx";
        //2.创建工作簿对象
        ExcelWriter workBook = EasyExcel.write("组合数据填充.xlsx",
                FillData.class).withTemplate(templateFile).build();
        //3.创建工作表对象
        WriteSheet sheet = EasyExcel.writerSheet().build();

        //组合填充时，因为多组填充的数量不确定，需要在多组填充完之后另起一行
        FillConfig fillConfig=FillConfig.builder().forceNewRow(true).build();

        //4.准备填充的数据：多组数据
        List<FillData> fillData = initFillData();
        //6.多组填充,并换行
        workBook.fill(fillData,fillConfig,sheet);

        //7.准备填充的数据：单组数据
        Map<String,Object> map=new HashMap<>();
        map.put("date","2021/10/2");
        map.put("total",10000);
        //8.单组填充
        workBook.fill(map,sheet);

        //9.自己关闭流
        workBook.finish();
    }

image-20211002221934424

4、水平填充

4.1 准备模板

水平填充和多组填充模板一样，不一样的地方在于，填充时需要通过FillConfig对象设置水平填充。

image-20211002222937717

4.2 封装数据

编写封装填充数据的类或选用Map

// 同上
4.3 填充

准备数据并填充到文件

    /**
     * 水平填充
     */
    @Test
    public void test05() {
        //1.准备模板
        String templateFile = "briup学员表-demo04.xlsx";
        //2.创建工作簿对象
        ExcelWriter workBook = EasyExcel.write("水平数据填充.xlsx",
                FillData.class).withTemplate(templateFile).build();
        //3.创建工作表对象
        WriteSheet sheet = EasyExcel.writerSheet().build();

        //
        FillConfig fillConfig = FillConfig.builder().direction(WriteDirectionEnum.HORIZONTAL).build();

        //4.准备填充的数据：多组数据
        List<FillData> fillData = initFillData();
        //6.多组填充,并换行
        workBook.fill(fillData,fillConfig,sheet);

        //7.准备填充的数据：单组数据
        Map<String,Object> map=new HashMap<>();
        map.put("date","2021/10/2");
        map.put("total",10000);
        //8.单组填充
        workBook.fill(map,sheet);

        //9.自己关闭流
        workBook.finish();
    }

image-20211002223206294

5、注意事项

为了节省内存，所以没有采用把整个文档在内存中组织好之后再整体写入到文件的做法，而是采用的是一行一行写入的方式，不能实现删除和移动行，也不支持备注写入。多组数据写入的时候，如果需要新增行，只能在最后一行增加，不能在中间位置添加。

6、填充综合练习

image-20211002224917276

6.1 准备
@Data
public class FillData {
    private String name;
    private int age;
}


@Data
public class Student {
    private String name;
    private String gender;
    private Date birthday;
    private String id;
}
6.2 综合案例
    /**
     * 综合案例
     */
    @Test
    public void test06() {
        //1.准备模板
        String templateFile = "baobiaodemo.xlsx";
        //2.创建工作簿对象
        ExcelWriter workBook = EasyExcel.write("综合案例.xlsx",
                FillData.class).withTemplate(templateFile).build();
        //3.创建工作表对象
        WriteSheet sheet = EasyExcel.writerSheet().build();

        // ****** 准备数据 *******
        // 日期
        HashMap<String, String> dateMap = new HashMap<String, String>();
        dateMap.put("date", "2021/10/2");

        // 总会员数
        HashMap<String, String> totalCountMap = new HashMap<String, String>();
        dateMap.put("totalCount", "1000");

        // 新增员数
        HashMap<String, String> increaseCountMap = new HashMap<String, String>();
        dateMap.put("increaseCount", "100");

        // 本周新增会员数
        HashMap<String, String> increaseCountWeekMap = new HashMap<String, String>();
        dateMap.put("increaseCountWeek", "50");

        // 本月新增会员数
        HashMap<String, String> increaseCountMonthMap = new HashMap<String, String>();
        dateMap.put("increaseCountMonth", "100");

        // 新增会员数据
        List<Student> students = initData();
        // **** 准备数据结束****

        // 写入统计数据
        workBook.fill(dateMap, sheet);
        workBook.fill(totalCountMap, sheet);
        workBook.fill(increaseCountMap, sheet);
        workBook.fill(increaseCountWeekMap, sheet);
        workBook.fill(increaseCountMonthMap, sheet);

        // 写入新增会员
        workBook.fill(students, sheet);
        workBook.finish();


        //9.自己关闭流
        workBook.finish();
    }


    //生成多组数据代码
    private static List<Student> initData() {
        ArrayList<Student> arrayList = new ArrayList<Student>();
        for (int i = 0; i < 10; i++) {
            Student student = new Student();
            student.setName("会员"+i);
            student.setGender("男");
            student.setBirthday(new Date());
            arrayList.add(student);
        }
        return arrayList;
    }

image-20211002225006863

五、常用API及注解

1、常用类

  • EasyExcel 入口类，用于构建各种对象、开始各种操作；
  • ExcelReaderBuilder 构建出一个ReadWorkbook对象，即一个工作簿对象，对应的是一个Excel文件；
  • ExcelWriterBuilder 构建出一个WriteWorkbook对象，即一个工作簿对象，对应的是一个Excel文件；
  • ExcelReaderSheetBuilder 构建出一个ReadSheet对象，即一个工作表的对象，对应的Excel中的每个sheet，一个工作簿可以有多个工作表；
  • ExcelWriterSheetBuilder 构建出一WriteSheet对象，即一个工作表的对象，对应的Excel中的每个sheet，一个工作簿可以有多个工作表；
  • ReadListener 在每一行读取完毕后都会调用ReadListener来处理数据，我们可以把调用service的代码可以写在其invoke方法内部；
  • WriteHandler 在每一个操作包括创建单元格、创建表格等都会调用WriteHandler来处理数据，对使用者透明不可见；
  • 所有配置都是继承的 Workbook的配置会被Sheet继承。所以在用EasyExcel设置参数的时候，在EasyExcel…sheet()方法之前作用域是整个workBook的所有sheet，之后针对单个sheet。

2、读取时的注解

@ExcelProperty

使用位置：标准作用在成员变量上，把实体类中属性和excel表中列关联起来

可选属性：

属性名含义说明
index对应Excel表中的列数默认-1，建议指定时从0开始
value对应Excel表中的列头
converter成员变量转换器自定义转换器需要实Converter接口

使用效果：index属性可以指定当前字段对应excel中的哪一列，可以根据列名value去匹配，也可以不写。

如果不使用@ExcelProperty注解，成员变量从上到下的顺序，对应表格中从左到右的顺序；

**使用建议：**要么全部不写，要么全部用index，要么全部用value去匹配，尽量不要三个混着用。

@ExcelIgnore

标注在成员变量上，默认所有字段都会和excel去匹配，加了这个注解会忽略该字段

@DateTimeFormat

标注在成员变量上，日期转换，代码中用String类型的成员变量去接收excel中日期格式的数据会调用这个注解。里面的value参照java.text.SimpleDateFormat

@NumberFormat

标注在成员变量上，数字转换，代码中用String类型的成员变量去接收excel数字格式的数据会调用这个注解。里面的value参照java.text.DecimalFormat

@ExcelIgnoreUnannotated

标注在类上。

不标注该注解时，默认类中所有成员变量都会参与读写，无论是否在成员变量上加了@ExcelProperty 的注解。

标注该注解后，类中的成员变量如果没有标注@ExcelProperty 注解将不会参与读写。

3、 读取时通用参数

ReadWorkbook,ReadSheet 都会有的参数，如果为空，默认使用上级。

  • converter 转换器，默认加载了很多转换器。也可以自定义。
  • readListener 监听器，在读取数据的过程中会不断的调用监听器。
  • headRowNumber 指定需要读表格的 列头行数。默认有一行头，也就是认为第二行开始起为数据。
  • head 与clazz二选一。读取文件头对应的列表，会根据列表匹配数据。建议使用class，就是文件中每一行数据对应的代码中的实体类型。
  • clazz 与head二选一。读取文件的头对应的class，也可以使用注解。如果两个都不指定，则会读取全部数据。
  • autoTrim 字符串、表头等数据自动trim
  • password 读的时候是否需要使用密码

4、ReadWorkbook（工作簿对象）参数

  • excelType 当前excel的类型，读取时会自动判断，无需设置。
  • inputStream 与file二选一。建议使用file。
  • file 与inputStream二选一。读取文件的文件。
  • autoCloseStream 自动关闭流。
  • readCache 默认小于5M用 内存，超过5M会使用 EhCache，不建议使用这个参数。
  • useDefaultListener @since 2.1.4 默认会加入ModelBuildEventListener 来帮忙转换成传入class的对象，设置成false后将不会协助转换对象，自定义的监听器会接收到Map<Integer,CellData>对象，如果还想继续接听到class对象，请调用readListener方法，加入自定义的beforeListener、 ModelBuildEventListener、 自定义的afterListener即可。

5、ReadSheet（工作表对象）参数

  • sheetNo 需要读取Sheet的编号，建议使用这个来指定读取哪个Sheet
  • sheetName 根据名字去匹配Sheet，excel 2003不支持根据名字去匹配

6、写入时的注解注解

@ExcelProperty

使用位置：标准作用在成员变量上

可选属性：

属性名含义说明
index对应Excel表中的列数默认-1，指定时建议从0开始
value对应Excel表中的列头
converter成员变量转换器自定义转换器需要实Converter接口

使用效果：index 指定写到第几列，如果不指定则根据成员变量位置排序；

value指定写入的列头，如果不指定则使用成员变量的名字作为列头；

如果要设置复杂的头，可以为value指定多个值。

代码演示：

// 5. 为《模拟学员表.xlsx》文件中学生信息设置一个统一的表头“模拟学员信息表”
其他注解：

基本和读取时一致

  • @ContentRowHeight() 标注在类上或属性上，指定内容行高
  • @HeadRowHeight() 标注在类上或属性上，指定列头行高
  • @ColumnWidth() 标注在类上或属性上，指定列宽
  • @ExcelIgnore 默认所有字段都会写入excel，这个注解会忽略这个字段
  • @DateTimeFormat 日期转换，将Date写到excel会调用这个注解。里面的value参照java.text.SimpleDateFormat
  • @NumberFormat 数字转换，用Number写excel会调用这个注解。里面的value参照java.text.DecimalFormat
  • @ExcelIgnoreUnannotated 默认不加 ExcelProperty 的注解的都会参与读写，加了不会参与

7、写入时通用参数

WriteWorkbook、WriteSheet都会有的参数，如果为空，默认使用上级。

  • converter 转换器，默认加载了很多转换器。也可以自定义。
  • writeHandler 写的处理器。可以实现WorkbookWriteHandler,SheetWriteHandler,RowWriteHandler,CellWriteHandler，在写入excel的不同阶段会调用，对使用者透明不可见。
  • relativeHeadRowIndex 距离多少行后开始。也就是开头空几行
  • needHead 是否导出头
  • head 与clazz二选一。写入文件的头列表，建议使用class。
  • clazz 与head二选一。写入文件的头对应的class，也可以使用注解。
  • autoTrim 字符串、表头等数据自动trim

8、WriteWorkbook（工作簿对象）参数

  • excelType 当前excel的类型，默认为xlsx
  • outputStream 与file二选一。写入文件的流
  • file 与outputStream二选一。写入的文件
  • templateInputStream 模板的文件流
  • templateFile 模板文件
  • autoCloseStream 自动关闭流。
  • password 写的时候是否需要使用密码
  • useDefaultStyle 写的时候是否是使用默认头

9、WriteSheet（工作表对象）参数

  • sheetNo 需要写入的编号。默认0
  • sheetName 需要些的Sheet名称，默认同sheetNo
时间：2021年10月
作者：耿鬼不会笑

​

耿鬼不会笑
关注
  • 2
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
专栏目录
easyexcel 学习
jiqiren1994的博客
10-21 2634
一、需求 我们需要完成的就是这种表格，内容很复杂，可以分未三个块。第一个是标题块，第二个是数学老师详细资料块，第三个是语文老师详细资料块。其次我们需要根据老师的详细信息的列数来决定其上标题的合并单元格数量，保证对齐美观。 二、实现 一般来说，我们使用easyexcel都是定义一个类，然后使用如下语法，就能导出相应的excel了，并且导出的excel中还会有相应的标题，这些标题行都有默认的样式了。另外还能使用注解方法去设置一些自定义样式以及单元合并等。常规应该以及足够应付那些简单的导出业务了。 @Data
gitlab_codeList：通过各种条件从gitlab上生成excel格式的代码清单，界面使用了javafx
02-26
gitlab_codeList 通过各种条件从gitlab上生成excel格式的代码清单，界面使用了javafx
GitHub Star 9000+ 的Alibaba开源的 Java 解析 Excel 工具：easyexcel
倚栏静望的博客
09-14 1452
在项目中我们经常会遇到操作 Excel 的需求，比如导入、导出 Excel 报表，Java 操作 Excel 基本上都用 POI，但 POI 操作起来比较麻烦，需要创建很多 row，cell 以及样式，而且非常耗内存。 easyexcel要去解决的问题 虽然POI是目前使用最多的用来做excel解析的框架，但这个框架并不那么完美。大部分使用POI都是使用他的userModel模式。userMode...
EasyExcel使用教程-实现页面中批量导入导出数据-详解
wyx15059882185的博客
04-20 9000
EasyExcel实现excel表格的导入导出
网络安全相关数据集介绍
热门推荐
Asia-Lee
11-20 1万+
目录 1、KDD99 入侵检测数据集 2、NSL KDD 入侵检测数据集 3、UNSW_NB15 入侵检测数据集 4、NASA MDP 软件缺陷数据集 5、CNNVD 软件安全漏洞数据集 6、NVD 软件安全漏洞数据集 1、KDD99 入侵检测数据集 该数据集是从一个模拟的美国空军局域网上采集来的9个星期的网络连接数据，分成具有标识的训练数据和未加标识的测试数据。测试数据和训练数据...
【EasyExcel-Alibaba】在Java中操作Excel 完成数据的导入导出
m0_65563175的博客
01-19 3446
EasyExcel是阿里巴巴开源的一个excel处理框架，以使用简单、节省内存著称。EasyExcel能大大减少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部加载到内存中，而是从磁盘上一行行读取数据，逐个解析。EasyExcel采用一行一行的解析模式，并将一行的解析结果以观察者的模式通知处理（AnalysisEventListener）。
POI-EasyExcel笔记1
08-03
在IT行业中，Apache POI和EasyExcel是两个广泛使用的Java库，主要用于处理Microsoft Excel文件。本文将深入探讨这两个工具，并介绍如何使用它们进行Excel数据的导入与导出。 首先，Apache POI是一个开源的API，它...
easyexcel代码
06-21
EasyExcel是一款由阿里巴巴开源的Java库，专门用于处理Excel数据，尤其在大数据量读写场景下表现出色。它简化了Excel与Java对象之间的转换，提供了简单易用的API，使得开发者无需关注底层复杂的文件格式，可以更加...
easyexcel合并单元格
02-11
原文连接...
EasyExcel导出.txt
11-04
EasyExcel 导出，含动态表头导出
EasyExcel 动态表头 导出
11-20
【EasyExcel 动态表头 导出】是一种在Java编程环境下，利用阿里巴巴开源的EasyExcel库实现的高效、灵活的Excel数据导出功能。EasyExcel不仅提供了简单易用的API，而且支持动态表头，使得在导出Excel时可以根据业务...
EasyExcel导入导出功能--基于B站视频学习
m0_60907575的博客
02-14 143
EaysExcel导入导出功能
EasyExcel学习
qq_39581763的博客
03-20 424
一、引入 在一个项目系统中，只要运行了，就会产生很多数据，一般会采用分页显示，但是为了方便浏览数据，一般都会做一个功能，导出成excel，而为了添加数据，也会做一个导入excel功能，进行批量导入。而现在在市场有很多这方面的技术，如Apache poi、jxl。但是这两种技术都存在一个问题，就是非常的耗内存，虽然poi有一套SAX模式的API可以一定程度的解决一些内存溢出的问题，但po...
GitHub Star 8800+ 的阿里开源的 Java 解析 Excel 工具
非著名程序员
09-12 3763
【公众号回复 “1024”，免费领取程序员赚钱实操经验】我们在项目中经常会遇到操作 Excel 的需求，比如导入、导出 Excel 报表，Java 操作 Excel 基本...
EasyExcel之导入导出
一生一世一双人的博客
09-25 1万+
JAVA解析Excel工具easyexcel Java解析、生成Excel比较有名的框架有Apache poi、jxl。但他们都存在一个严重的问题就是非常的耗内存，poi有一套SAX模式的API可以一定程度的解决一些内存溢出的问题，但POI还是有一些缺陷，比如07版Excel解压缩以及解压后存储都是在内存中完成的，内存消耗依然很大。easyexcel重写了poi对07版Excel的解析，能够原本...
EasyExcel导入导出详解
Aurora_____的博客
11-20 1万+
一、初识EasyExcel 1. Apache POI 先说POI，有过报表导入导出经验的同学，应该听过或者使用。 Apache POI是Apache软件基金会的开源函式库，提供跨平台的Java API实现Microsoft Office格式档案读写。但是存在如下一些问题： 1.1 学习使用成本较高 对POI有过深入了解的才知道原来POI还有SAX模式（Dom解析模式）。但SAX模式相对比较复杂，excel有03和07两种版本，两个版本数据存储方式截然不同，sax解析方式也各不一样。 想要了解清楚这两种解析
Apache POI 及 alibaba EasyExcel
qq_52998673的博客
01-09 981
java-操作excel
【尚硅谷/周阳】JUC学习笔记
耿鬼不会笑的博客
04-29 2965
JUC学习笔记【尚硅谷/周阳】 本文章基于B站视频教程【juc 与 jvm 并发编程 Java 必学_阳哥- 尚硅谷】进行整理记录，仅用于个人学习，交流使用。 0.课前引入 1.进程/线程是什么? 进程： 进程是一个具有一定独立功能的程序关于某个数据集合的一次运行活动。它是操作系统动态执行的基本单元，在传统的操作系统中，进程既是基本的分配单元，也是基本的执行单元。 线程： 通常在一个进程中可以包含若干个线程，当然一个进程中至少有一个线程，不然没有存在的意义。线程可以利用进程所拥有的资源，在引入线程的操作系
easyexcel的Maven
最新发布
08-19
您可以通过在您的Maven项目的pom.xml文件中引入easyexcel的依赖来使用它。引入依赖的方式是将以下代码添加到pom.xml文件中： ```xml <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.1.1</version> </dependency> ``` 这样，您就可以在您的项目中使用easyexcel了。easyexcel是一个比较著名的Excel操作框架，相对于其他框架如poi和jxl，它能够更好地解决内存溢出的问题。因为它重写了poi对于07版Excel的解析，大大降低了内存消耗。即使是处理大型的Excel文件，easyexcel也不会出现内存溢出的问题。同时，easyexcel对03版Excel也有支持，它依赖于POI的sax模式，并且在上层做了模型转换的封装，让使用者更加方便。目前，easyexcel的最新版本是3.1.1，它可以在Maven项目中很方便地使用，并且开发环境可以是idea等。<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* [Maven中EasyExcel的使用](https://blog.csdn.net/AlexWang30/article/details/121452733)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_1"}}] [.reference_item style="max-width: 33.333333333333336%"] - *2* [阿里easyExcel学习笔记（maven）](https://blog.csdn.net/weixin_37775583/article/details/89642093)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_1"}}] [.reference_item style="max-width: 33.333333333333336%"] - *3* [easyexcel代码](https://download.csdn.net/download/qq_31083947/85722463)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_1"}}] [.reference_item style="max-width: 33.333333333333336%"] [ .reference_list ]

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值