1. 编程号首页

poi导出数据到excel模板_excel表格导入excel文件

编程小号 • • 未分类

poi导出数据到excel模板_excel表格导入excel文件在Java日常开发过程中，实现Excel文件的导入导出功能是一项常见的需求

写在前面

在Java日常开发过程中，实现Excel文件的导入导出功能是一项常见的需求。

通过使用相关的Java库，如Apache POI、EasyPoi或EasyExcel，可以轻松地实现Excel文件的读写操作。

而这篇文章将介绍如何在Java中使用Apache POI、EasyPoi 和EasyExcel库来进行Excel文件的导入和导出操作，帮助您快速掌握这一实用的技能。

一、使用场景

下面是excel导入导出的几个最常用的使用场景。

①企业管理系统：企业管理系统通常需要导入员工信息、客户信息、销售数据等大量数据到系统中，以及导出报表、数据分析结果等信息。

②学校教务系统：学校教务系统可能需要导入学生信息、课程表、成绩等数据，以及导出学生成绩单、教师工资表等信息。

③电子商务平台：电子商务平台需要导入商品信息、订单数据等内容，以及导出销售报表、库存清单等信息，方便管理和分析。

④ 人力资源管理系统：人力资源管理系统需要导入员工档案、薪资信息等数据，以及导出薪资条、考勤报表等信息，方便人力资源管理和工资结算。

⑤ 医院信息系统：医院信息系统可能需要导入患者信息、医疗记录等数据，以及导出医疗报告、统计分析等信息，方便医护人员进行医疗服务和管理。

以上仅是一些常见的使用场景，实际上各种系统中的Excel导入导出功能可以根据具体需求进行定制和扩展

二、三个库简介

1、Apache POI

Apache POI是一个流行的Java库，用于处理Microsoft Office格式文件，包括Excel、Word和PowerPoint。它提供了丰富的API，可以创建、读取和修改各种类型的Office文档。

官网：https://poi.apache.org/

优点：

  1. 功能强大：支持处理复杂的Excel文件，包括单元格、样式、图表等内容。

  2. 稳定性高：作为一个成熟的开源项目，得到广泛支持和持续维护。

  3. 灵活性：可以满足各种定制化需求，可以实现复杂的Excel处理功能。

缺点：

  1. 学习曲线较陡：对于初学者来说，学习成本可能较高。
  2. 性能相对较低：在处理大量数据时，性能可能受到一定影响。
2、EasyPoi

easypoi功能如同名字easy,主打的功能就是容易,让一个没见接触过poi的人员 就可以方便的写出Excel导出,Excel模板导出,Excel导入,Word模板导出,通过简单的注解和模板 语言(熟悉的表达式语法),完成以前复杂的写法

官网： https://gitee.com/lemur/easypoi

优点：

  1. 简单易用：EasyPoi 提供了简洁的 API 接口，使得 Excel 操作更加便捷。
  2. 功能丰富：支持 Excel 文件的导入导出、模板导出、校验等多种功能。
  3. 易于扩展：EasyPoi 基于 Apache POI 和 JexcelApi，可以方便地扩展和定制功能。
  4. 文档齐全：EasyPoi 提供了详细的文档和示例，便于开发人员学习和使用。

缺点：

  1. 功能有限：相比于 Apache POI，EasyPoi 可能在一些高级功能上有所限制。
  2. 可能存在性能问题：由于封装层的存在，EasyPoi 在处理大量数据时可能存在一定的性能损耗。
3、EasyExcel

EasyExcel是一个阿里巴巴基于Apache POI封装的开源框架，专注于Excel文件的读写操作。它提供了简洁易用的API，简化了Excel处理的流程。

官网：https://easyexcel.opensource.alibaba.com/

优点：

  1. 简单易用：提供了简洁的API，使用起来非常方便。
  2. 高性能：在处理大量数据时具有较高的性能，能够快速导入导出Excel文件。
  3. 支持注解：支持使用注解配置Excel文件的导入导出规则，简化了开发过程。

缺点：

  1. 功能相对有限：相比Apache POI，功能相对简单，可能无法满足某些复杂的Excel处理需求。
  2. 定制化能力较弱：定制化能力不如Apache POI灵活。

POI和EasyExcel区别

三 、各版本Excel 区别

不同版本的Excel在功能和格式上可能会有一些差异。所以后续在处理不同版本的excel时，会有少许不同

以下是一些常见的Excel版本之间的区别

1、Excel 97-2003（.xls）
  • 最大行数为65536行，最大列数为256列。
  • 支持的最大单元格格式有限。
  • 不支持新的Excel特性，如条件格式、表格样式等。
  • 文件大小限制为2GB。
2、Excel 2007及以上版本（.xlsx）
  • 最大行数和列数均有较大提升，支持数百万行数和16384列。
  • 支持更多的单元格格式和样式。
  • 引入了新的功能，如条件格式、表格样式、数据透视表等。
  • 支持更多的图表类型和图表样式。
  • 文件大小限制较大，最多可达16,384 x 1,048,576个单元格。

四 、Excel 基本结构介绍

Java是面向对象的操作语言，万物皆对象。了解了Excel基本结构有助于我们将Excel与Java中对象关联起来

  • 工作簿（Workbook）： Excel文件以工作簿的形式存在，一个工作簿可以包含多个工作表（Sheet）
  • 工作表（Sheet）： 每个工作表由行（Row）和列（Column）组成，交叉形成单元格（Cell），用于存储数据、文本、公式等内容
  • 单元格（Cell）： Excel中的最小单位，用于存储数据或公式。每个单元格有一个唯一的地址，例如A1、B2等
  • 行（Row）和列（Column）： 行是水平方向的一组单元格，列是垂直方向的一组单元格。行用数字标识，列用字母标识
  • 公式（Formula）： Excel支持使用公式进行计算和数据处理。公式以等号（=）开头，可以引用其他单元格的数值或内容进行运算
  • 函数（Function）： Excel提供了大量的内置函数，用于进行各种复杂的计算和数据处理，如SUM（求和）、AVERAGE（平均值）、VLOOKUP（垂直查找）

