EasyExcel 基础用法

1.使用注解导出基础格式数据

1.1 创建数据格式基础描述类
java 复制代码
@Data
@AllArgsConstructor
public class ExcelData{

    @ExcelProperty(value="第一列", index = 0)
    private String col1;

    @ExcelProperty(value="第二列", index = 1)
    private String col2;
   
    @ExcelProperty(value="第三列", index = 2)
    private String col3;

    @ExcelProperty(value="第四列", index = 3)
    private String col4;

}

常用基础注解:

@ExcelProperty 注解 , value 设置标题 ,index 设置标题排序 ,位置从 0 开始

@ContentStyle 注解,horizontalAlignment 设置风格

@ColumnWidth 注解,设置单元格的宽度

1.2 导出数据

EasyExcel.write(文件路径 / 数据流(比如:response.getOutputStream(),new FileOutputStream() )).head(ExcelData.class).sheet("sheet1").doWrite(excelDataList );

write() 方法设置数据目标数据流 ,

head() 方法设置标题

sheet() 方法设置 sheet 数据页的名字

doWrite 方法将数据写到数据流中

1.3 导出数据示例

ExcelData excelDate = new ExcelData(1,2,3,4);

2. 单元行合并设置

单元格合并可以继承 AbstractRowWriteHandler 类或者实现 CellWriteHandler 类,重写两个类中的 afterRowDispose/afterCellDataWrite方法,两个方法的核心点如下:

  1. 生成 CellRangeAddress 对象,该对象用于描述单元格合并方式,如

new CellRangeAddress(1, 3, 1, 1) ,描述纵向合并单元格 ,合并 1~3 三行

new CellRangeAddress(1, 1, 1, 3) ,描述横向合并单元格 ,合并 1~3 三列

  1. 需要将生成的 CellRangeAddress 添加,如下

writeSheetHolder.getSheet().addMergedRegionUnsafe(cellRangeAddress);

(writeSheetHolder : 该对象是 afterRowDispose/afterCellDataWrite 方法入参,不需要关心)

注意:重写方法后还不能实现单元格合并,需要将处理类注入,如下:

EasyExcel.write(fileName, CityExportDTO.class) .registerWriteHandler( 你的单元格数据处理类(new YourObject()) ).sheet("Sheet1").doWrite(dataList);

3. 单excel 文件多 sheet 页数据写入

  1. 创建一个 ExcelWriter 对象 ExcelWriter writer = EasyExcel.write(文件路径 / 数据流).build();

该代码可以理解为创建了一个 excel 文档

  1. 创建一个 WriteSheet 对象(如下),该代码可以理解为创建了一个 sheet 页(如果是多个sheet 页,多写几次创建sheet 页代码或者循环创建)

WriteSheet sheet = EasyExcel.writerSheet(index,sheetName).head().build();

  1. 将第二步中的sheet 页写入到第一步的 excel 文档中,使用 writer.write(dataList(要写入的数据), sheet (sheet 页对象) ); (多个 sheet 页多写几次代码)

  2. 将数据从内存刷入到文件中,writer.finish()

如果写入多个 sheet 页到同一个文档中或者将数据分页都可以使用该方法,writer.finish() 方法千万不能漏掉

4. 自定义 excel 数据读取类型转换器

实现 Converter 类重写 ConvertToJavaData 方法,如:我需要自定义String类型日期转换为 LocalDateTime 类型

java 复制代码
import com.alibaba.excel.converters.Converter;
import com.alibaba.excel.enums.CellDataTypeEnum;
import com.alibaba.excel.metadata.GlobalConfiguration;
import com.alibaba.excel.metadata.data.ReadCellData;
import com.alibaba.excel.metadata.data.WriteCellData;
import com.alibaba.excel.metadata.property.ExcelContentProperty;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;

/**
 * EasyExcel自定义转换器:将String类型转换为LocalDateTime类型
 */
public class StringToLocalDateTimeConverter implements Converter<LocalDateTime> {

    // 支持的日期格式,可根据实际需求扩展
    private static final FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");


    /**
     * 从Excel读取数据时,将String转换为LocalDateTime
     */
    @Override
    public LocalDateTime convertToJavaData(ReadCellData<?> cellData, ExcelContentProperty contentProperty, 
                                         GlobalConfiguration globalConfiguration) {
        String dateStr = cellData.getStringValue();
        if (dateStr == null || dateStr.trim().isEmpty()) {
            return null;
        }
        return LocalDateTime.parse(dateStr, FORMATTER);
  
    }

}

自定义类写好后需要在字段注解中注入该转换类,如下:

@ExcelProperty(value = "创建时间", converter = StringToLocalDateTimeConverter.class)
private LocalDateTime createTime;

相关推荐
椎名澄嵐11 小时前
★ Linux ★ 信号
linux·运维·服务器·开发语言·c++
Li zlun11 小时前
Kubernetes 进阶实战:CRD、Gateway API 与优先级调度
java·kubernetes·gateway
七夜zippoe11 小时前
Java 生态监控体系实战:Prometheus+Grafana+SkyWalking 整合全指南(二)
java·grafana·prometheus
没事学AI11 小时前
Caffeine三种缓存过期策略总结:原理、实战与调优
java·缓存·caffeine·缓存穿透防护·caffeine缓存
Micro麦可乐11 小时前
为什么两个看似相等的 Integer 却不相等?一次诡异的缓存折扣商品 BUG 排查
java·缓存·bug·包装类判断·integer判断
杨杨杨大侠11 小时前
手把手教你写 httpclient 框架(七)- 异步处理与性能优化
java·http·github
ajassi200012 小时前
开源 java android app 开发(十四)自定义绘图控件--波形图
android·java·开源
一叶飘零_sweeeet12 小时前
从 0 到 1 精通 SkyWalking:分布式系统的 “透视镜“ 技术全解析
java·skywalking
七夜zippoe12 小时前
Java 生态监控体系实战:Prometheus+Grafana+SkyWalking 整合全指南(三)
java·grafana·prometheus
陈遇巧12 小时前
Spring Framework
java·笔记·spring