java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > EasyExcel使用

一文带你轻松掌握EasyExcel的使用技巧

作者:Cosolar

EasyExcel是一个基于Java的、快速、简洁、解决大文件内存溢出的Excel处理工具,这篇文章就来带大家深入了解EasyExcel的使用技巧,需要的可以参考一下

作为一个经常进行数据分析的后端人员,免不了面对各种报表,且在日常的工作中,经常需要处理大量的数据,并进行各种复杂的计算和分析。而Excel作为一个重要的工具,在数据处理与分析上也起到了至关重要的作用。但是,Excel的操作繁琐、效率低下等问题也制约着我们的工作效率。为了解决这个问题,我们可以使用EasyExcel这个优秀的Java类库,来优化Excel数据的读写,并提高我们的工作效率。在本文中,我将向大家介绍如何使用EasyExcel的高效技巧,从而更好地搞定Excel繁琐操作。

一、EasyExcel简介

EasyExcel是一个基于Java的、快速、简洁、解决大文件内存溢出的Excel处理工具。

他能让你在不用考虑性能、内存的等因素的情况下,快速完成Excel的读、写等功能。

EasyExcel是一个基于POI封装的Java类库,它能够对Excel文件进行读写操作。EasyExcel简单易用,性能优异,并且支持大量的Excel操作。无论是简单的数据导入还是复杂的数据处理和导出,EasyExcel都能够轻松实现。同时,EasyExcel也支持多种数据格式,包括Excel、CSV、TSV等。EasyExcel底层使用反射实现,因此也支持泛型。EasyExcel已被广泛应用于各种项目中,成为Java开发者优化Excel操作的首选库之一。

16M内存23秒读取75M(46W行25列)的Excel(3.2.1+版本)

二、EasyExcel的高效技巧

1. 读取Excel文件

在日常工作中,读取Excel文件是我们经常会遇到的需求之一。EasyExcel提供了多种读取Excel文件的方式,包括读取指定Sheet、读取指定列等。下面是一个简单的代码示例:

//读取指定Sheet
List<YourModelName> list = EasyExcel.read(fileName)
.sheet(sheetNo)
.head(YourModelName.class)
.doReadSync();
//读取指定列
List<Object> list = EasyExcel.read(fileName)
.sheet(sheetNo)
.headRow(rowNo)
.readRowFilter(new ReadRowFilter() {
    @Override
    public boolean doFilter(List<Object> list) {
        if (list.get(0).equals("某一列的值")) {
            return true;
        }
        return false;
    }
})
.doReadSync();

2. 写入Excel文件

除了读取Excel文件外,我们在实际工作中也需要频繁地向Excel文件中写入数据。EasyExcel提供了多种写入Excel文件的方式,包括向指定Sheet写入数据、向指定行写入数据、动态合并单元格等。下面是一个简单的代码示例:

//向指定Sheet写入数据
ExcelWriter excelWriter = null;
try {
    excelWriter = EasyExcel.write(fileName, YourModelName.class).build();
    WriteSheet writeSheet = EasyExcel.writerSheet(sheetNo).build();
    excelWriter.write(dataList, writeSheet);
} finally {
    if (excelWriter != null) {
        excelWriter.finish();
    }
}
//向指定行写入数据
ExcelWriter excelWriter = null;
try {
    excelWriter = EasyExcel.write(fileName, YourModelName.class).build();
    WriteSheet writeSheet = EasyExcel.writerSheet(sheetNo).build();
    excelWriter.write(dataList, writeSheet, new WriteTable()) .relativeHeadRowIndex(rowNo) .doWrite();
} finally {
    if (excelWriter != null) {
        excelWriter.finish();
    }
}

3. 填充Excel

在实际工作中,我们也经常需要对Excel文件进行填充。EasyExcel提供了多种填充Excel的方式,包括对象填充、自定义填充等。下面是一个简单的代码示例:

//对象填充
List<YourModelName> dataList = getDataList();
OutputStream outputStream = new FileOutputStream(fileName);
EasyExcel.write(outputStream, YourModelName.class)
    .sheet(sheetNo)
    .doWrite(dataList);