Excel基本结构

五、Apache POI基本操作

由于Excel分为03版本和07版本，所以我们在使用的时候需要

注：

  • 处理03版本excel时，主要使用HSSFWorkbook、HSSFSheet、HSSFRow、HSSFCell等对象来操作Excel文件；

  • 处理07版本及之后版本excel时，主要使用XSSFWorkbook、XSSFSheet、XSSFRow、XSSFCell等对象来操作Excel文件

其他操作基本是一样的，了解这个之后，后续操作就很简单了~

5.1 基本写操作
5.1.1 03版本写excel

① 引入依赖

<!--poi 03版本依赖--> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>4.1.2</version> </dependency> <!--单元测试--> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.13.2</version> <scope>test</scope> </dependency> <!--日期--> <dependency> <groupId>joda-time</groupId> <artifactId>joda-time</artifactId> <version>2.10.10</version> </dependency>

②实例代码

public class AppTest { 
    String filepath="E:\\xiezhrspace\\excel-demo\\fileoutput\\"; @Test public void poiexcel03Test() throws Exception{ 
    //1、创建一个工作簿 Workbook workbook = new HSSFWorkbook(); //2、创建一个工作表 Sheet sheet = workbook.createSheet("第一个工作表"); //3、创建一行 //3.1 创建第一行 Row row1 = sheet.createRow(0); //3.2 创建第二行 Row row2 = sheet.createRow(1); //3.3 创建第三行 Row row3 = sheet.createRow(2); //4 创建一个单元格 //4.1 创建第一行第一个单元格 Cell cell11 = row1.createCell(0); //4.2 创建第一行第二个单元格 Cell cell12 = row1.createCell(1); //4.3 创建第二行第一个单元格 Cell cell21 = row2.createCell(0); //4.4 创建第二行第二个单元格 Cell cell22 = row2.createCell(1); //4.5 创建第三行第一个单元格 Cell cell31 = row3.createCell(0); //4.6 创建第三行第二个单元格 Cell cell32 = row3.createCell(1); // 5 设置单元格的值 //5.1 设置第一行第一个单元格 cell11.setCellValue("个人公众号"); //5.2 设置第一行第二个单元格 cell12.setCellValue("XiezhrSpace"); //5.3 设置第二行第一个单元格 cell21.setCellValue("个人博客"); //5.4 设置第二行第二个单元格 cell22.setCellValue("www.xiezhr.cn"); //5.5 设置第三行第一个单元格 cell31.setCellValue("当前时间"); //5.6 设置第三行第二个单元格 String curdate = new DateTime().toString("yyyy-MM-dd HH:mm:ss"); cell32.setCellValue(curdate); FileOutputStream fileOutputStream = new FileOutputStream(filepath + "poiexcel03.xls"); workbook.write(fileOutputStream); fileOutputStream.close(); workbook.close(); } }

③ excel写出效果

image-20240303162520227

5.1.2 07版本写excel

07 版本依赖与处理03版本的有点不一样，代码基本上不变

① 所需依赖

<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>4.1.2</version> </dependency>

② 代码修改

07版本操作与03版本操作基本没什么变化，我们只需将03版本代码中new HSSFWorkbook() 修改成new XSSFWorkbook()

new FileOutputStream(filepath + "poiexcel03.xls") 修改成new FileOutputStream(filepath + "poiexcel07.xlsx") 即可

 Workbook workbook = new XSSFWorkbook(); ...省略 FileOutputStream fileOutputStream = new FileOutputStream(filepath + "poiexcel07.xlsx");

③ 最终效果

07版本操作

5.1.3 03版本批量写excel

①代码

@Test public void testBigDateExcelTest() throws Exception { 
    Workbook workbook = new HSSFWorkbook(); Sheet sheet = workbook.createSheet("大文件导出测试"); long begin = System.currentTimeMillis(); 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("("+(rowNum+1) + "," + (cellNum+1)+")"); } } FileOutputStream fileOutputStream = new FileOutputStream(filepath + "03版本批量写入.xls"); workbook.write(fileOutputStream); fileOutputStream.close(); workbook.close(); long end = System.currentTimeMillis(); System.out.println("耗时："+(double)(end-begin)/1000+"秒"); }

②最终效果

根据记录时间，耗时：1.663秒

03版本批量写入

5.1.4 07版本批量写excel

① 代码修改

我们只需将上面new HSSFWorkbook() 修改成new XSSFWorkbook()

new FileOutputStream(filepath + "03版本批量写入.xls") 修改成new FileOutputStream(filepath + "07版本批量写入.xlsx") 即可

Workbook workbook = new XSSFWorkbook(); ...省略 FileOutputStream fileOutputStream = new FileOutputStream(filepath + "07版本批量写入.xlsx");

② 最终效果

由于07及以上版本，没有限制行数，所以在写入数据时耗时相比较长。共耗时：10.959秒

07版本数据批量写入

注意： 如果03版本写入数据行数超过65536行会报如下错误，而07版本的不会报错

65536超出报错

5.1.5 07版本批量写入优化

通过上面的列子，我们可以看出来在07版本中批量写入大数据的时候耗时比较长，这小节，我们就使用apach提供新的类来优化代码

① 代码

代码基本不用变，我们只需要将new XSSFWorkbook() 修改为new SXSSFWorkbook()

并且最终将数据写入过程中产生的缓存文件删除((SXSSFWorkbook) workbook).dispose();

 @Test public void batchWriteExcel07optTest() throws Exception { 
    Workbook workbook = new SXSSFWorkbook(); Sheet sheet = workbook.createSheet("大文件导出优化测试"); long begin = System.currentTimeMillis(); 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("("+(rowNum+1) + "," + (cellNum+1)+")"); } } FileOutputStream fileOutputStream = new FileOutputStream(filepath + "07版本批量写入优化.xlsx"); workbook.write(fileOutputStream); // 清理临时文件 ((SXSSFWorkbook) workbook).dispose(); fileOutputStream.close(); workbook.close(); long end = System.currentTimeMillis(); System.out.println("耗时："+(double)(end-begin)/1000+"秒"); }

