文章目录
1、使用场景2、特点3、使用1、使用EasyExcel进行写操作（导出Excel）1. 在pom文件中添加对应的依赖2. 创建实体类，和excel数据对应3. converter自定义转换器5、 普通导出6. 多sheet导出 2、使用EasyExcel进行读操作（下载excel）1、文件读取配置2、导入1、使用场景
数据导出：减轻录入工作量数据导入：统计信息归档数据传输：异构系统之间数据传输2、特点
●Java领域解析、生成Excel比较有名的框架有Apache poi、jxl等。 但他们都存在一个严重的问题就是非常的耗内存。如果你的系统并发量不大的话可能还行,但是一旦并发上来后一定会OOM或者JVM频繁的full gc。
●EasyExcel是阿里巴巴开源的一个excel处理框架,以使用简单、节省内存著称。EasyExcel能大大减少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部载到内存中，而是从磁盘上一行行读取数据，逐个解析。
●EasyExcel采用一 行一 行的解析模式，并将一行的解析结果以观察者的模式通知处理( AnalysisEventListener )。
3、使用
1、使用EasyExcel进行写操作（导出Excel）
1. 在pom文件中添加对应的依赖
<dependency><groupId>com.alibaba</groupId><artifactId>easyexcel</artifactId><version>3.1.3</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.8.18</version></dependency>
2. 创建实体类，和excel数据对应
@Datapublic class UserDO {//设置excel表头名称@ExcelProperty("用户编号")@ColumnWidth(20)private Long id;/*** 设置该列的名称为”用户名“；* */@ExcelProperty("用户名")/*** 设置表格列的宽度为20；* */@ColumnWidth(20)private String username;/*** 导出时忽略该字段* */@ExcelIgnoreprivate String password;@ExcelProperty("昵称")@ColumnWidth(20)private String nickname;@ExcelProperty("生日")@ColumnWidth(20)/*** 按照指定的格式对日期进行格式化；* */@DateTimeFormat("yyyy-MM-dd")private Date birthday;@ExcelProperty("手机号")@ColumnWidth(20)private String phone;@ExcelProperty("身高（米）")@NumberFormat("#.##")@ColumnWidth(20)private Double height;/*** 自定义内容转换器* */@ExcelProperty(value = "性别", converter = GenderConverter.class)@ColumnWidth(10)private Integer gender;}
常用注解有：
@ExcelProperty 指定当前字段对应excel中的哪一列。可以根据名字或者Index去匹配。当然也可以不写，默认第一个字段就是index=0，以此类推。千万注意，要么全部不写，要么全部用index，要么全部用名字去匹配。千万别三个混着用，除非你非常了解源代码中三个混着用怎么去排序的。
@ExcelIgnore EasyExcel默认所有字段都会和excel去匹配，加了这个注解会忽略该字段
@DateTimeFormat 日期转换，用String去接收excel日期格式的数据会调用这个注解。里面的value参照java.text.SimpleDateFormat
@NumberFormat 数字转换，用String去接收excel数字格式的数据会调用这个注解。里面的value参照java.text.DecimalFormat
3. converter自定义转换器
通过自定义转换器，比如将数据库中表示性别的1、0转换成男、女的实例：
性别转换器：
/*** 性别转换器* */public class GenderConverter implements Converter<Integer> {@Overridepublic Class<?> supportJavaTypeKey() {// 实体类中对象属性类型return Integer.class;}@Overridepublic CellDataTypeEnum supportExcelTypeKey() {// Excel中对应的CellData(单元格数据)属性类型return CellDataTypeEnum.STRING;}/*** 将单元格里的数据转为java对象，也就是女转成2，男转成1，用于导入excel时对性别字段进行转换* */@Overridepublic Integer convertToJavaData(ReadConverterContext<?> context) throws Exception {// 从CellData中读取数据，判断Excel中的值，将其转换为预期的数值return GenderEnum.convert(context.getReadCellData().getStringValue()).getValue();}/*** 将java对象转为单元格数据，也就是2转成女，1转成男，用于导出excel时对性别字段进行转换* */@Overridepublic WriteCellData<?> convertToExcelData(WriteConverterContext<Integer> context) throws Exception {// 判断实体类中获取的值，转换为Excel预期的值，并封装为CellData对象return new WriteCellData<>(GenderEnum.convert(context.getValue()).getDescription());}}
4、性别枚举类
@Getter@AllArgsConstructorpublic enum GenderEnum {/*** 未知*/UNKNOWN(0, "未知"),/*** 男性*/MALE(1, "男性"),/*** 女性*/FEMALE(2, "女性");private final Integer value;@JsonFormatprivate final String description;public static GenderEnum convert(Integer value) {// 用于为给定元素创建顺序流// values:获取枚举类型的对象数组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);}}
5、 普通导出
/*** 设置响应结果** @param response 响应结果对象* @param rawFileName 文件名* @throws UnsupportedEncodingException 不支持编码异常*/private void setExcelResponseProp(HttpServletResponse response, String rawFileName) throws UnsupportedEncodingException {//设置内容类型response.setContentType("application/vnd.vnd.ms-excel");//设置编码格式response.setCharacterEncoding("utf-8");//设置导出文件名称（避免乱码）String fileName = URLEncoder.encode(rawFileName.concat(".xlsx"), "UTF-8");// 设置响应头response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName);}private Date getBirthday(int year, int month, int day){Calendar calendar = Calendar.getInstance();calendar.set(year, month, day);return calendar.getTime();}/*** 导出数据* */@GetMapping("/export/user")public void exportUserExcel(HttpServletResponse response) throws IOException {OutputStream outputStream=response.getOutputStream();try {this.setExcelResponseProp(response, "用户列表");// 模拟根据条件在数据库查询数据List<UserDO> userList = new ArrayList<>();for(int i=0;i<30;i++){UserDO userDO =new UserDO();userDO.setBirthday(getBirthday(2001,1,i));userDO.setGender(1);userDO.setHeight(Double.valueOf(i));userDO.setId(Long.valueOf(i));userDO.setPhone("138"+i);userDO.setNickname("yuanhaoz");userDO.setPassword("5849"+i);userDO.setUsername("monky"+i);userList.add(userDO);}//这个实现方式非常简单直接，使用EasyExcel的write方法将查询到的数据进行处理，以流的形式写出即可EasyExcel.write(outputStream,UserDO.class)//对应的导出实体类.excelType(ExcelTypeEnum.XLSX)//excel文件类型，包括CSV、XLS、XLSX.sheet("用户列表")//导出sheet页名称.doWrite(userList); //查询获取的数据集合List<T>，转成excel} catch (IOException e) {throw new RuntimeException(e);}finally {outputStream.flush();outputStream.close();}}
6. 多sheet导出
/*** 多sheet导出数据* */@GetMapping("/manySheet")public void exportManySheet(HttpServletResponse response)throws IOException{OutputStream outputStream=response.getOutputStream();ExcelWriter writer = EasyExcel.write(outputStream, UserDO.class).excelType(ExcelTypeEnum.XLSX).build();try {this.setExcelResponseProp(response, "用户列表");// 模拟根据条件在数据库分页查询数据for(int j=1;j<=5;j++){List<UserDO> userList = new ArrayList<>();for(int i=0;i<30;i++){UserDO userDO =new UserDO();userDO.setBirthday(getBirthday(2001,1,i));userDO.setGender(1);userDO.setHeight(Double.valueOf(i));userDO.setId(Long.valueOf(i));userDO.setPhone("138"+i);userDO.setNickname("yuanhaoz"+i);userDO.setPassword("5849"+i);userDO.setUsername("monky"+i);userList.add(userDO);System.out.println(i);}//创建新的sheet页WriteSheet writeSheet = EasyExcel.writerSheet("用户信息" + j).build();//将list集合中的对象写到对应的sheet中去writer.write(userList,writeSheet);}} catch (IOException e) {throw new RuntimeException(e);//给提示todo}finally {writer.finish();outputStream.flush();outputStream.close();}}
2、使用EasyExcel进行读操作（下载excel）
1、文件读取配置
/*** 自定义监听器，对下载的excel中的数据进行校验* */public class UserListener extends AnalysisEventListener {List<String> names = new ArrayList<>();/*** 每解析一行，回调该方法** @param data* @param context*/@Overridepublic void invoke(Object data, AnalysisContext context) {//校验名称String name = ((UserDO) data).getUsername();if (StrUtil.isBlank(name)) {throw new RuntimeException(String.format("第%s行名称为空，请核实", context.readRowHolder().getRowIndex() + 1));}if (names.contains(name)) {throw new RuntimeException(String.format("第%s行名称已重复，请核实", context.readRowHolder().getRowIndex() + 1));} else {names.add(name);}}/*** 出现异常回调** @param exception* @param context* @throws Exception*/@Overridepublic void onException(Exception exception, AnalysisContext context) throws Exception {if (exception instanceof ExcelDataConvertException) {/**从0开始计算*/Integer columnIndex = ((ExcelDataConvertException) exception).getColumnIndex() + 1;Integer rowIndex = ((ExcelDataConvertException) exception).getRowIndex() + 1;String message = "第" + rowIndex + "行，第" + columnIndex + "列" + "数据格式有误，请核实";throw new RuntimeException(message);} else if (exception instanceof RuntimeException) {throw exception;} else {super.onException(exception, context);}}/*** 解析完,全部回调** @param context*/@Overridepublic void doAfterAllAnalysed(AnalysisContext context) {//解析完,全部回调逻辑实现names.clear();}}
2、导入
/*** 导入数据* */@PostMapping(value = "/importData")public void importData(MultipartFile file){try {//获取文件的输入流InputStream inputStream = file.getInputStream();List<UserDO> lst = EasyExcel.read(inputStream) //调用read方法//注册自定义监听器，字段校验可以在监听器内实现.registerReadListener(new UserListener()).head(UserDO.class) //对应导入的实体类.sheet(0) //导入数据的sheet页编号，0代表第一个sheet页，如果不填，则会导入所有sheet页的数据.headRowNumber(1) //列表头行数，1代表列表头有1行，第二行开始为数据行.doReadSync(); //开始读Excel，返回一个List<T>集合，继续后续入库操作//模拟导入数据库操作for (UserDO userDO:lst){System.out.println(userDO.toString());}}catch (IOException exception){throw new RuntimeException(exception);}}
因为UserListener对象不能交给spring对象进行管理、需要手动new出来，所以不能注入其他对象，比如Service
那么如何解决呢？
可以在UserListener中添加xxxService属性并创建有参构造器和无参构造器。
Service层导入Excel的方法参数里添加需要使用的Service实现对象
例如
ResultUtil importData(MultipartFile file, SubjectService subjectService )
以及
EasyExcel.read(inputStream)
.registerReadListener(new UserListener(subjectService ))