outputStream.close();
//自定义填充
List<Object> headList = getHeadList();
List<List<Object>> dataList = getDataList();
ExcelWriter excelWriter = null;
try {
    excelWriter = EasyExcel.write(fileName).build();
    WriteSheet writeSheet = EasyExcel.writerSheet(sheetNo).build();
    FillConfig fillConfig = FillConfig.builder().direction(WriteDirectionEnum.VERTICAL).build();
    excelWriter.fill(headList, fillConfig, writeSheet);
    excelWriter.fill(dataList, fillConfig, writeSheet);
} finally {
    if (excelWriter != null) {
        excelWriter.finish();
    }
}

4. 注意事项

在使用EasyExcel进行Excel操作时,我们也需要注意一些细节问题。下面是一些需要注意的事项:

EasyExcel默认对读取到的单元格内容进行trim操作,因此如果需要保留前后空格需要手动设置。

//禁止EasyExcel对单元格内容进行trim操作
Object value = cell.getStringCellValue();
cell.setCellValue(new HSSFRichTextString(value.toString()));

如果需要读取大量数据,可以使用异步读取的方式,提高读取效率。

//异步读取
EasyExcel.read(fileName, YourModelName.class, new ReadListener<YourModelName>() {
    // 重写方法
}).sheet().doRead();

5. 内部核心源码剖析

EasyExcel的底层代码实现是基于POI实现的,在POI的基础上又进一步进行了封装。具体来说,EasyExcel是通过反射来实现Excel文件的读写操作的,它利用了Java的泛型机制、注解等来实现高效简洁的Excel操作。EasyExcel底层的实现思路比较简单,我们可以通过阅读其源码来更好地理解其实现原理,从而更好地应用EasyExcel进行Excel数据的读写操作。

EasyExcel的底层代码实现主要基于Apache POI(Poor Obfuscation Implementation)和Java反射机制,其中Apache POI是一个支持Microsoft Office格式的Java类库,可以实现对Excel、Word、PowerPoint等文档格式的读写操作。EasyExcel利用了POI提供的接口来读写Excel文件,并在此基础上进行了封装和优化,以提高读写效率。

EasyExcel的数据读取主要涉及以下步骤:

EasyExcel的数据写入主要涉及以下步骤:

在实际代码实现过程中,EasyExcel还采用了一些技术手段来提高性能和易用性:

EasyExcel的底层实现离不开Apache POI和Java反射机制,通过这些技术的应用,EasyExcel实现了对Excel文件的高效读写操作。

EasyExcel的核心源码实现主要涉及到以下几个方面:

1.使用POI进行Excel文件的读取和写入,POI提供了SXSSF等优化机制来提高读写效率。

2.采用反射机制自动将Excel中的数据映射为Java对象,并进行类型转换等操作。

3.使用注解来为Java对象中的属性和Excel中的表头进行映射,例如@ExcelProperty注解用于标记Java对象中的属性是Excel中的第几列。

4.使用缓存技术对Workbook、Sheet等对象进行缓存,避免重复创建和销毁对象,提高运行效率。

下面我们来具体看一下EasyExcel源码中的注解部分:

1.@ExcelProperty注解

@ExcelProperty注解用于标记Java对象中的属性是Excel中的第几列。该注解包含三个属性:index、value和converter。

2.@ExcelIgnore注解

@ExcelIgnore注解用于标记Java对象中不需要映射为Excel中的列的属性。使用该注解后,EasyExcel将自动忽略该属性,不对其进行映射。

3.@ExcelPropertyRange注解

@ExcelPropertyRange注解用于标记Excel文件中某个列的取值范围。该注解包含两个属性:min和max。如果Excel文件中该列的取值范围不符合要求,则EasyExcel会抛出异常。

4.@ExcelHeadRowNumber注解

@ExcelHeadRowNumber注解用于标记Excel文件中表头所在的行号,默认为0,即第一行。如果设置为1,则表示表头在第二行。使用该注解可以灵活地配置表头所在的位置。

EasyExcel的主要核心源码涉及到数据读取和写入两个方面,下面将分别进行详细的代码展示如下。

1. 数据读取

(1) ExcelReader类