② 最终效果

同样的数据大小，耗时明显减少了

07批量写入优化

5.2 基本读操作
5.2.1 基本读excel

① 03版本读取

String filePath = "E:\\xiezhrspace\\excel-demo\\fileinput\\"; @Test public void readExcel03Test() throws Exception{ 
    FileInputStream fileInputStream = new FileInputStream(filePath + "poiexcel03.xls"); Workbook workbook = new HSSFWorkbook(fileInputStream); Sheet sheet = workbook.getSheetAt(0); //获取第一行 Row row1 = sheet.getRow(0); //获取第一行的第一个单元格 Cell cell11 = row1.getCell(0); //获取第一行第二个单元格 Cell cell12 = row1.getCell(1); System.out.println("第一行第一个单元格的内容是："+cell11.getStringCellValue()); System.out.println("第一行第二个单元格的内容是："+cell12.getStringCellValue()); //获取第一行 Row row2 = sheet.getRow(1); //获取第一行的第一个单元格 Cell cell21 = row2.getCell(0); //获取第一行第二个单元格 Cell cell22 = row2.getCell(1); System.out.println("第一行第一个单元格的内容是："+cell21.getStringCellValue()); System.out.println("第一行第二个单元格的内容是："+cell22.getStringCellValue()); } //结果 第一行第一个单元格的内容是：个人公众号 第一行第二个单元格的内容是：XiezhrSpace 第一行第一个单元格的内容是：个人博客 第一行第二个单元格的内容是：www.xiezhrspace.cn

②07版本读取

只需将new FileInputStream(filePath + "poiexcel03.xls")修改为new FileInputStream(filePath + "poiexcel07.xlsx")

new HSSFWorkbook(fileInputStream) 修改为new XSSFWorkbook(fileInputStream)

String filePath = "E:\\xiezhrspace\\excel-demo\\fileinput\\"; @Test public void readExcel07Test() throws Exception{ 
    FileInputStream fileInputStream = new FileInputStream(filePath + "poiexcel07.xlsx"); Workbook workbook = new XSSFWorkbook(fileInputStream); Sheet sheet = workbook.getSheetAt(0); //获取第一行 Row row1 = sheet.getRow(0); //获取第一行的第一个单元格 Cell cell11 = row1.getCell(0); //获取第一行第二个单元格 Cell cell12 = row1.getCell(1); System.out.println("第一行第一个单元格的内容是："+cell11.getStringCellValue()); System.out.println("第一行第二个单元格的内容是："+cell12.getStringCellValue()); //获取第一行 Row row2 = sheet.getRow(1); //获取第一行的第一个单元格 Cell cell21 = row2.getCell(0); //获取第一行第二个单元格 Cell cell22 = row2.getCell(1); System.out.println("第一行第一个单元格的内容是："+cell21.getStringCellValue()); System.out.println("第一行第二个单元格的内容是："+cell22.getStringCellValue()); } //结果 第一行第一个单元格的内容是：个人公众号 第一行第二个单元格的内容是：XiezhrSpace 第一行第一个单元格的内容是：个人博客 第一行第二个单元格的内容是：www.xiezhr.cn

注：

如果上面获取单元格数据的时候，取值的类型不对，即String 类型的数据通过cell22.getNumericCellValue() 获取，则会报错

其他类型不匹配情况类似

类型不匹配报错

5.2.2 读取不同类型数据

① 准备数据

现在有一张用户订单信息表，表内容如下，表中包含了各种类型的数据

用户订单信息表

②书写代码，将表格中的内容读取出来输出到控制台

 @Test public void readExcel07ByTypeTest() throws Exception{ 
    FileInputStream fileInputStream = new FileInputStream(filePath + "用户订单信息表.xlsx"); //根据文件输入流获取excel工作簿（Workbook） Workbook workbook = new XSSFWorkbook(fileInputStream); //根据工作簿获取第一个sheet Sheet sheet = workbook.getSheetAt(0); //获取表头信息 Row rowtitle = sheet.getRow(0); //获取表头有多少列 int cells = rowtitle.getPhysicalNumberOfCells(); for (int cellNum = 0; cellNum < cells; cellNum++) { 
    Cell cell = rowtitle.getCell(cellNum); String cellValue = cell.getStringCellValue(); System.out.print(cellValue + "\t"); } //循环读取数据 //获取行数 int rows = sheet.getPhysicalNumberOfRows(); //从第二行开始读取数据 for (int rowNum = 1; rowNum < rows; rowNum++) { 
    //获取行对象 Row row = sheet.getRow(rowNum); int ofCells = row.getPhysicalNumberOfCells(); //获取列数 for (int cellNum = 0; cellNum < ofCells; cellNum++) { 
    System.out.print("第" + (rowNum + 1) + "行第" + (cellNum + 1) + "列"); //获取单元格 Cell cell = row.getCell(cellNum); //获取单元格数据类型 if (cell!=null) { 
    CellType cellType = cell.getCellType(); //根据单元格数据类型获取单元格数据 String cellvalue =""; switch (cellType) { 
    case STRING : //判断是否是字符串类型 System.out.print("【String】"); cellvalue = cell.getStringCellValue(); break; case NUMERIC: //判断是否是数字类型 if (DateUtil.isCellDateFormatted(cell)) { 
    System.out.print("【date】"); Date date = cell.getDateCellValue(); SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); cellvalue = sdf.format(date); } else { 
    System.out.print("【double】"); double numericCellValue = cell.getNumericCellValue(); cell.setCellType(CellType.STRING); cellvalue = String.valueOf(numericCellValue); } break; case BLANK: System.out.print("【BLANK】"); break; case BOOLEAN: System.out.print("【BOOLEAN】"); boolean bool = cell.getBooleanCellValue(); cellvalue = String.valueOf(bool); break; case _NONE: System.out.print("【_NONE】"); break; case ERROR: System.out.print("【ERROR】"); byte errorCode = cell.getErrorCellValue(); cellvalue = String.valueOf(errorCode); break; case FORMULA: System.out.print("【FORMULA】"); XSSFFormulaEvaluator formulaEvaluator = new XSSFFormulaEvaluator((XSSFWorkbook) workbook); String formula = cell.getCellFormula(); System.out.println("formula:"+formula); CellValue evaluate = formulaEvaluator.evaluate(cell); cellvalue= evaluate.formatAsString(); break; } System.out.println(cellvalue); } } } }

