使用EasyPoi完成复杂一对多excel表格导出功能全过程

 更新时间:2022年12月12日 09:05:35   作者:南独酌酒nvn  
这篇文章主要介绍了使用EasyPoi完成复杂一对多excel表格导出功能全过程,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教

业务需求

从一个简单的仓库业务说起,仓库业务,会有进库记录,会有出库记录,会有库存,客户的需求就是需要一个库存盘点单,盘点单通俗来讲:将库存中每个商品的出入库记录都统计出来,看看每个商品出过多少货物,入过多少货物,本月库存多少,上月库存多少。

需求难点

一个货物会出过多次货物,入过多次货物,导出的 excel 就要做成 一对多 格式的导出

简单举例:

啤酒:入库2次,出库3次,最终体现在 excel 中效果如下图:

通过 EasyPoi 实现需求

EasyPoi 文档地址:http://doc.wupaas.com/docs/easypoi/easypoi-1c0u4mo8p4ro8

SpringBoot 使用:

<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-base</artifactId>
    <version>4.2.0</version>
</dependency>
<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-annotation</artifactId>
    <version>4.2.0</version>
</dependency>
<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-web</artifactId>
    <version>4.2.0</version>
</dependency>

Gradle 使用:

implementation 'cn.afterturn:easypoi-base:4.2.0'
implementation 'cn.afterturn:easypoi-annotation:4.2.0'
implementation 'cn.afterturn:easypoi-web:4.2.0'

使用 EasyPoi 提供的注解,自定义导出类模板

import cn.afterturn.easypoi.excel.annotation.Excel;
import cn.afterturn.easypoi.excel.annotation.ExcelCollection;
import cn.afterturn.easypoi.excel.annotation.ExcelIgnore;
import lombok.Getter;
import lombok.Setter;

import java.io.Serializable;
import java.math.BigDecimal;
import java.util.Date;
import java.util.List;

/**
 * 导出 excel 模板类
 */
@Getter
@Setter
public class ExportTemplate implements Serializable {
    @Excel(name = "序号", needMerge = true, type = 10)
    private int index;
    
    @Excel(name = "商品名称", needMerge = true, width = 30.0)
    private String goodName;
    
    @Excel(name = "商品单位", needMerge = true)
    private String goodUnit;
    
    @Excel(name = "上月库存数量", needMerge = true, type = 10)
    private Integer lastMonthSurplusNum;
    
    @Excel(name = "本月库存数量", needMerge = true, type = 10)
    private Integer thisMonthSurplusNum;
    
    @ExcelCollection(name = "本月入库信息")
    private List<GoodInItem> goodInItems;
    
    @ExcelCollection(name = "本月出库信息")
    private List<GoodOutItem> goodOutItems;
    
    @Excel(name = "备注", needMerge = true, width = 30.0)
    private String remark;

    /**
     * 入库信息
     */
    @Getter
    @Setter
    public static class GoodInItem {
        @Excel(name = "入库日期", exportFormat = "yyyy-MM-dd", width = 20.50)
        private Date purchaseDate;
        
        @Excel(name = "入库号", width = 25.50)
        private String purchaseNum;
        
        @Excel(name = "入库单价", type = 10)
        private BigDecimal unitPrice;
        
        @Excel(name = "入库数量", type = 10)
        private Integer totalNum;
    }

    /**
     * 出库信息
     */
    @Getter
    @Setter
    public static class GoodOutItem {
        @Excel(name = "出库日期", exportFormat = "yyyy-MM-dd", width = 20.50)
        private Date outDate;
        
        @Excel(name = "出库号", width = 25.50)
        private String sellNum;
        
        @Excel(name = "出库数量", type = 10)
        private Integer totalNum;
        
        @Excel(name = "成本金额", type = 10)
        private BigDecimal priceIn;
        
        @Excel(name = "销售金额", type = 10)
        private BigDecimal priceOut;
    }
}

实体类中使用的注解作用解释:

  • 1.@Getter lombok 注解,用于给所有属性提供 getter 方法
  • 2.@Setter lombok 注解,用于给所有属性提供 setter 方法
  • 3.@Excel easypoi 注解,name 就等于导出 excel 的列名称,width 就是宽度,type 就是这个属性的类型,1表示文本,默认也是文本,10就是数字,needMerge 表示是否纵向合并单元格,也就是上下列合并
  • 4.@ExcelCollection easypoi 注解,name 就等于导出 excel 的列名称,被此注解标注的集合,就等于在其列下面创建对等数量的行,就类似于这种

最后模板弄好之后,就可以通过easypoi 的工具类来导出,easypoi 推荐的导出工具类如下:

这个方法的三个参数表示含义解释:

  • ExportParams :参数表示Excel 导出参数设置类,easypoi 自定义的类
  • pojoClass:你要导出的类模板
  • dataSet:数据集合

具体实现

