【POI、EasyExcel】详细教程

POI，EasyExcel

文章目录

POI，EasyExcel
- 1、前言
- - 1.1、[Apache](https://so.csdn.net/so/search?q=Apache&spm=1001.2101.3001.7020) POI是什么？
  - 1.2、EasyExcel是什么？
- 2、Apache POI操作
- - 2.1、POI-Excel写操作
  - - 2.1.1、03版本
    - 2.1.2、07版本
    - 2.1.3、大文件写——HSSF
    - 2.1.4、大文件写——XSSF
    - 2.1.5、大文件写用SXSSF
  - 2.2、POI-Excel读
  - - 2.2.1、03版本
    - 2.2.2、07版本
    - 2.2.3、获取值的类型，读取不同的数据类型
    - 2.2.4、计算公式
- 3、EasyExcel操作
- - 3.1、EasyExcel写入操作：
  - 3.2、EasyExcel读取操作

视频地址（狂神说）：【狂神说Java】POI及EasyExcel一小时搞定通俗易懂_哔哩哔哩_bilibili

1、前言

开发中经常会涉及到excel的处理，如导出Excel到数据库中，读取Excel内容！操作Excel目前比较流行的就是Apache POI和阿里巴巴的easyExcel

将用户信息导出为excel表格
讲Excel表中的信息录入到网站数据库，大大减小网站数据的录入量！

1.1、Apache POI是什么？

1.2、EasyExcel是什么？

官方文档: https://www.yuque.com/easyexcel/doc/easyexcel

EasyExcel是阿里巴巴开源的一个excel处理框架，以使用简单，节约内存著称。
优势：EasyExcel能大量减少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部加载到内存中，而是从一个磁盘上一行行读取数据，逐个解析。

下图是EasyExcel和POI在解析Excel时的对比图(时间与空间的相互取舍)。

2、Apache POI操作

HSSF：Excel97-2003版本，扩展名为.xls。一个sheet最大行数65536，最大列数256。

XSSF：Excel2007版本开始，扩展名为.xlsx。一个sheet最大行数1048576，最大列数16384。

SXSSF：是在XSSF基础上，POI3.8版本开始提供的支持低内存占用的操作方式，扩展名为.xlsx。

2.1、POI-Excel写操作

创建一个普通空项目empty model,然后新建一个model的maven项目
引入pom依赖



	
	
		org.apache.poi
		poi
		3.9
	
	
	 
        org.apache.poi
        poi-ooxml
        3.9
     
	
	
		joda-time
		joda-time
		2.10.1
	
	
	
		junit
		junit
		4.12

注：03与07版本的写，就是对象不同，方法是一样的

区别：03版最多65536行，07行数没有限制，03 HSSFWorkbook() 后缀xls，07 XSSFWorkbook() 后缀xlsx

工作薄
工作表
行
单元格

2.1.1、03版本

package com.qx;

import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.joda.time.DateTime;
import org.junit.Test;

import java.io.FileNotFoundException;
import java.io.FileOutputStream;


public class ExcelWriteTest {

    String PATH ="D:\Java学习\POI_EasyExcel";

    @Test
    public void testWrite03() throws Exception {
        //1.创建一个工作簿
        Workbook workbook = new HSSFWorkbook();
        //2.创建一个工作表
        Sheet sheet = workbook.createSheet("qx");
        //3.创建一个行
        Row row1 = sheet.createRow(0);
        //4.创建一个单元格
        //(1,1)
        Cell cell1 = row1.createCell(0);
        cell1.setCellValue("hello excel");
        //(1,2)
        Cell cell2 = row1.createCell(1);
        cell2.setCellValue("888666");

        //第二行
        //(2,1)
        Row row2 = sheet.createRow(1);
        Cell cell21 = row2.createCell(0);
        cell21.setCellValue("统计时间");
        //(2,2)
        Cell cell22 = row2.createCell(1);
        String time = new DateTime().toString("yyyy-MM-dd HH:mm:ss");
        cell22.setCellValue(time);


        //生成一张表 （IO流）  03版本就是使用xls结尾
        FileOutputStream fs = new FileOutputStream(PATH + "qx03.xls");
        //输出
        workbook.write(fs);
        //关闭流
        fs.close();

        System.out.println("文件生成完毕");
    }

}

2.1.2、07版本

package com.qx;

import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.joda.time.DateTime;
import org.junit.Test;

import java.io.FileNotFoundException;
import java.io.FileOutputStream;


public class ExcelWriteTest {

    String PATH ="D:\Java学习\POI_EasyExcel";

 
    @Test
    public void testWrite07() throws Exception {
        //1.创建一个工作簿
        Workbook workbook = new XSSFWorkbook();
        //2.创建一个工作表
        Sheet sheet = workbook.createSheet("qx");
        //3.创建一个行
        Row row1 = sheet.createRow(0);
        //4.创建一个单元格
        //(1,1)
        Cell cell1 = row1.createCell(0);
        cell1.setCellValue("hello excel");
        //(1,2)
        Cell cell2 = row1.createCell(1);
        cell2.setCellValue("888666");

        //第二行
        //(2,1)
        Row row2 = sheet.createRow(1);
        Cell cell21 = row2.createCell(0);
        cell21.setCellValue("统计时间");
        //(2,2)
        Cell cell22 = row2.createCell(1);
        String time = new DateTime().toString("yyyy-MM-dd HH:mm:ss");
        cell22.setCellValue(time);


        //生成一张表 （IO流）  07版本就是使用xlsx结尾
        FileOutputStream fs = new FileOutputStream(PATH + "qx07.xlsx");
        //输出
        workbook.write(fs);
        //关闭流
        fs.close();

        System.out.println("文件生成完毕");
    }
}

运行结果

07和03不同的就这两处：注意对象的一个区别,文件后缀!

2.1.3、大文件写——HSSF

大文件写用HSSF

缺点：最多只能处理65536行，否则会报异常

优点：过程中写入缓存，不操作磁盘，最后一次性写入磁盘，速度快

java.lang.IllegalArgumentException:Invalid row number (65536) outside allowable range (0.. 65535)

    @Test
    public void testwrite03BigData() throws IOException {
        //时间
        long begin = System.currentTimeMillis();
        //创建一个薄
        Workbook workbook = new HSSFWorkbook();
        //创建表
        Sheet sheet = workbook.createSheet();
        //写入数据
        for (int rowNum = 0; rowNum < 65536; rowNum++) {
            Row row = sheet.createRow(rowNum);
            for (int cellNum = 0; cellNum < 10; cellNum++) {
                Cell cell = row.createCell(cellNum);
                cell.setCellValue(cellNum);
            }
        }
        FileOutputStream fos = new FileOutputStream(PATH + "03版本Excel大量数据测试.xls");
        workbook.write(fos);
        fos.close();
        System.out.println("over");
        long end = System.currentTimeMillis();
        System.out.println((double) (end - begin) / 1000);
    }

运行结果

over
1.22

如果超过65535行则会报以下错误

java.lang.IllegalArgumentException: Invalid row number (65536) outside allowable range (0..65535)

2.1.4、大文件写——XSSF

大文件写用XSSF

缺点：写数据时速度非常慢，非常耗内存，也会发生内存溢出，如100万条数据
优点：可以写较大的数据量，如20万条数据

    @Test
    public void testwrite07BigData() throws IOException {
        //时间
        long begin = System.currentTimeMillis();
        //创建一个薄
        Workbook workbook = new XSSFWorkbook();
        //创建表
        Sheet sheet = workbook.createSheet();
        //写入数据
        for (int rowNum = 0; rowNum < 65537; rowNum++) {
            Row row = sheet.createRow(rowNum);
            for (int cellNum = 0; cellNum < 10; cellNum++) {
                Cell cell = row.createCell(cellNum);
                cell.setCellValue(cellNum);
            }
        }

        FileOutputStream fos = new FileOutputStream(PATH + "testwrite07BigData.xlsx");
        workbook.write(fos);
        fos.close();
        System.out.println("over");
        long end = System.currentTimeMillis();
        System.out.println((double) (end - begin) / 1000);
    }

运行结果

over
6.003

2.1.5、大文件写用SXSSF

SXSSWorkbook 来自官方解释：实现：BigGridDemo策略的流式XSSFWorkbook版本。这允许写入非常大的文件而不会耗尽内存，因为任何时候只有可配置的行部分被保存在内存中。

读取07及以上版本的excel仍然是“XSSFWorkbook”，写入则为“SXSSFWorkbook ”。后缀和07一样是.xlsx。

最后调用workbook.dispose()删除临时文件。

优点：可以写非常大量的数据库，如100万条甚至更多条，写数据速度快，占用更少的内存

注意：

过程中会产生临时文件，需要清理临时文件
默认由100条记录被保存在内存中，如果超出这数量，则最前面的数据被写入临时文件
如果想自定义内存中数据的数量，可以使用new SXSSFWorkbook（数量）

   @Test
    public void testwrite07BigDataS() throws IOException {
        //时间
        long begin = System.currentTimeMillis();
        //创建一个薄
        Workbook workbook = new SXSSFWorkbook();
        //创建表
        Sheet sheet = workbook.createSheet();
        //写入数据
        for (int rowNum = 0; rowNum < 65537; rowNum++) {
            Row row = sheet.createRow(rowNum);
            for (int cellNum = 0; cellNum < 10; cellNum++) {
                Cell cell = row.createCell(cellNum);
                cell.setCellValue(cellNum);
            }
        }

        FileOutputStream fos = new FileOutputStream(PATH + "testwrite07BigDataS.xlsx");
        workbook.write(fos);

        fos.close();
        //清除临时文件
        ((SXSSFWorkbook) workbook).dispose();
        System.out.println("over");
        long end = System.currentTimeMillis();
        System.out.println((double) (end - begin) / 1000);
    }

运行结果

over
1.365

2.2、POI-Excel读 2.2.1、03版本

  @Test
    public void testRead03() throws Exception {

        //1.获取文件流
        FileInputStream fs = new FileInputStream(PATH+"POI_EasyExcelqx03.xls");
        //2.得到表
        Workbook workbook = new HSSFWorkbook(fs);
        //3.得到行
        Sheet sheet = workbook.getSheetAt(0);
        Row row = sheet.getRow(0);
        //4.得到列
        Cell cell = row.getCell(0);

        //读取值的时候，一定要注意类型！
        System.out.println(cell.getStringCellValue());

        Cell cell1 = row.getCell(1);
        System.out.println(cell1.getNumericCellValue());
        fs.close();
    }

2.2.2、07版本

@Test
public void testRead07() throws Exception {

    //1.获取文件流
    FileInputStream fs = new FileInputStream(PATH+"POI_EasyExcelqx07.xlsx");
    //2.得到表
    Workbook workbook = new XSSFWorkbook(fs);
    //3.得到行
    Sheet sheet = workbook.getSheetAt(0);
    Row row = sheet.getRow(0);
    //4.得到列
    Cell cell = row.getCell(0);

    //读取值的时候，一定要注意类型！
    System.out.println(cell.getStringCellValue());

    Cell cell1 = row.getCell(1);
    System.out.println(cell1.getNumericCellValue());
    fs.close();
}

2.2.3、获取值的类型，读取不同的数据类型

 @Test
    public void testCellType() throws Exception {
        //1.获取文件流
        FileInputStream fs = new FileInputStream(PATH+"***.xls");
        //2.得到表
        Workbook workbook = new HSSFWorkbook(fs);
        Sheet sheet = workbook.getSheetAt(0);
        //获取标题内容
        Row rowTitle = sheet.getRow(0);

        if (rowTitle!=null){
            int cellCount = rowTitle.getPhysicalNumberOfCells();
            for (int cellNum = 0;cellNum
                Cell cell = rowTitle.getCell(cellNum);
                if (cell!=null){
                    int cellType = cell.getCellType();
                    String cellValue = cell.getStringCellValue();
                    System.out.print(cellValue+" | ");
                }
            }
            System.out.println();
        }
        //获取表中的数据
        int rowCount = sheet.getPhysicalNumberOfRows();
        for (int rowNum = 1;rowNum
            Row rowData = sheet.getRow(rowNum);
            if (rowData!=null){
                //读取列
                int cellCount = rowTitle.getPhysicalNumberOfCells();
                for (int cellNum = 0;cellNum
//                    System.out.print("["+(rowNum+1)+"-"+(cellNum+1)+"]");
                    Cell cell = rowData.getCell(cellNum);

                    //匹配列的数据类型
                    if (cell != null) {
                        int cellType = cell.getCellType();
                        String cellValue = "";

                        switch (cellType) {
                            case HSSFCell.CELL_TYPE_STRING://字符
                                System.out.print("【 String】");
                                cellValue = cell.getStringCellValue();
                                break;
                            case HSSFCell.CELL_TYPE_BOOLEAN://布尔
                                System.out.print("【 BOOLEAN】");
                                cellValue = String.valueOf(cell.getBooleanCellValue());
                                break;
                            case HSSFCell.CELL_TYPE_BLANK://空
                                System.out.print("【 BLANK】");
                                break;
                            case HSSFCell.CELL_TYPE_NUMERIC://数字(日期、普通数字)
                                System.out.print("【 NUMERIC】");
                                if (HSSFDateUtil.isCellDateFormatted(cell)) {// 日期
                                    System.out.print("--【日期】");
                                    Date date = cell.getDateCellValue();
                                    cellValue = new DateTime(date).toString("yyyy-MM-dd");
                                } else {
                                    //不是日期格式，防止数字过长！
                                    System.out.print("--【转换为字符串输出】");
                                    cell.setCellType(HSSFCell.CELL_TYPE_STRING);
                                    cellValue = cell.toString();
                                }
                                break;
                            case HSSFCell.CELL_TYPE_ERROR://错误
                                System.out.print("【 数据类型错误】");
                                break;
                        }
                        System.out.println(cellValue);
                    }
                }
            }
        }
    }

2.2.4、计算公式

    @Test
    public void testFormula() throws Exception {
        FileInputStream fis = new FileInputStream(PATH+"公式.xls");
        //创建一个工作簿。使用 excel能操作的这边他都可以操作
        Workbook workbook = new HSSFWorkbook(fis);
        Sheet sheet = workbook.getSheetAt(0);
 
        Row row = sheet.getRow(4);
        Cell cell = row.getCell(0);
 
        //拿到计算公司 evaL
        FormulaEvaluator FormulaEvaluator = new HSSFFormulaEvaluator((HSSFWorkbook) workbook);
 
        //输出单元格的内容
        int cellType = cell.getCellType();
        switch (cellType) {
            case Cell.CELL_TYPE_FORMULA://公式
                String formula = cell.getCellFormula();
                System.out.println(formula);
 
                //计算
                CellValue evaluate = FormulaEvaluator.evaluate(cell);
                String cellValue = evaluate.formatAsString();
                System.out.println(cellValue);
                break;
        }
    }

3、EasyExcel操作 3.1、EasyExcel写入操作：

官方API:https://www.yuque.com/easyexcel/doc

导入依赖


    
        com.alibaba
        easyexcel
        2.2.0-beta2

    
    
        
        
            com.alibaba
            fastjson
            1.2.62
        
 
        
        
            com.alibaba
            easyexcel
            2.2.0-beta2
        
    
	
		org.projectlombok
		lombok
		1.18.12
	
 

        
        
            joda-time
            joda-time
            2.10.1
        
        
        
            junit
            junit
            4.12

实体类

package com.qx.easy;


import com.alibaba.excel.annotation.ExcelIgnore;
import com.alibaba.excel.annotation.ExcelProperty;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.Setter;

import java.util.Date;


@Getter
@Setter
@EqualsAndHashCode
public class DemoData {
    @ExcelProperty("字符串标题")
    private String string;
    @ExcelProperty("日期标题")
    private Date date;
    @ExcelProperty("数字标题")
    private Double doubleData;
    
    @ExcelIgnore
    private String ignore;
}

测试

package com.qx.easy;

import com.alibaba.excel.EasyExcel;
import org.apache.commons.collections4.ListUtils;
import org.junit.Test;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;


public class easyTest {
    String PATH ="D:\Java学习\";
    private List data() {



        List list = new ArrayList();
        for (int i = 0; i < 10; i++) {
            DemoData data = new DemoData();
            data.setString("字符串" + i);
            data.setDate(new Date());
            data.setDoubleData(0.56);
            list.add(data);
        }
        return list;
    }

    //根据list，写入excel

    
    @Test
    public void simpleWrite() {
        // 注意 simpleWrite在数据量不大的情况下可以使用（5000以内，具体也要看实际情况），数据量大参照 重复多次写入

        // 写法1 JDK8+
        // since: 3.0.0-beta1
        String fileName =PATH+"easyTest.xlsx";
        // 这里 需要指定写用哪个class去写，然后写到第一个sheet，名字为模板 然后文件流会自动关闭
        // 如果这里想使用03 则 传入excelType参数即可
        EasyExcel.write(fileName, DemoData.class).sheet("模板").doWrite( data());

    }

}

3.2、EasyExcel读取操作

对象

@Getter
@Setter
@EqualsAndHashCode
public class DemoData {
    private String string;
    private Date date;
    private Double doubleData;
}

监听器

package com.qx.easy;

import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;
import com.alibaba.fastjson.JSON;
import com.qx.easy.DemoDAO;
import com.qx.easy.DemoData;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

// 有个很重要的点 DemoDataListener 不能被spring管理，要每次读取excel都要new,然后里面用到spring可以构造方法传进去
public class DemoDataListener extends AnalysisEventListener {
    private static final Logger LOGGER = LoggerFactory.getLogger(DemoDataListener.class);
    
    private static final int BATCH_COUNT = 5;
    List list = new ArrayList();
    
    private DemoDAO demoDAO;
    public DemoDataListener() {
        // 这里是demo，所以随便new一个。实际使用如果到了spring,请使用下面的有参构造函数
        demoDAO = new DemoDAO();
    }
    
    public DemoDataListener(DemoDAO demoDAO) {
        this.demoDAO = demoDAO;
    }
    
    @Override
    public void invoke(DemoData data, AnalysisContext context) {
        System.out.println(JSON.toJSONString(data));
//        LOGGER.info("解析到一条数据:{}", JSON.toJSONString(data));
        list.add(data);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (list.size() >= BATCH_COUNT) {
            saveData();
            // 存储完成清理 list
            list.clear();
        }
    }
    
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里也要保存数据，确保最后遗留的数据也存储到数据库
        saveData();
        LOGGER.info("所有数据解析完成！");
    }
    
    private void saveData() {
        LOGGER.info("{}条数据，开始存储数据库！", list.size());
        demoDAO.save(list);
        LOGGER.info("存储数据库成功！");
    }
}