读取不同类型数据

六、EasyPoi 使用

Easypoi的目标不是替代poi,而是让一个不懂导入导出的快速使用poi完成Excel和word的各种操作,而不是看很多api才可以完成这样工作

Easypoi 为谁而开发？

  • 不太熟悉poi的
  • 不想写太多重复太多的
  • 只是简单的导入导出的
  • 喜欢使用模板的
6.1 所需依赖
<dependency> <groupId>cn.afterturn</groupId> <artifactId>easypoi-base</artifactId> <version>4.1.0</version> </dependency> <dependency> <groupId>cn.afterturn</groupId> <artifactId>easypoi-web</artifactId> <version>4.1.0</version> </dependency> <dependency> <groupId>cn.afterturn</groupId> <artifactId>easypoi-annotation</artifactId> <version>4.1.0</version> </dependency>
  • 1.easypoi :父包–作用大家都懂得
  • 2.easypoi-annotation :基础注解包,作用与实体对象上,拆分后方便maven多工程的依赖管理
  • 3.easypoi-base :导入导出的工具包,可以完成Excel导出,导入,Word的导出,Excel的导出功能
  • 4.easypoi-web :耦合了spring-mvc 基于AbstractView,极大的简化spring-mvc下的导出功能
  • 5.sax :导入使用xercesImpl这个包(这个包可能造成奇怪的问题哈),word导出使用poi-scratchpad,都作为可选包了

如果不使用spring mvc的便捷福利,直接引入easypoi-base 就可以了,easypoi-annotation

6.2 常用注解

EasyPoi 为了方便我们操作，实现了实体和Excel的对应,model–row,filed–col，这样利用注解，我们就可以轻轻松松实现excel的导入导出

  • @Excel 作用到filed上面,是对Excel一列的一个描述
  • **@ExcelCollection ** 表示一个集合,主要针对一对多的导出,比如一个老师对应多个科目,科目就可以用集合表示
  • @ExcelEntity 表示一个继续深入导出的实体,但他没有太多的实际意义,只是告诉系统这个对象里面同样有导出的字段
  • @ExcelIgnore 和名字一样表示这个字段被忽略跳过这个导导出
  • @ExcelTarget 这个是作用于最外层的对象,描述这个对象的id,以便支持一个对象可以针对不同导出做出不同处理
6.2.1 @ExcelTarget

限定一个到处实体的注解,以及一些通用设置,作用于最外面的实体

①常用属性

属性 类型 默认值 功能
value String null 定义id唯一标识,不能重复
height double 10 定义单元格高度
fontSize short 11 设置文字大小

②使用

