EasyExcel操作API与示例

1. maven

        
            com.alibaba
            easyexcel
            2.2.2
        

2. 注解

ExcelProperty    指定当前字段对应excel中的那一列。可以根据名字或者Index去匹配。不写，默认按顺序匹配
        value     名头名称
        index    字段与列数对应索引
        converter    字段转化器
ExcelIgnore    默认所有字段都会和excel去匹配，加了这个注解会忽略该字段
DateTimeFormat    日期转换，用String去接收excel日期格式的数据会调用这个注解。
        value  SimpleDateFormat格式方式 y(年) M(月 )d(日) h(时) m(分) s(秒)
        use1904windowing 是否使用1904windowing
NumberFormat    数字转换，用String去接收excel数字格式的数据会调用这个注解。
       value    DecimalFormat格式方式 ##.00
       roundingMode    取舍方式
ExcelIgnoreUnannotated    默认不加ExcelProperty 的注解的都会参与读写，加了不会参与
ColumnWidth    设置宽
        value    数值
ContentRowHeight    设置高
        value    数值
HeadRowHeight    设置头高
        value    数值

3. Excel读入

3.1 常用操作API

3.1.1 初始化方法

初始化获取Excel读取构造对象(ExcelReaderBuilder)

构造方法	描述
EasyExcel.read()	无参初始化,各属性由方法添加
EasyExcel.read(File file)	文件来源 File,可分别设置对象class和监听器
EasyExcel.read(File file, ReadListener listener)
EasyExcel.read(File file, Class head, listener listener)
EasyExcel.read(String path)	文件来源 FilePath,可分别设置对象class和监听器
EasyExcel.read(String path, ReadListener listener)
EasyExcel.read(String path, Class head, ReadListener listener)
EasyExcel.read(InputStream in)	文件来源 InputStream,可分别设置对象class和监听器
EasyExcel.read(InputStream in, ReadListener listener)
EasyExcel.read(InputStream in, Class head, ReadListener listener)

3.1.2 操作方法

ExcelReaderBuilder对象操作方法,添加属性,获取Excel读取对象(ExcelReader),Sheet构造对象(ExcelReaderSheetBuilder)

功能	方法	描述
Excel属性设置 (ExcelReaderBuilder)	.head(T.class)	添加 对象class
	.file(File file)	添加 文件,可以是File对象,文件路径,输入流
	.registerReadListener(new MyListener())	注册 读取监听器
	.registerConverter(new MyConverter())	注册转化器
	.headRowNumber(1)	设置头行数,默认为1
	.autoTrim(true)	设置是否去两端空格,默认为 true
	.ignoreEmptyRow(true)	设置忽略空行,默认为 true
	.use1904windowing(true)
	.mandatoryUseInputStream(true)	强制使用输入流
	.excelType(ExcelTypeEnum.XLSX);	设置类型,默认自动
	.autoCloseStream(true)	自动关流
	.readCache(new MyReadCache())	设置自定义缓存
	.readCacheSelector(new MySelector())	设置缓存选择器
	.customObject(null)
	.password("")
	.xlsxSAXParserFactoryName("")
ExcelReaderBuilder方法; 获取Excel属性设置 (ExcelReader)	.build()	构建ExcelReader对象
	.doReadAll()	读取所有数据,可配置监听器读取
ExcelReaderBuilder方法; 获取sheet构造对象(ExcelReaderSheetBuilder)	.sheet()	获取sheet构造器,
excelReader方法	.readAll()	读取所有数据,可配置监听器读取
	.finish()	关流
	.read(ReadSheet  readSheet )	数据读取,参数是ReadSheet ,list,不定参
ExcelReaderSheetBuilder方法; Sheet构造器属性添加	.headRowNumber(1)	设置头行数,默认为1
	.head(T.class)	设置实体类
	.sheetNo(1)	设置 sheet 索引
	.sheetName("")	设置 sheet 名称
	.registerReadListener(new MyListener())	注册监听器
	.registerConverter(new MyConverter())	注册转换器
	.use1904windowing(true)
	.autoTrim(true);	自动去两边空格
ExcelReaderSheetBuilder方法; (数据读取)	sheet.doRead();	异步读取,在监听器中进行数据处理
	sheet.doReadSync();	同步读取,返回结果集

 3.2 操作实例

//异步读取所有sheet数据,文件可为File,路径,输入流;不设置T.class时,监听器监听数据为List