首先来看ExcelReader类,它是EasyExcel中的核心类之一,用于读取Excel文件中的数据。以下是ExcelReader的定义:

public class ExcelReader<T> {
    private static final Logger LOGGER = LoggerFactory.getLogger(ExcelReader.class);
    private Sheet sheet;
    private Workbook workbook;
    private Class<T> currentSheetClazz;
    // 省略部分成员变量及构造方法
}

ExcelReader类包含了Sheet对象、Workbook对象和当前Sheet对应的Java类信息,这些信息在进行数据读取时都会用到。

(2) read(ReadSheet readSheet)方法

read(ReadSheet readSheet)方法是ExcelReader类中读取数据的核心方法,其定义如下:

public void read(ReadSheet readSheet) {
    try {
        readSheet.setClazz(currentSheetClazz);
        readSheet.init();
        process(readSheet);
    } finally {
        if (workbook != null) {
            try {
                workbook.close();
            } catch (IOException e) {
                LOGGER.warn("Close IO exception ,msg is {}", e.getMessage());
            }
        }
    }
}

该方法首先将当前Sheet对应的Java类信息设置到读取配置ReadSheet中,然后初始化ReadSheet对象,并调用process方法进行数据读取。

(3) process(ReadSheet readSheet)方法

process(ReadSheet readSheet)方法是ExcelReader中最核心的数据读取方法,其定义如下:

private void process(ReadSheet readSheet) {
    // 从Excel文件中读取所有的数据行
    List<List<String>> rows = readSheet.getHead() == null ? sheet2List() : sheet2List(readSheet.getStartSheetIndex(), readSheet.getEndSheetIndex());
    // 获取Java类中用于映射Excel中数据的属性列表
    List<Field> fieldList = ReflectionUtil.getFieldListWithExcelColumn(currentSheetClazz);
    // 缓存读取到的Java对象列表
    List<T> dataList = new ArrayList<>();
    if (CollectionUtils.isEmpty(rows)) {
        return;
    }
    // 遍历Excel文件中每一行数据,将每一行数据映射为Java对象并添加到dataList中
    for (int i = readSheet.getHead().getRowIndex(); i < rows.size(); i++) {
        List<String> row = rows.get(i);
        T data = ReflectionUtil.newInstance(currentSheetClazz);
        for (int j = 0; j < fieldList.size(); j++) {
            Field field = fieldList.get(j);
            ExcelProperty excelProperty = field.getAnnotation(ExcelProperty.class);
            int index = excelProperty.index();
            if (index >= row.size()) {
                continue;
            }
            String value = row.get(index);
            ReflectionUtil.setFieldValue(field, data, value);
        }
        dataList.add(data);
    }
    // 将读取到的数据返回给调用方
    readSheet.getResultList().addAll(dataList);
}

该方法首先通过sheet2List方法将Excel文件中的每一行数据读取到List<List>类型的rows集合中,然后通过反射机制将Excel中的数据映射为Java对象并添加到dataList中,最后将dataList返回给调用方。

(4) sheet2List方法

sheet2List方法是ExcelReader类中的一个私有方法,用于将Excel文件中的所有数据读取到List<List>类型的rows集合中。以下是sheet2List方法的实现:

private List<List<String>> sheet2List() {
    // 从Sheet中获取所有行
    int rownum = sheet.getLastRowNum();
    List<List<String>> rows = new ArrayList<>(rownum);
    for (int i = sheet.getFirstRowNum(); i <= rownum; i++) {
        Row row = sheet.getRow(i);
        if (null == row) {
            continue;
        }
        List<String> cells = new ArrayList<>(row.getLastCellNum());
        for (int j = row.getFirstCellNum(); j < row.getLastCellNum(); j++) {
            Cell cell = row.getCell(j, Row.MissingCellPolicy.CREATE_NULL_AS_BLANK);
            String cellValue = ExcelUtil.getCellValue(cell);
            cells.add(cellValue);
        }
        rows.add(cells);
    }
    return rows;
}

该方法首先通过Sheet对象的getLastRowNum方法获取Excel文件中的总行数,然后遍历每一行数据,将每一行数据读取到List类型的cells集合中,并将所有行的数据添加到一个List<List>类型的rows集合中,最终返回rows集合。

