easyexcel快速入门

一 前言

本篇是EasyExcel快速入门知识,讲解如何读取,写入excel ,并给出了简单web示例;为何要使用easyexcel;缘由是相比于poi,easyexcel更加轻量级,读取写入API方便,而且在工做中占用内存较小;java

官方描述以下:git

Java解析、生成Excel比较有名的框架有Apache poi、jxl。但他们都存在一个严重的问题就是很是的耗内存,poi有一套SAX模式的API能够必定程度的解决一些内存溢出的问题,但POI仍是有一些缺陷,好比07版Excel解压缩以及解压后存储都是在内存中完成的,内存消耗依然很大。easyexcel重写了poi对07版Excel的解析,可以本来一个3M的excel用POI sax依然须要100M左右内存下降到几M,而且再大的excel不会出现内存溢出,03版依赖POI的sax模式。在上层作了模型转换的封装,让使用者更加简单方便github

知识追寻者(Inheriting the spirit of open source, Spreading technology knowledge;)web

二 读取excel

读取的大致流程以下markdown

  1. 读取数据流
  2. 将数据流映射到listener
  3. listener中处理读取的每条记录
  4. 读取完毕,进行清理;

2.1 读取

读取的方法以下,本方法是基于模型映射方法读取,其它方法请读者自行参考官方文档;app

模型是User.class;框架

listener是UserDataListeneride

读取 第一个sheet;学习

@Test
    public void testRead1(){
        InputStream inputStream = null;
        try {
            // 获取输入流
            inputStream = new FileInputStream("C:\\mydata\\generator\\zszxz.xlsx");
            // 解析每行结果在listener中处理
            AnalysisEventListener listener = new UserDataListener();
            // 读取excel
            ExcelReader excelReader = EasyExcel.read(inputStream, User.class, listener)
                    .build();
            // 读取sheet0
            ReadSheet readSheet = EasyExcel.readSheet(0).build();
            // 将 sheet 写入 Reader
            excelReader.read(readSheet);

        } catch (Exception e) {
        } finally {
            try {
                inputStream.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
复制代码

2.2 模型实例

以下所示,index 参数表明excel对应的列,0表示第一列; value表示列对应的名称,在写入excel时做用较大;ui

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {

    // id
    @ExcelProperty(index = 0,value = "编号")
    private Long id;
    // 名称
    @ExcelProperty(index = 1,value = "名称")
    private String name;
    // 建立时间
    @ExcelProperty(index = 2,value = "建立时间")
    private String createTime;
    // 描述
    @ExcelProperty(index = 3,value = "描述")
    private String description;

}
复制代码

2.3 AnalysisEventListener

实现 AnalysisEventListener接口;

invoke方法用于处理每条数据,读者能够在这边进行业务逻辑处理

doAfterAllAnalysed方法是只处理完全部数据后进行的动做;

@Component
public class UserDataListener extends AnalysisEventListener<User> {



    // 用于存储读取到的数据
    private List<User> datas = new ArrayList<User>();

    // 这边你能够注入servie,或者mapper 进行业务逻辑处理后数据入库

    /* * * @Author lsc * <p>解析每条数据处理的动做 </p> * @Param [user, analysisContext] * @Return void */
    @Override
    public void invoke(User user, AnalysisContext analysisContext) {
        datas.add(user);
        // do something

    }

    /* * * @Author lsc * <p> 解析全部数据以后处理的动做 </p> * @Param [analysisContext] * @Return void */
    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {
        // 打印
        System.out.println(datas);
        // do something
        // 清理
        datas.clear();
    }

}
复制代码

三 写入excel

3.1 准备的数据

准备的数据也是一个List集合,存储读取的每行数据;

public class DataUtils {

    public static List<User> getUserData(){
        // 写入响应
        List<User> datas = new ArrayList<User>();
        User user = new User();
        user.setId(666L);
        user.setName("知识追寻者");
        user.setCreateTime(LocalDateTime.now().toString());
        user.setDescription("跟着知识追寻者学习吧");
        datas.add(user);
        return datas;
    }
}
复制代码

3.2 写入

写入的数据更加简单,由于有了以前的模型映射;

@Test
    public void simpleWrite() {
        // 文件名
        String fileName = "C:\\mydata\\generator\\知识追寻者.xlsx";
        // 写入
        EasyExcel.write(fileName, User.class).sheet("知识追寻者").doWrite(DataUtils.getUserData());
    }
复制代码

四 web上传下载示例

@RestController
public class ExcelController {

    @GetMapping("download")
    public void download(HttpServletResponse response) throws IOException {
        // 设置 ContentType
        response.setContentType("application/vnd.ms-excel");
        // 设置字符集
        response.setCharacterEncoding("utf-8");
        // 防止中文乱码
        String fileName = URLEncoder.encode("知识追寻者", "UTF-8");
        // 设置 header
        response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
        // 写入
        EasyExcel.write(response.getOutputStream(), User.class)
                .sheet("知识追寻者")// 指定sheet名称
                .doWrite(DataUtils.getUserData());//写入数据
    }

    @PostMapping("upload")
    @ResponseBody
    public String upload(MultipartFile file) throws IOException {
        EasyExcel.read(file.getInputStream(), User.class, new UserDataListener())
                .sheet()
                .doRead();
        return "success";
    }

}
复制代码

五参考连接

github.com/alibaba/eas…

本文同步分享在 博客“知识追寻者”(JueJin)。
若有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一块儿分享。

相关文章
相关标签/搜索