@GetMapping(value = "export")
public void export(HttpServletRequest req, HttpServletResponse resp) {
	List<ExportTemplate> exportData = new ArrayList();
	// 步骤1:构建要导出excel的数据集合
	for (int i = 0; i < 5; i++) {
		ExportTemplate data = new ExportTemplate();
        data.setIndex(i);
		data.setGoodName("测试商品");
		data.setGoodUnit("瓶");
		data.setLastMonthSurplusNum(5); // 上月库存
		data.setThisMonthSurplusNum(3); // 本月库存
		// ... 剩下的就是类似的加值
        exportData.add(data);
	}

	try {
		// 步骤2:开始导出 excel
		ExportParams params = new ExportParams();
		params.setTitle("库存盘点单标题");
		params.setSheetName("库存盘点单工作表名称");
		params.setType(ExcelType.XSSF);
		Workbook workbook = ExcelExportUtil.exportExcel(params, ExportTemplate.class, exportData);
		
		String nowStr = DateTimeFormatter.ofPattern(LocalDateTime.now()).format("yyyyMMddHHmm"); // 时间串
		String fileName = nowStr + "_库存盘点单"; // 文件名称
		String tempDir = "C:/Users/huxim/Downloads";
		File filePath = new File(tempDir + File.separator);
		if (!filePath.exists()) filePath.mkdirs(); // 如果文件目录不存在就创建这个目录

		FileOutputStream fos = new FileOutputStream(tempDir + File.separator + fileName);
		workbook.write(fos);
		fos.close();

		resp.setContentType("application/octet-stream");
		resp.setCharacterEncoding("utf-8");
		response.addHeader("Content-disposition", "attachment; filename="
                    + this.makeDownloadFileName(req, fileName));
		IOUtils.copy(new FileInputStream(tempFile), response.getOutputStream());
		System.out.println("导出成功~~~");
	} catch (Exception e) {
		throw new RuntimeException("导出 excel 失败~~~");
	}
}

/**
 * 判断是否是 IE 浏览器
 * 返回对应的字符串格式
 */
public static String makeDownloadFileName(HttpServletRequest request, String fileName) {
	String agent = request.getHeader("User-Agent");
    byte[] bytes = fileName.getBytes(StandardCharsets.UTF_8);
    if (agent.contains("MSIE") || agent.contains("Trident") || agent.contains("Edge")) {
    	// IE
        return new String(bytes, StandardCharsets.UTF_8);
	} else {
       	return new String(bytes, StandardCharsets.ISO_8859_1);
	}
}

导出成功后的excel 就类似于如下这种:

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Java 中的 Class.forName(类名) 使用及原理解析

    Java 中的 Class.forName(类名) 使用及原理解析

    Class.forName是Java中用于动态加载类的强大工具,广泛应用于数据库驱动加载、反射机制和插件系统等场景,它通过ClassLoader加载类并执行静态初始化代码,但在使用时需要注意类路径、初始化副作用和类加载器的选择等问题,感兴趣的朋友一起看看吧
    2024-12-12
  • Java无需解压直接读取ZIP压缩包里的文件及内容

    Java无需解压直接读取ZIP压缩包里的文件及内容

    最近开发的时候遇到要获取到zip压缩包里面的文件内容,解决方案就是通过ZipInputStream来读取,下面通过实例代码介绍Java无需解压直接读取ZIP压缩包里的文件及内容,感兴趣的朋友跟随小编一起看看吧
    2024-03-03
  • 重学SpringBoot3之日志Logging使用方式

    重学SpringBoot3之日志Logging使用方式

    在日常开发中会遇到不同的异常,日志方便我们去排查处理,这篇文章主要给大家介绍了关于重学SpringBoot3之日志Logging使用方式的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-06-06
  • Windows配置多版本JDK的详细步骤

    Windows配置多版本JDK的详细步骤

    JDK是Java开发工具包的缩写,包含了Java编译器、Java虚拟机、Java类库等众多组件,是Java开发的基石,提供了编写、编译和运行Java程序所必需的工具,有时候项目需要不同的JDK版本,所以本文给大家介绍了Windows配置多版本JDK的详细步骤,需要的朋友可以参考下
    2025-04-04
  • 详解如何把Java中if-else代码重构成高质量代码

    详解如何把Java中if-else代码重构成高质量代码

    这篇文章主要介绍了详解如何把Java中if-else代码重构成高质量代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • Java中正则表达式的语法以及matches方法的使用方法

    Java中正则表达式的语法以及matches方法的使用方法

    正则表达式(Regular Expression)是一门简单语言的语法规范,是强大、便捷、高效的文本处理工具,这篇文章主要给大家介绍了关于Java中正则表达式的语法以及matches方法的使用方法,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-05-05
  • 详解Java如何简化条件表达式

    详解Java如何简化条件表达式

    在复杂的实际业务中,往往会出现各种嵌套的条件判断逻辑。随着需求的增加,条件逻辑会变得越来越复杂。面对这种情况,简化判断逻辑就是不得不做的事情,下面为大家介绍几种方法
    2022-06-06
  • Java类的加载时机与过程

    Java类的加载时机与过程

    这篇文章主要介绍了Java类的加载时机与过程,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2021-12-12
  • Java杂谈之类和对象 封装 构造方法以及代码块详解

    Java杂谈之类和对象 封装 构造方法以及代码块详解

    在现实世界中,真实存在的东西,比如吉普车,卡丁车,货车。我们在认识它的时候就会在脑海中将它抽象为一种类别叫做车。 好了,那再计算机世界中,它同样的也会这样做
    2021-09-09
  • spring boot如何使用POI读取Excel文件

    spring boot如何使用POI读取Excel文件

    本文主要介绍使用POI进行Excel文件的相关操作,涉及读取文件,获取sheet表格,对单元格内容进行读写操作,以及合并单元格的操作
    2021-08-08

最新评论