Easyexcel（1-注解使用）

🕗 发布于 2024-11-19 13:36 java excel

版本依赖

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.3</version>
</dependency>

@ExcelProperty

指定当前字段对应excel中的那一列，可以根据名字或者Index去匹配，当然也可以不写。

value：指定写入的列头，如果不指定则使用成员变量的名字作为列头；如果要设置复杂的头，可以为value指定多个值
order：优先级高于value，会根据order的顺序来匹配实体和excel中数据的顺序
index：优先级高于value和order，指定写到第几列，如果不指定则根据成员变量位置排序；默认第一个字段就是index=0
converter：指定当前字段用什么转换器，默认会自动选择。可以用来设置类型转换器，需要实现Converter接口

value

指定属性名

@Data
public class User {

    private Integer userId;

    private String name;

    private String phone;

    private String email;

    private Date createTime;
}

@RestController
public class TestController {

    @GetMapping("/test1")
    public void test1(HttpServletResponse response) {
        try {
            response.setContentType("application/vnd.ms-excel");
            response.setCharacterEncoding("utf-8");
            String fileName = URLEncoder.encode("test1", "UTF-8").replaceAll("\\+", "%20");
            response.setHeader("Content-disposition", "attachment;filename" + fileName + ".xls");

            User user = new User();
            user.setUserId(123);
            user.setName("as");
            user.setPhone("15213");
            user.setEmail("5456");
            user.setCreateTime(13213L);
            EasyExcel.write(response.getOutputStream(), User.class)
                    .sheet("test")
                    .doWrite(Arrays.asList(user));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

默认情况下，使用类的属性名作为Excel的列表，当然也可以使用@ExcelProperty 注解来重新指定属性名称。

@Data
public class User {
    @ExcelProperty(value = "用户Id")
    private Integer userId;
    
    @ExcelProperty(value = "姓名")
    private String name;
    
    @ExcelProperty(value = "手机")
    private String phone;
    
    @ExcelProperty(value = "邮箱")
    private String email;
    
    @ExcelProperty(value = "创建时间")
    private Date createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

表头合并

value在写的时候，如果指定了多个值，会自动进行合并

@Data
public class User {
    @ExcelProperty(value = "用户Id")
    private Integer userId;
    
    @ExcelProperty(value = {"用户基本信息", "姓名"})
    private String name;
    
    @ExcelProperty(value = {"用户基本信息", "手机"})
    private String phone;
    
    @ExcelProperty(value = {"用户基本信息", "邮箱"})
    private String email;
    
    @ExcelProperty(value = "创建时间")
    private Date createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

index

指定位置

@ExcelProperty注解有两个属性index和order，如果不指定则按照属性在类中的排列顺序来。index是指定该属性在Excel中列的下标，下标从0开始

@Data
public class User {
    @ExcelProperty(value = "用户Id", index = 2)
    private Integer userId;
    
    @ExcelProperty(value = "姓名", index = 1)
    private String name;
    
    @ExcelProperty(value = "手机")
    private String phone;
    
    @ExcelProperty(value = "邮箱")
    private String email;
    
    @ExcelProperty(value = "创建时间")
    private Date createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

@Data
public class User {
    @ExcelProperty(value = "用户Id", index = 2)
    private Integer userId;
    
    @ExcelProperty(value = "姓名", index = 1)
    private String name;
    
    @ExcelProperty(value = "手机", index = 10)
    private String phone;
    
    @ExcelProperty(value = "邮箱", index = 12)
    private String email;
    
    @ExcelProperty(value = "创建时间")
    private Date createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

order

指定顺序

@Data
public class User {
    @ExcelProperty(value = "用户Id")
    private Integer userId;
    
    @ExcelProperty(value = "姓名")
    private String name;
    
    @ExcelProperty(value = "手机", order = 11)
    private String phone;
    
    @ExcelProperty(value = "邮箱", order = 10)
    private String email;
    
    @ExcelProperty(value = "创建时间")
    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

order的默认值为Integer.MAX_VALUE，通过效果我们可以得出结论：order值越小，越排在前面

注意：

优先级：index > order > 默认配置
index相当于绝对位置，下标从0开始
order相当于相对位置，值越小的排在越前面

convert

自定义转换器

在读写EXCEL时，有时候需要我们进行数据类型转换，例如我们这里的创建时间，在实体对象中是Long类型，但是这样直接导出到Excel中不太直观。我们需要转换成yyyy-MM-dd HH:mm:ss 格式，此时我们就可以用到转换器。

public class DateTimeConverter implements Converter<Long> {

    private final DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    // 支持导入的Java类型
    @Override
    public Class<?> supportJavaTypeKey() {
        return Long.class;
    }

    // 支持导出的Excel类型
    @Override
    public CellDataTypeEnum supportExcelTypeKey() {
        return CellDataTypeEnum.STRING;
    }

    // 转换为Java
    @Override
    public Long convertToJavaData(ReadCellData<?> cellData, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) throws Exception {
        return null;
    }

    // 转换为Excel
    @Override
    public WriteCellData<?> convertToExcelData(Long value, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) throws Exception {
        if (value == null) {
            return new WriteCellData(CellDataTypeEnum.STRING, null);
        }
        LocalDateTime localDateTime = LocalDateTime.ofInstant(Instant.ofEpochMilli(value), ZoneId.systemDefault());
        String dateStr = localDateTime.format(dateTimeFormatter);
        return new WriteCellData(dateStr);
    }
}

@Data
public class User {
    @ExcelProperty(value = "用户Id")
    private Integer userId;
    
    @ExcelProperty(value = "姓名")
    private String name;
    
    @ExcelProperty(value = "手机", order = 11)
    private String phone;
    
    @ExcelProperty(value = "邮箱", order = 10)
    private String email;
    
    @ExcelProperty(value = "创建时间", converter = DateTimeConverter.class)
    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

枚举转换

/**
 * Excel 性别转换器
 */
public class GenderConverter implements Converter<Integer> {
    @Override
    public Class<?> supportJavaTypeKey() {
        return Integer.class;
    }

    @Override
    public CellDataTypeEnum supportExcelTypeKey() {
        return CellDataTypeEnum.STRING;
    }

    @Override
    public Integer convertToJavaData(ReadConverterContext<?> context) {
        return GenderEnum.convert(context.getReadCellData().getStringValue()).getValue();
    }

    @Override
    public WriteCellData<?> convertToExcelData(WriteConverterContext<Integer> context) {
        return new WriteCellData<>(GenderEnum.convert(context.getValue()).getDescription());
    }
}

/**
 * 性别枚举
 */
@Getter
@AllArgsConstructor
public enum GenderEnum {

    UNKNOWN(0, "未知"),

    MALE(1, "男性"),

    FEMALE(2, "女性");

    private final Integer value;

    private final String description;

    public static GenderEnum convert(Integer value) {
        return Stream.of(values())
                .filter(bean -> bean.value.equals(value))
                .findAny()
                .orElse(UNKNOWN);
    }

    public static GenderEnum convert(String description) {
        return Stream.of(values())
                .filter(bean -> bean.description.equals(description))
                .findAny()
                .orElse(UNKNOWN);
    }
}

@ExcelIgnore

默认所有字段都会和excel去匹配，加了这个注解会忽略该字段

@Data
public class User {
    @ExcelProperty(value = "用户Id")
    private Integer userId;
    
    @ExcelProperty(value = "姓名")
    private String name;
    
    @ExcelProperty(value = "手机")
    private String phone;
    
    @ExcelProperty(value = "邮箱")
    @ExcelIgnore
    private String email;
    
    @ExcelProperty(value = "创建时间", converter = DateTimeConverter.class)
    @ExcelIgnore
    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

@ExcelIgnoreUnannotated

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

@ExcelIgnoreUnannotated
@Data
public class User {

    @ExcelProperty(value = "用户Id")
    private Integer userId;

    @ExcelProperty(value = "姓名")
    private String name;

    @ExcelProperty(value = "手机")
    private String phone;

    private String email;

    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

@ColumnWidth

用于设置表格列的宽度

@Data
public class User {

    @ColumnWidth(200)
    @ExcelProperty(value = "用户Id")
    private Integer userId;

    @ExcelProperty(value = "姓名")
    private String name;

    @ExcelProperty(value = "手机")
    private String phone;

    @ExcelProperty(value = "邮箱")
    private String email;

    @ExcelProperty(value = "创建时间", converter = DateTimeConverter.class)
    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

@ContentRowHeight

标注在类上，指定内容行高

@Data
@ContentRowHeight(value = 50)
public class User {

    @ExcelProperty(value = "用户Id")
    private Integer userId;

    @ExcelProperty(value = "姓名")
    private String name;

    @ExcelProperty(value = "手机")
    private String phone;

    @ExcelProperty(value = "邮箱")
    private String email;

    @ExcelProperty(value = "创建时间", converter = DateTimeConverter.class)
    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

@HeadRowHeight

标注在类上，指定列头行高

@Data
@HeadRowHeight(80)
@ContentRowHeight(value = 50)
public class User {

    @ExcelProperty(value = "用户Id")
    private Integer userId;

    @ExcelProperty(value = "姓名")
    private String name;

    @ExcelProperty(value = "手机")
    private String phone;

    @ExcelProperty(value = "邮箱")
    private String email;

    @ExcelProperty(value = "创建时间", converter = DateTimeConverter.class)
    private Long createTime;
}

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

@ContentStyle

用于设置内容格式注解

dataFormat：日期格式
hidden：设置单元格使用此样式隐藏
locked：设置单元格使用此样式锁定
quotePrefix：在单元格前面增加`符号，数字或公式将以字符串形式展示
horizontalAlignment：设置是否水平居中
wrapped：设置文本是否应换行。将此标志设置为true通过在多行上显示使单元格中的所有内容可见
verticalAlignment：设置是否垂直居中
rotation：设置单元格中文本旋转角度。03版本的Excel旋转角度区间为-90°90°，07版本的Excel旋转角度区间为0°180°
indent：设置单元格中缩进文本的空格数
borderLeft：设置左边框的样式
borderRight：设置右边框样式
borderTop：设置上边框样式
borderBottom：设置下边框样式
leftBorderColor：设置左边框颜色
rightBorderColor：设置右边框颜色
topBorderColor：设置上边框颜色
bottomBorderColor：设置下边框颜色
fillPatternType：设置填充类型
fillBackgroundColor：设置背景色
fillForegroundColor：设置前景色
shrinkToFit：设置自动单元格自动大小

@ContentFontStyle

用于设置单元格内容字体格式的注解

fontName：字体名称
fontHeightInPoints：字体高度
italic：是否斜体
strikeout：是否设置删除水平线
color：字体颜色
typeOffset：偏移量
underline：下划线
bold：是否加粗
charset：编码格式

@HeadStyle

用于设置标题样式

dataFormat：日期格式
hidden：设置单元格使用此样式隐藏
locked：设置单元格使用此样式锁定
quotePrefix：在单元格前面增加`符号，数字或公式将以字符串形式展示
horizontalAlignment：设置是否水平居中
wrapped：设置文本是否应换行。将此标志设置为true通过在多行上显示使单元格中的所有内容可见
verticalAlignment：设置是否垂直居中
rotation：设置单元格中文本旋转角度。03版本的Excel旋转角度区间为-90°90°，07版本的Excel旋转角度区间为0°180°
indent：设置单元格中缩进文本的空格数
borderLeft：设置左边框的样式
borderRight：设置右边框样式
borderTop：设置上边框样式
borderBottom：设置下边框样式
leftBorderColor：设置左边框颜色
rightBorderColor：设置右边框颜色
topBorderColor：设置上边框颜色
bottomBorderColor：设置下边框颜色
fillPatternType：设置填充类型
fillBackgroundColor：设置背景色
fillForegroundColor：设置前景色
shrinkToFit：设置自动单元格自动大小

@HeadFontStyle

用于定制标题字体格式

fontName：设置字体名称
fontHeightInPoints：设置字体高度
italic：设置字体是否斜体
strikeout：是否设置删除线
color：设置字体颜色
typeOffset：设置偏移量
underline：设置下划线
charset：设置字体编码
bold：设置字体是否加粗

@ContentLoopMerge

用于设置合并单元格的注解，作用于字段上

eachRow：合并列
columnExtend：合并行

@OnceAbsoluteMerge

用于指定位置的单元格合并，作用于类上

firstRowIndex：第一行下标
lastRowIndex：最后一行下标
firstColumnIndex：第一列下标
lastColumnIndex：最后一列下标

@DateTimeFormat

日期转换，读取Excel文件时用String去接收excel日期格式的数据会调用这个注解。里面的value参照java.text.SimpleDateFormat

@Data
public class User {

    @ExcelProperty(value = "用户Id")
    private Integer userId;

    @ExcelProperty(value = "姓名")
    private String name;

    @ExcelProperty(value = "手机")
    private String phone;

    @ExcelProperty(value = "邮箱")
    private String email;

    @DateTimeFormat("yyyy-MM-dd")
    @ExcelProperty(value = "创建时间")
    private Date createTime;
}

@NumberFormat

数字转换，用String去接收excel数字格式的数据会调用这个注解。里面的value参照java.text.DecimalFormat
最后一列下标

@DateTimeFormat

日期转换，读取Excel文件时用String去接收excel日期格式的数据会调用这个注解。里面的value参照java.text.SimpleDateFormat

@Data
public class User {

    @ExcelProperty(value = "用户Id")
    private Integer userId;

    @ExcelProperty(value = "姓名")
    private String name;

    @ExcelProperty(value = "手机")
    private String phone;

    @ExcelProperty(value = "邮箱")
    private String email;

    @DateTimeFormat("yyyy-MM-dd")
    @ExcelProperty(value = "创建时间")
    private Date createTime;
}

@NumberFormat

数字转换，用String去接收excel数字格式的数据会调用这个注解。里面的value参照java.text.DecimalFormat

原文地址：https://blog.csdn.net/peng_gx/article/details/143869631

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：【AI+教育】一些记录@2024.11.16
下一篇：C++设计模式行为模式———迭代器模式

智慧社区管理系统平台提升物业运营效率与用户体验
智慧社区管理系统平台通过创新技术与管理模式，大幅提升物业运营效率与用户体验。系统支持在线缴费、公告发布、访客信息管理等功能，方便物业实现高效服务与信息透明。通过智慧巡检、停车费收取等便捷操作，帮助居民
阅读更多2024-11-23
Python Scikit-learn简介（二）
特征提取是将原始数据转换为更适合机器学习模型的特征表示。Scikit-learn提供了多种特征提取工具，如。机器学习的数据，可以划分为训练集、验证集和测试集，也可以划分为训练集和测试集。数据清洗是数据
阅读更多2024-11-23
Vue3 源码解析（三）：静态提升
Vue3 尚未发布正式版本前，尤大在一次关于 Vue3 的分享中提及了静态提升，当时笔者就对这个亮点产生了好奇，所以在源码阅读时，静态提升也是笔者的一个重点阅读点。那么什么是静态提升呢？当 Vue 的
阅读更多2024-11-23
高级java每日一道面试题-2024年11月21日-数据结构篇-红黑树有哪几个特征?
红黑树通过五个特性来保持树的平衡性，确保了在插入和删除操作后树的高度仍然接近对数级别。这些特性使得红黑树在许多实际应用中非常有用，特别是在需要高效查找、插入和删除操作的场景中。在 Java 高级面试中
阅读更多2024-11-23
【C++习题】10.反转字符串中的单词 lll
【代码】【C++习题】10.反转字符串中的单词 lll。
阅读更多2024-11-23
大疆上云api开发
涉及到使用大疆机场上云api开发遇到的一系列问题
阅读更多2024-11-23
leetcode:112. 路径总和
给你二叉树的根节点root和一个表示目标和的整数targetSum。判断该树中是否存在的路径，这条路径上所有节点值相加等于目标和targetSum。如果存在，返回true；否则，返回false。是指没
阅读更多2024-11-23
力扣 LeetCode 701. 二叉搜索树中的插入操作（Day10：二叉树）
全部插入到叶子节点即可。
阅读更多2024-11-23
Python后端flask框架接收zip压缩包方法
Python后端flask框架速查
阅读更多2024-11-23
利用c语言详细介绍下希尔排序
希尔排序是针对插入排序的优化算法。它是缩少增量的算法，一开始增量从元素个数len/2的增量开始，然后缩小增量gap=gap/2，直到gap为1，最终完成序列排序。
阅读更多2024-11-23

Easyexcel（1-注解使用）

版本依赖

@ExcelProperty

value

指定属性名

表头合并

index

指定位置

order

指定顺序

convert

自定义转换器

枚举转换

@ExcelIgnore

@ExcelIgnoreUnannotated

@ColumnWidth

@ContentRowHeight

@HeadRowHeight

@ContentStyle

@ContentFontStyle

@HeadStyle

@HeadFontStyle

@ContentLoopMerge

@OnceAbsoluteMerge

@DateTimeFormat

@NumberFormat

@DateTimeFormat

@NumberFormat

相关文章