POI in Action

1 POI 组件依赖

按需引入对应依赖 (给出官方的指引)

组件	作用	Maven依赖
POIFS	OLE2 Filesystem	poi
HPSF	OLE2 Property Sets	poi
HSSF	Excel XLS	poi
HSLF	PowerPoint PPT	poi-scratchpad
HWPF	Word DOC	poi-scratchpad
HDGF	Visio VSD	poi-scratchpad
HPBF	Publisher PUB	poi-scratchpad
HSMF	Outlook MSG	poi-scratchpad
DDF	Escher common drawings	poi
HWMF	WMF drawings	poi-scratchpad
OpenXML4J	OOXML	poi-ooxml plus either poi-ooxml-schemas or ooxml-schemas and ooxml-security
XSSF	Excel XLSX	poi-ooxml
XSLF	PowerPoint PPTX	poi-ooxml
XWPF	Word DOCX	poi-ooxml
XDGF	Visio VSDX	poi-ooxml
Common SL	PowerPoint PPT 和 PPTX 共用组件	poi-scratchpad and poi-ooxml
Common SS	Excel XLS 和 XLSX 共用组件	poi-ooxml
XSSF	Excel XLSX	poi-ooxml
XSLF	PowerPoint PPTX	poi-ooxml
XWPF	Word DOCX	poi-ooxml
XDGF	Visio VSDX	poi-ooxml
Common SL	PowerPoint PPT 和 PPTX 共用组件	poi-scratchpad and poi-ooxml
Common SS	Excel XLS 和 XLSX 共用组件	poi-ooxml

2 什么是 OLE2 和 OOXML

OLE2 和 OOXML 本质上都是一种文件格式规范或标准，平时看到的 excel 中，有字体、公式、颜色、图片等等，看起来非常复杂，但是在文件结构上都遵循着固定的格式。

OLE2 文件一般包括 xls、doc、ppt 等，是二进制格式的文件。相关内容可以参考：复合文档Ole对象二进制储存格式。

OOXML文件一般包括 xlsx、docx、pptx 等。该类文件以指定格式的 xml 为基础并以 zip 格式压缩，这里我利用解压工具解压本地的一个 xlsx 文件，可以看到以下文件结构，在本文例子中，我们会重点关注 sharedStrings.xml 和 sheet1.xml 的内容，因为使用 SAX API 时必须用到：

在这里插入图片描述

包名	描述
org.apache.poi.ss	Excel API，底层解析方式类似 DOM，效率较低，内存占用较大
org.apache.poi.hssf	Excel XLS API，采用 SAX API 方式读写
org.apache.poi.xssf	Excel XLSX API，采用 SAX API 方式读写

POI SAX 方式的 API 非常繁琐，使用时须熟练掌握 OLE2 或 OOXML 的规范

3 EasyExcel

3.1 关于常见类解析

EasyExcel 入口类，用于构建开始各种操作
ExcelReaderBuilder ExcelWriterBuilder 构建出一个 ReadWorkbook WriteWorkbook，可以理解成一个Excel 对象，一个 Excel 只需构建一个
ExcelReaderSheetBuilder ExcelWriterSheetBuilder 构建出一个 ReadSheet WriteSheet 对象，可以理解成 Excel 里面的一页,每一页都要构建一个
ReadListener 在每一行读取完毕后都会调用 ReadListener 来处理数据
WriteHandler 在每一个操作包括创建单元格、创建表格等都会调用 WriteHandler 来处理数据
所有配置都是继承的，Workbook 的配置会被 Sheet 继承，所以在用 EasyExcel 设置参数的时候，在 EasyExcel...sheet() 方法之前作用域是整个 Sheet, 之后针对单个 Sheet

3.2 读

3.2.1 注解

ExcelProperty 指定当前字段对应 Excel 中的那一列。可以根据名字或者 index 去匹配。当然也可以不写，默认第一个字段就是 index=0，以此类推。千万注意，要么全部不写，要么全部用 index，要么全部用名字去匹配。千万别三个混着用，除非你非常了解源代码中三个混着用怎么去排序的。
ExcelIgnore 默认所有字段都会和 Excel 去匹配，加了这个注解会忽略该字段
DateTimeFormat 日期转换，用 String 去接收 Excel 日期格式的数据会调用这个注解。里面的 value参照java.text.SimpleDateFormat
NumberFormat 数字转换，用String去接收 Excel 数字格式的数据会调用这个注解。里面的 value 参照 java.text.DecimalFormat
ExcelIgnoreUnannotated 默认不加 ExcelProperty 的注解的都会参与读写，加了不会参与

3.2.2 参数

3.2.2.1 通用参数

ReadWorkbook, ReadSheet 都会有的参数，如果为空，默认使用上级。

converter 转换器，默认加载了很多转换器。也可以自定义。
readListener 监听器，在读取数据的过程中会不断的调用监听器。
headRowNumber 需要读的表格有几行头数据。默认有一行头，也就是认为第二行开始起为数据。
head 与 clazz 二选一。读取文件头对应的列表，会根据列表匹配数据，建议使用class。
clazz 与 head 二选一。读取文件的头对应的class，也可以使用注解。如果两个都不指定，则会读取全部数据。
autoTrim 字符串、表头等数据自动 trim
password 读的时候是否需要使用密码

3.2.2.2 ReadWorkbook（理解成Excel对象）参数

excelType 当前excel的类型默认会自动判断
inputStream 与file二选一。读取文件的流，如果接收到的是流就只用，不用流建议使用file参数。因为使用了inputStream EasyExcel会帮忙创建临时文件，最终还是file
file 与inputStream二选一。读取文件的文件。
autoCloseStream 自动关闭流。
readCache 默认小于5M用内存，超过5M会使用 EhCache,这里不建议使用这个参数。

3.2.2.3 ReadSheet（就是Excel的一个Sheet）参数

sheetNo 需要读取Sheet的编码，建议使用这个来指定读取哪个Sheet
sheetName 根据名字去匹配 Sheet, Excel 2003不支持根据名字去匹配

3.3 写

3.3.1 注解

ExcelProperty index 指定写到第几列，默认根据成员变量排序。value指定写入的名称，默认成员变量的名字，多个value可以参照快速开始中的复杂头
ExcelIgnore 默认所有字段都会写入 Excel，这个注解会忽略这个字段
DateTimeFormat 日期转换，将Date写到 Excel 会调用这个注解。里面的 value 参照java.text.SimpleDateFormat
NumberFormat 数字转换，用Number写 Excel 会调用这个注解。里面的 value 参照java.text.DecimalFormat
ExcelIgnoreUnannotated 默认不加ExcelProperty 的注解的都会参与读写，加了不会参与

3.3.2 参数

3.3.2.1 通用参数

WriteWorkbook, WriteSheet, WriteTable 都会有的参数，如果为空，默认使用上级.

converter 转换器，默认加载了很多转换器。也可以自定义.
writeHandler 写的处理器。可以实现WorkbookWriteHandler, SheetWriteHandler, RowWriteHandler, CellWriteHandler, 在写入 Excel 的不同阶段会调用
relativeHeadRowIndex 距离多少行后开始。也就是开头空几行
needHead 是否导出头
head 与 clazz 二选一。写入文件的头列表，建议使用 class
clazz 与 head 二选一。写入文件的头对应的 class，也可以使用注解
autoTrim 字符串、表头等数据自动 trim