【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依赖
<dependencies>
<dependency>
<groupId>org.apache.poigroupId>
<artifactId>poiartifactId>
<version >3.9version>
dependency>
<dependency>
<groupId>org.apache.poigroupId>
<artifactId>poi-ooxmlartifactId>
<version>3.9version>
dependency>
<dependency>
<groupId>joda-timegroupId>
<artifactId>joda-timeartifactId>
<version>2.10.1version>
dependency>
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.12version>
dependency>
dependencies>
注：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;
/**
* @author : k
* @Date : 2022/5/13
* @Desc :
*/
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;
/**
* @author : k
* @Date : 2022/5/13
* @Desc :
*/
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<cellCount;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<rowCount;rowNum++){
Row rowData = sheet.getRow(rowNum);
if (rowData!=null){
//读取列
int cellCount = rowTitle.getPhysicalNumberOfCells();
for (int cellNum = 0;cellNum<cellCount;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
导入依赖
<dependency>
<groupId>com.alibabagroupId>
<artifactId>easyexcelartifactId>
<version >2.2.0-beta2version>
dependency>
<dependencies>
<dependency>
<groupId>com.alibabagroupId>
<artifactId>fastjsonartifactId>
<version >1.2.62version>
dependency>
<dependency>
<groupId>com.alibabagroupId>
<artifactId>easyexcelartifactId>
<version >2.2.0-beta2version>
dependency>
<dependency>
<groupId>org.projectlombokgroupId>
<artifactId>lombokartifactId>
<version >1.18.12version>
dependency>
<dependency>
<groupId>joda-timegroupId>
<artifactId>joda-timeartifactId>
<version>2.10.1version>
dependency>
<dependency>
<groupId>junitgroupId>
<artifactId>junitartifactId>
<version>4.12version>
dependency>
dependencies>
实体类
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;
/**
* @author : k
* @Date : 2022/5/13
* @Desc :
*/
@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;
/**
* @author : k
* @Date : 2022/5/13
* @Desc :
*/
public class easyTest {
String PATH ="D:\\Java学习\\";
private List<DemoData> data() {
List<DemoData> list = new ArrayList<DemoData>();
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
/**
* 最简单的写
*
* 1. 创建excel对应的实体对象 参照{@link DemoData}
*
* 2. 直接写即可
*/
@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<DemoData> {
private static final Logger LOGGER = LoggerFactory.getLogger(DemoDataListener.class);
/**
* 每隔5条存储数据库，实际使用中可以3000条，然后清理list ，方便内存回收
*/
private static final int BATCH_COUNT = 5;
List<DemoData> list = new ArrayList<DemoData>();
/**
* 假设这个是一个DAO，当然有业务逻辑这个也可以是一个service。当然如果不用存储这个对象没用。
*/
private DemoDAO demoDAO;
public DemoDataListener() {
// 这里是demo，所以随便new一个。实际使用如果到了spring,请使用下面的有参构造函数
demoDAO = new DemoDAO();
}
/**
* 如果使用了spring,请使用这个构造方法。每次创建Listener的时候需要把spring管理的类传进来
*
* @param demoDAO
*/
public DemoDataListener(DemoDAO demoDAO) {
this.demoDAO = demoDAO;
}
/**
* 这个每一条数据解析都会来调用
*
* @param data
* one row value. Is is same as {@link AnalysisContext#readRowHolder()}
* @param context
*/
@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();
}
}
/**
* 所有数据解析完成了 都会来调用
*
* @param context
*/
@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;
/**
* @author : k
* @Date : 2022/5/13
* @Desc :
*/
import java.util.List;
/**
* 假设这个是你的DAO存储。当然还要这个类让spring管理，当然你不用需要存储，也不需要这个类。
**/
public class DemoDAO {
public void save(List<DemoData> list) {
// 如果是mybatis,尽量别直接调用多次insert,自己写一个mapper里面新增一个方法batchInsert,所有数据一次性插入
}
}
代码
/**
* 最简单的读
* 1. 创建excel对应的实体对象 参照{@link DemoData}
*
2. 由于默认一行行的读取excel，所以需要创建excel一行一行的回调监听器，参照{@link DemoDataListener}
*
3. 直接读即可
*/
@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;
/**
- 假设这个是你的DAO存储。当然还要这个类让spring管理，当然你不用需要存储，也不需要这个类。
**/
public class DemoDAO {
public void save(List list) {
// 如果是mybatis,尽量别直接调用多次insert,自己写一个mapper里面新增一个方法batchInsert,所有数据一次性插入
}
}
``代码``
```java
/**
* 最简单的读
* 1. 创建excel对应的实体对象 参照{@link DemoData}
*
2. 由于默认一行行的读取excel，所以需要创建excel一行一行的回调监听器，参照{@link DemoDataListener}
*
3. 直接读即可
*/
@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方法。
- 写入，固定类格式进行写入
- 读取，根据监听器设置的规则进行读取！