@ExcelTarget("users") public class User implements Serializable { 
    //..... 省略属性 相关GET,SET方法 }
6.2.2 @Excel

@Excel这个是必须使用的注解,用在filed(属性)上面,是对Excel一列的一个描述

① 常用属性

属性 类型 默认值 功能
name String null 生成Excel表格中列名
needMerge boolean fasle 是否需要纵向合并单元格(用于含有list中,单个的单元格,合并list创建的多个row)
orderNum String “0” 指定生成Excel中列的顺序,按照数字自然顺序排序
replace String[] {} 值得替换 导出是{a_id,b_id} 导入反过来
savePath String “upload” 指定导入Excel中图片的保存路径
type int 1 导出类型 1 是文本 2 是图片,3 是函数,10 是数字 默认是文本
width double 10 指定导出Excel时列的宽度
isImportField boolean true 校验字段,看看这个字段是不是导入的Excel中有,如果没有说明是错误的Excel,读取失败,
exportFormat String “” 导出Excel的时间格式
importFormat String “” 导入Excel的时间格式
format String “” 时间格式,相当于同时设置了exportFormat 和 importFormat
imageType int 1 导出类型 1 从file读取 2 是从数据库中读取 默认是文件 同样导入也是一样的
suffix String “” 文字后缀,如% 90 变成90%
isWrap boolean true 是否换行 即支持\n
mergeVertical boolean fasle 纵向合并内容相同的单元格

②使用

@ExcelTarget("user") public class User { 
    @Excel(name = "姓名",orderNum = "1",width = 20 ) private String name; @Excel(name = "年龄",orderNum = "2",width = 20 ) private Integer age; @Excel(name = "性别",orderNum = "3",width = 20,replace = { 
   "男_1","女_2"}) private String sex; @Excel(name = "生日",orderNum = "4",width = 20,format = "yyyy-MM-dd") private Date birthday; //...省略GET、SET方法 }
7.2.3 @ExcelEntity

来标记实体类中包含另一个实体类的字段的注解。通过在父实体类的字段上添加 @ExcelEntity 注解，可以将子实体类中的字段映射到 Excel 表格中

① 常用属性

属性 类型 默认值 功能
id String null 定义ID

② 使用

@ExcelTarget("user") public class User { 
    //省略GET、SET方法和其他属性 @ExcelEntity(name = "用户基本信息") private UserBaseInfo userBaseInfo; } @ExcelTarget("userBaseInfo") class UserBaseInfo{ 
    @Excel(name = "手机号",orderNum = "5",width = 20) private String phone; @Excel(name = "邮箱",orderNum = "6",width = 20) //省略其他字段和方法 }

在上面的示例中， User 类中包含一个 UserBaseInfo 类型的字段 userBaseInfo ，通过在 userBaseInfo 字段上添加 @ExcelEntity 注解，可以将 UserBaseInfo 类中的字段映射到 Excel 表格中，并且在 Excel 表格中会显示为一个包含 手机号 和 邮箱 列的子表格。

6.2.4 @ExcelCollection

一对多的集合注解,来标记实体类中包含集合类型字段的注解。

通过在父实体类的集合字段上添加 @ExcelCollection 注解，可以将集合中的元素映射到 Excel 表格中

①常用属性

属性 类型 默认值 功能
id String null 定义ID
name String null 定义集合列名,支持nanm_id
orderNum int 0 排序,支持name_id
type Class<?> ArrayList.class 导入时创建对象使用

② 使用

@ExcelTarget("user") public class User { 
    //省略GET、SET 方法和其他属性 @ExcelCollection(name = "商品列表",orderNum = "10") private List<Product> products; } @ExcelTarget("product") public class Product { 
    @Excel(name = "商品名称" ) private String productName; @Excel(name = "商品价格") private double productPrice; }

在上面的示例中， User 类中包含一个 List<Product> 类型的字段 products ，通过在 products 字段上添加 @ExcelCollection 注解，可以将 Product 类型的元素映射到 Excel 表格中，并且在 Excel 表格中会显示为一个包含多个商品信息的列表。

6.2.5 @ExcelIgnore

来标记实体类中不需要导出到 Excel 表格的字段的注解

① 使用

public class Product { 
    @Excel(name = "商品名称") private String name; @Excel(name = "价格") private double price; @ExcelIgnore private String description; // 不需要导出到 Excel 表格的字段 // 其他字段和方法 }

在上面的示例中， Product 类中包含了 name 、 price 和 description 三个字段。通过在 description 字段上添加 @ExcelIgnore 注解，告诉 EasyPoi 在导出 Excel 表格时不导出该字段的内容。

6.3 注解使用导出Excel案例
6.3.1 导出基本数据

① 创建基本对象对象

@Data @ExcelTarget("user") public class User { 
    @Excel(name = "姓名",orderNum = "1",width = 20,needMerge = true) private String name; @Excel(name = "年龄",orderNum = "2",width = 20,needMerge = true) private Integer age; @Excel(name = "性别",orderNum = "3",width = 20,replace = { 
   "男_1","女_2"},needMerge = true) private String sex; @Excel(name = "生日",orderNum = "4",width = 20,format = "yyyy-MM-dd",needMerge = true) private Date birthday; }

②模拟测试数据

public List<User> testGetTestData(){ 
    List<User> users = new ArrayList<User>(); for (int i = 0; i < 5; i++) { 
    User user = new User(); user.setName("小凡"+i); user.setAge(i+18); user.setSex("1"); user.setBirthday(new Date()); users.add(user); } return users; }

③导出数据

@Test public void testExportExcel() throws Exception { 
    ExportParams exportParams = new ExportParams("用户列表", "测试sheet页"); //创建ExcelExportUtil对象，传入参数为ExportParams对象，User类，testGetTestData()方法 Workbook workbook = ExcelExportUtil.exportExcel(exportParams, User.class, testGetTestData()); //创建FileOutputStream对象，传入参数为文件路径 FileOutputStream fileOutputStream = new FileOutputStream("D:/test.xls"); //将workbook写入到文件输出流中 workbook.write(fileOutputStream); //关闭文件输出流 fileOutputStream.close(); //关闭workbook workbook.close(); System.out.println("导出成功"); }

④ 查看excel

导出基本excel

6.3.2 忽略某个字段

① 添加注解

@ExcelIgnore private Integer age;

②查看excel

忽略某个字段

6.3.3 导出对象中含有对象的数据

① 添加注解

@ExcelTarget("user") public class User { 
    //省略GET、SET方法和其他属性 @ExcelEntity(name = "用户基本信息") private UserBaseInfo userBaseInfo; }

② 新建UserBaseInfo类

@ExcelTarget("userBaseInfo") class UserBaseInfo{ 
    @Excel(name = "手机号",orderNum = "5",width = 20) private String phone; @Excel(name = "邮箱",orderNum = "6",width = 20) //省略其他字段和方法 }

③ 测试数据中添加UserBaseInfo 对象

user.setUserBaseInfo(new UserBaseInfo("","@.com","云南省昆明市","","9558"));

④ 导出excel数据

对象中包含对象

6.3.4 导出含list集合数据

①我们新建Product 对象

@ExcelTarget("product") public class Product { 
    //省略GET、SET方法 @Excel(name = "商品名称" ) private String productName; @Excel(name = "商品价格") private double productPrice; }

② User 类中添加如下list集合

@ExcelCollection(name = "商品列表",orderNum = "10") private List<Product> products;

③添加测试数据

public List<User> testGetTestData(){ 
    List<User> users = new ArrayList<User>(); for (int i = 0; i < 5; i++) { 
    User user = new User(); user.setName("小凡"+i); user.setAge(i+18); user.setSex("1"); user.setBirthday(new Date()); user.setUserBaseInfo(new UserBaseInfo("","@.com","云南省昆明市","","9558")); Product pro1 = new Product("冰箱"+i, 5000); Product pro2 = new Product("洗衣机"+i, 3000); Product pro3 = new Product("空调"+i, 4000); List<Product> products = Arrays.asList(pro1, pro2, pro3); user.setProducts(products); users.add(user); } return users; }

④ 由于是一对多关系，所以需要添加合并单元格属性needMerge = true

@Excel(name = "姓名",orderNum = "1",width = 20,needMerge = true) private String name; @Excel(name = "年龄",orderNum = "2",width = 20,needMerge = true) //其他属性类似省略。。。

⑤导出excel

导出list

6.3.5 导出图片

①User类中定义头像avter字段

@Excel(name = "头像",orderNum = "0",width = 20,type = 2,height = 20,needMerge = true) //type的值一定要指定为2 private String avatar; //定义头像 直接写指定图片路径

② 构造测试数据

 public List<User> testGetTestData(){ 
    List<User> users = new ArrayList<User>(); for (int i = 0; i < 5; i++) { 
    User user = new User(); user.setName("小凡"+i); user.setAge(i+18); user.setSex("1"); user.setBirthday(new Date()); user.setUserBaseInfo(new UserBaseInfo("","@.com","云南省昆明市","","9558")); Product pro1 = new Product("冰箱"+i, 5000); Product pro2 = new Product("洗衣机"+i, 3000); Product pro3 = new Product("空调"+i, 4000); List<Product> products = Arrays.asList(pro1, pro2, pro3); user.setAvatar("https://xiezhrspace.cn/medias/logo.png"); user.setProducts(products); users.add(user); } return users; }

③ 导出excel

导出图片

6.4 大数据导出

当我们导出得数据量为几十万到几百万时，一次将所有数据加载到内存中，会对cpu、内存都产生巨大压力。

当然了，EasyPoi作者也为我们考虑了，专门提供exportBigExcel 方法来导出大数据

Workbook workbook1 = ExcelExportUtil.exportBigExcel(new ExportParams("用户列表", "测试"), User.class, getUsers()); workbook1.write(outputStream); ExcelExportUtil.closeExportBigExcel();
6.5 导入excel
6.5.1 导入基本数据

① 准备目标excel

目标excel

② 定义基本数据对象

@ExcelTarget("student") public class Student implements Serializable { 
    @Excel(name = "编号") private String id; @Excel(name = "姓名") private String name; @Excel(name = "性别", replace = { 
   "男_1", "女_2"}) private String gender; @Excel(name = "年龄") private Integer age; @Excel(name = "出生日期", importFormat = "yyyy-MM-dd") private Date birth; //省略GET、SET方法 }

③ 导入代码

@Test public void excelImportTest() throws Exception{ 
    // 创建导入参数配置 ImportParams importParams = new ImportParams(); // 设置标题行数 importParams.setTitleRows(1); // 设置表头行数 importParams.setHeadRows(1); // 创建文件输入流 FileInputStream fileInputStream = new FileInputStream("E:\\xiezhrspace\\excel-demo\\fileinput\\学生信息表.xlsx"); // 调用ExcelImportUtil的importExcel方法，传入文件输入流，实体类，参数配置，返回实体类列表 List<Student> students = ExcelImportUtil.importExcel(fileInputStream, Student.class, importParams); // 遍历实体类列表，输出实体类信息 students.forEach(System.out::println); // 关闭文件输入流 fileInputStream.close(); }

② 打印导入结果

Student(id=10001, name=张三, gender=1, age=25, birth=1992-02-23) Student(id=10002, name=李四, gender=1, age=18, birth=2006-01-01) Student(id=10003, name=王五, gender=1, age=26, birth=1998-01-01) Student(id=10004, name=赵六, gender=2, age=26, birth=1998-03-01)
6.5.2 导入带图片数据

①excel数据

excel图片数据

②Student类设置图片保存路径

@ExcelTarget("student") public class Student implements Serializable { 
    @Excel(name = "编号") private String id; @Excel(name = "姓名") private String name; @Excel(name = "性别", replace = { 
   "男_1", "女_2"}) private String gender; @Excel(name = "年龄") private Integer age; @Excel(name = "出生日期", importFormat = "yyyy-MM-dd") private Date birth; @Excel(name = "头像", type = 2, savePath = "src/main/imgs") //设置导入图片的保存路径 private String avatar; //省略GET、SET 方法 }

③ 导入excel

关键部分

importParams.setNeedSave(false);

importParams.setSaveUrl("src/main/imgs");

@Test public void excelImportTest() throws Exception{ 
    // 创建导入参数配置 ImportParams importParams = new ImportParams(); // 设置标题行数 importParams.setTitleRows(1); // 设置表头行数 importParams.setHeadRows(1); // 设置是否需要保存 importParams.setNeedSave(false); // 设置保存路径 importParams.setSaveUrl("src/main/imgs"); // 创建文件输入流 FileInputStream fileInputStream = new FileInputStream("E:\\xiezhrspace\\excel-demo\\fileinput\\学生信息表.xlsx"); // 调用ExcelImportUtil的importExcel方法，传入文件输入流，实体类，参数配置，返回实体类列表 List<Student> students = ExcelImportUtil.importExcel(fileInputStream, Student.class, importParams); // 遍历实体类列表，输出实体类信息 students.forEach(System.out::println); // 关闭文件输入流 fileInputStream.close(); }

④ 导入结果

Student(id=10001, name=张三, gender=1, age=25, birth=1992-02-23,avatar=src/main/imgs\pic.PNG) Student(id=10002, name=李四, gender=1, age=18, birth=2006-01-01,avatar=src/main/imgs\pic.JPG) Student(id=10003, name=王五, gender=1, age=26, birth=1998-01-01,avatar=src/main/imgs\pic.PNG) Student(id=10004, name=赵六, gender=2, age=26, birth=1998-03-01,avatar=src/main/imgs\pic.PNG)

图片保存路径

6.6 小结

以上小节为easypoi的最基本操作，如果大家还想了解更多，可以关注官方文档：http://doc.wupaas.com/docs/easypoi/

作者也给出了大量的实例：https://gitee.com/lemur/easypoi-test

八、EasyExcel使用

8.1 快速入门之写excel
8.1.1 引入依赖

目前最新的依赖是3.3.3，我们这里引入使用最多也最稳定的3.3.2版本

<dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.3.2</version> </dependency>
8.1.2 构建数据对象
@Data @NoArgsConstructor @AllArgsConstructor public class Employee { 
    @ExcelProperty("员工编号") private Integer id; @ExcelProperty("员工姓名") private String name; @ExcelProperty("员工年龄") private Integer age; @ExcelProperty("员工薪资") private Double salary; @ExcelProperty("入职日期") private Date inDate; }
8.1.3 构建测试数据
private List<Employee> data(long count) { 
    List<Employee> list = ListUtils.newArrayList(); for (int i = 0; i < count; i++) { 
    Employee employee = new Employee(); employee.setId(i); employee.setName("小陈"+i); employee.setAge(18+1); employee.setSalary(6.66+i); employee.setInDate(new Date()); list.add(employee); } return list; }

上面代码根据传入count,构建通用数据，后面不会重复写

8.1.4 写入数据
@Test public void testbaseWrite() { 
    String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "simpleWrite" + System.currentTimeMillis() + ".xlsx"; // 这里 需要指定写用哪个class去写，然后写到第一个sheet，名字为模板 然后文件流会自动关闭 // 如果这里想使用03 则 传入excelType参数即可 EasyExcel.write(fileName, Employee.class).sheet("测试模板").doWrite(data(10)); }

写入的数据

8.2 快速入门之读excel
8.2.1 准备目标excel

员工信息表

8.2.2 构建数据对象

这里我们沿用8.1.2 小节中创建的employee对象

8.2.3 读取数据

注： PageReadListener 为默认easyexcel为我们写好的监听类，当然了，我们也可以自己定义，在后面的进阶操作中

我们会说到

@Test public void testbaseReade(){ 
    String fileName = "E:\\xiezhrspace\\excel-demo\\fileinput\\" + "员工信息表.xlsx"; EasyExcel.read(fileName, Employee.class, new PageReadListener<Employee>(dataList -> { 
    for (Employee employee : dataList) { 
    System.out.println(employee); } })).sheet().doRead(); }

读取数据

8.3 进阶操作
8.3.1 复杂表头写入

① 准备对象

@Data public class Student { 
    @ExcelProperty({ 
   "学生信息表","学生ID"}) private Integer id; @ExcelProperty({ 
   "学生信息表","学生姓名"}) private String name; @ExcelProperty({ 
    "学生信息表", "学生年龄" }) private Integer age; @ExcelProperty({ 
    "学生信息表", "生日" }) private Date birth; }

②代码

public class UpEasyExcelTest { 
    private List<Student> data(long count) { 
    List<Student> list = ListUtils.newArrayList(); for (int i = 0; i < count; i++) { 
    Student student = new Student(); student.setId(i); student.setName("小李" + i); student.setAge(22+i); student.setBirth(new Date()); list.add(student); } return list; } @Test public void testUpWrite() { 
    String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "upWrite" + System.currentTimeMillis() + ".xlsx"; // 这里 需要指定写用哪个class去写，然后写到第一个sheet，名字为模板 然后文件流会自动关闭 // 如果这里想使用03 则 传入excelType参数即可 EasyExcel.write(fileName, Student.class).sheet("测试模板").doWrite(data(10)); } }

③excel写入示例

复杂表头

8.3.2 重复多次写入(写到单个或者多个Sheet)

① 准备对象

public class Employee { 
    @ExcelProperty("员工编号") private Integer id; @ExcelProperty("员工姓名") private String name; @ExcelProperty("员工年龄") private Integer age; @ExcelProperty("员工薪资") private Double salary; @ExcelProperty(value = "入职日期") private Date inDate; //省略GET、SET 方法 }

②代码

 @Test public void testmanyDateWriter(){ 
    // 方法1: 如果写到同一个sheet String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "manydataWrite" + System.currentTimeMillis() + ".xlsx"; // 这里 需要指定写用哪个class去写 try (ExcelWriter excelWriter = EasyExcel.write(fileName, Employee.class).build()) { 
    // 这里注意 如果同一个sheet只要创建一次 WriteSheet writeSheet = EasyExcel.writerSheet("模板").build(); // 去调用写入,这里我调用了五次，实际使用时根据数据库分页的总的页数来 for (int i = 0; i < 5; i++) { 
    // 分页去数据库查询数据 这里可以去数据库查询每一页的数据 List<Employee> data = data(); excelWriter.write(data, writeSheet); } } // 方法2: 如果写到不同的sheet 同一个对象 fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "manydataWrite" + System.currentTimeMillis() + ".xlsx"; // 这里 指定文件 try (ExcelWriter excelWriter = EasyExcel.write(fileName, Employee.class).build()) { 
    // 去调用写入,这里我调用了五次，实际使用时根据数据库分页的总的页数来。这里最终会写到5个sheet里面 for (int i = 0; i < 5; i++) { 
    // 每次都要创建writeSheet 这里注意必须指定sheetNo 而且sheetName必须不一样 WriteSheet writeSheet = EasyExcel.writerSheet(i, "模板" + i).build(); // 分页去数据库查询数据 这里可以去数据库查询每一页的数据 List<Employee> data = data(); excelWriter.write(data, writeSheet); } } // 方法3 如果写到不同的sheet 不同的对象 fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "manydataWrite" + System.currentTimeMillis() + ".xlsx"; // 这里 指定文件 try (ExcelWriter excelWriter = EasyExcel.write(fileName).build()) { 
    // 去调用写入,这里我调用了五次，实际使用时根据数据库分页的总的页数来。这里最终会写到5个sheet里面 for (int i = 0; i < 5; i++) { 
    // 每次都要创建writeSheet 这里注意必须指定sheetNo 而且sheetName必须不一样。这里注意DemoData.class 可以每次都变，我这里为了方便 所以用的同一个class // 实际上可以一直变 WriteSheet writeSheet = EasyExcel.writerSheet(i, "模板" + i).head(Employee.class).build(); // 分页去数据库查询数据 这里可以去数据库查询每一页的数据 List<Employee> data = data(); excelWriter.write(data, writeSheet); } } }

③Excel示例

100万数据写入

除了上面的常用例子外，还有更多玩法，大家可以参照官方文档，里面写的很详细，这里就不一一例举了~

8.4 excel填充

EasyExcel提供了数据填充的功能，可以将指定的数据填充到事先设计好带有样式和格式的Excel模板文，这样我们就可以制作出更加优美的excel

8.4.1 简单的填充

① 准备模板

image-20240310172107654

②准备对象

@Data public class Student { 
    @ExcelProperty({ 
   "学生信息表","学生ID"}) private Integer id; @ExcelProperty({ 
   "学生信息表","学生姓名"}) private String name; @ExcelProperty({ 
    "学生信息表", "学生年龄" }) private Integer age; @ExcelProperty({ 
    "学生信息表", "生日" }) private Date birth; }

③填充数据

根据对象填充

@Test public void filebyObjFillTest() { 
    // 模板注意 用{} 来表示你要用的变量 如果本来就有"{","}" 特殊字符 用"\{","\}"代替 String templateFileName ="E:\\xiezhrspace\\excel-demo\\fileinput\\" + "template.xlsx"; // 方案1 根据对象填充 String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "fillWrite" + System.currentTimeMillis() + ".xlsx"; Student student = new Student(); student.setId(1); student.setName("张三"); student.setAge(20); student.setBirth(new Date()); // 这里 会填充到第一个sheet， 然后文件流会自动关闭 EasyExcel.write(fileName).withTemplate(templateFileName).sheet().doFill(student); }

根据map填充

@Test public void filebyMapFillTest() { 
    // 模板注意 用{} 来表示你要用的变量 如果本来就有"{","}" 特殊字符 用"\{","\}"代替 String templateFileName ="E:\\xiezhrspace\\excel-demo\\fileinput\\" + "template.xlsx"; // 方案2 根据Map填充 String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "fillWrite" + System.currentTimeMillis() + ".xlsx"; // 这里 会填充到第一个sheet， 然后文件流会自动关闭 Map<String, Object> map = MapUtils.newHashMap(); map.put("id", "001"); map.put("name", "张三"); map.put("age", 20); map.put("birthday", new Date()); EasyExcel.write(fileName).withTemplate(templateFileName).sheet().doFill(map); }

④最终效果

最终效果

8.4.2 填充列表数据

①准备模板

相比上一小节的模板，列表数据的模板{id}----->{.id} {name}--->{.name} 依此类推

列表模板

②填充对象

参照上一小节

③ 准备数据

private List<Student> data(long count) { 
    List<Student> list = ListUtils.newArrayList(); for (int i = 0; i < count; i++) { 
    Student student = new Student(); student.setId(i); student.setName("小李" + i); student.setAge(22+i); student.setBirth(new Date()); list.add(student); } return list; }

④ 填充数据

@Test public void listFill() { 
    // 模板注意 用{} 来表示你要用的变量 如果本来就有"{","}" 特殊字符 用"\{","\}"代替 // 填充list 的时候还要注意 模板中{.} 多了个点 表示list // 如果填充list的对象是map,必须包涵所有list的key,哪怕数据为null，必须使用map.put(key,null) String templateFileName ="E:\\xiezhrspace\\excel-demo\\fileinput\\" + "template-list.xlsx"; // 方案1 一下子全部放到内存里面 并填充 String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "fillWrite-list" + System.currentTimeMillis() + ".xlsx"; // 这里 会填充到第一个sheet， 然后文件流会自动关闭 EasyExcel.write(fileName).withTemplate(templateFileName).sheet().doFill(data(10)); }

⑤ 最终效果

最终效果

8.4.3 复杂填充

当excel模板相对复杂时，也可以填充

① 准备复杂模板

复杂模板

② 准备填充对象

参照8.4.1小节

③准备数据

参照8.4.1小节

④填充数据

@Test public void complexFill() { 
    // 模板注意 用{} 来表示你要用的变量 如果本来就有"{","}" 特殊字符 用"\{","\}"代替 // {} 代表普通变量 {.} 代表是list的变量 String templateFileName ="E:\\xiezhrspace\\excel-demo\\fileinput\\" + "template-hard.xlsx"; String fileName = "E:\\xiezhrspace\\excel-demo\\fileoutput\\" + "fillWrite-hard" + System.currentTimeMillis() + ".xlsx"; // 方案1 try (ExcelWriter excelWriter = EasyExcel.write(fileName).withTemplate(templateFileName).build()) { 
    WriteSheet writeSheet = EasyExcel.writerSheet().build(); // 这里注意 入参用了forceNewRow 代表在写入list的时候不管list下面有没有空行 都会创建一行，然后下面的数据往后移动。默认 是false，会直接使用下一行，如果没有则创建。 // forceNewRow 如果设置了true,有个缺点 就是他会把所有的数据都放到内存了，所以慎用 // 简单的说 如果你的模板有list,且list不是最后一行，下面还有数据需要填充 就必须设置 forceNewRow=true 但是这个就会把所有数据放到内存 会很耗内存 // 如果数据量大 list不是最后一行 参照下一个 FillConfig fillConfig = FillConfig.builder().forceNewRow(Boolean.TRUE).build(); excelWriter.fill(data(5), fillConfig, writeSheet); excelWriter.fill(data(5), fillConfig, writeSheet); Map<String, Object> map = MapUtils.newHashMap(); map.put("date", "2024年03月10日17:28:28"); map.put("total", 1000); excelWriter.fill(map, writeSheet); } }

⑤ 最终效果

学生信息统计表

九、文章小节

文中只例举出excel 常用操作，如果这些还不满足你的需求，大家可以查看官方文档。

官方文档还是非常详细的，并且都给出了具体的demo。

另外文中例举出的代码已提交到https://gitee.com/xiezhr/excel-demo.git 欢迎大家访问查看

本期内容到此就结束了，希望对你有所帮助，我们下期再见 (●’◡’●)

今天的文章
poi导出数据到excel模板_excel表格导入excel文件分享到此就结束了，感谢您的阅读。

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。
如需转载请保留出处：https://bianchenghao.cn/81154.html

赞 (0)
编程小号编程小号
0

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注