持久层

package com.qx.easy;



import java.util.List;


public class DemoDAO {
    public void save(List list) {
        // 如果是mybatis,尽量别直接调用多次insert,自己写一个mapper里面新增一个方法batchInsert,所有数据一次性插入
    }
}

代码

  
    @Test
    public void simpleRead() {
        // 有个很重要的点 DemoDataListener 不能被spring管理，要每次读取excel都要new,然后里面用到spring可以构造方法传进去
        // 写法1：
        String fileName =PATH+"easyTest.xlsx";
        // 这里 需要指定读用哪个class去读，然后读取第一个sheet 文件流会自动关闭
        EasyExcel.read(fileName, DemoData.class, new DemoDataListener()).sheet().doRead();

    }

固定套路：

easyexcel使用cv大法，更改的地方主要在重写invoke方法。

写入，固定类格式进行写入
.List;

public class DemoDAO {
public void save(List list) {
// 如果是mybatis,尽量别直接调用多次insert,自己写一个mapper里面新增一个方法batchInsert,所有数据一次性插入
}
}

``代码``

```java
  
    @Test
    public void simpleRead() {
        // 有个很重要的点 DemoDataListener 不能被spring管理，要每次读取excel都要new,然后里面用到spring可以构造方法传进去
        // 写法1：
        String fileName =PATH+"easyTest.xlsx";
        // 这里 需要指定读用哪个class去读，然后读取第一个sheet 文件流会自动关闭
        EasyExcel.read(fileName, DemoData.class, new DemoDataListener()).sheet().doRead();

    }

固定套路：

easyexcel使用cv大法，更改的地方主要在重写invoke方法。

写入，固定类格式进行写入
读取，根据监听器设置的规则进行读取！

【POI、EasyExcel】详细教程

Java相关栏目本月热门文章