2. 数据写入

(1) ExcelWriter类

ExcelWriter类是EasyExcel中的另一个核心类,用于写入数据到Excel文件中。以下是ExcelWriter类的定义:

public class ExcelWriter extends AbstractExcelWriter<WriteSheet> {
    // 省略部分代码及构造方法
}

ExcelWriter类继承自AbstractExcelWriter类,其主要作用是将WriteSheet对象中的数据写入到Excel文件中。

(2) write(List data, WriteSheet sheet)方法

write(List data, WriteSheet sheet)方法是ExcelWriter类中最核心的方法之一,它负责将Java对象集合data写入到Excel文件中。以下是write方法的定义:

public void write(List data, WriteSheet sheet) {
    sheetHolder.set(sheet);
    if (sheet == null) {
        return;
    }
    sheet.init();
    int index = sheetHolder.get().getIndex() == null ? 0 : sheetHolder.get().getIndex();
    String sheetName = sheetHolder.get().getSheetName() == null ? "Sheet" + index : sheetHolder.get().getSheetName();
    currentSheet = workbook.createSheet(sheetName);
    write(data);
    sheetHolder.remove();
}

该方法首先将当前的WriteSheet对象设置到sheetHolder中,并进行相应的初始化工作,然后创建一个新的Sheet对象,并将Java对象中的数据写入到该Sheet对象中,最后清空sheetHolder中的内容。

(3) write(List data)方法

write(List data)方法是ExcelWriter类中真正的数据写入方法,其定义如下:

private void write(List data) {
    WriteHandler handler = sheetHolder.get().getWriteHandler();
    if (handler != null && handler instanceof WorkbookHolder) {
        ((WorkbookHolder) handler).setWorkbook(workbook);
    }
    // 获取Java对象中用于映射Excel中数据的属性列表
    List<Field> fieldList = ReflectionUtil.getFieldListWithExcelColumn(data.get(0).getClass());
    // 设置Excel文件中的表头
    setHead(handler, fieldList);
    try {
        // 遍历Java对象并将其写入到Excel文件中
        for (int i = 0; i < data.size(); i++) {
            Object rowModel = data.get(i);
            setIndexValue(i + 1);
            Row row = currentSheet.createRow(getRowIndex());
            for (int j = 0; j < fieldList.size(); j++) {
                Field field = fieldList.get(j);
                if (needIgnore(j)) {
                    continue;
                }
                String stringValue = ReflectionUtil.getFieldStringValue(field, rowModel);
                Cell cell = row.createCell(j);
                if (handler != null && handler instanceof AbstractCellStyleStrategy) {
                    ((AbstractCellStyleStrategy) handler).setCellStyle(cell, field, rowModel, getStringValue(stringValue));
                }
                CellData cellData = converterAndSet(cell, stringValue, field);
                setCellComment(row, field, cellData);
            }
        }
    } finally {
        setIndexValue(null);
    }
}

在该方法中,首先获取Java对象中用于映射Excel中数据的属性列表,并设置Excel文件中的表头。然后遍历Java对象并将其写入到Excel文件中,将Java对象中的每个属性值写入到Excel文件对应单元格中,并设置单元格样式、注释等信息。

三、小结一下

通过本文的简单介绍,相信大家对于了解使用EasyExcel进行高效的Excel数据操作已经有了一个基础的入门认识。无论是读取Excel文件、写入Excel文件还是填充Excel文件,EasyExcel都提供了非常简单、易用且高效的解决方案。在实际工作中,我们可以结合自身的需求,选择不同的EasyExcel技巧来更好地完成任务。同时,我们还需要注意一些细节问题,以确保Excel操作的正确性和效率。最后,我也希望大家能够通过阅读本文,更好地掌握Springboot和EasyExcel的使用技巧,并在实际工作中得到应用,给具体的项目添砖加瓦~ v ~ v ~。

以上就是一文带你轻松掌握EasyExcel的使用技巧的详细内容,更多关于EasyExcel使用的资料请关注脚本之家其它相关文章!

您可能感兴趣的文章:
阅读全文