Anarkh的知识库

主题

除了POI和EasyExcel，国内还有一个EasyPOI框架较为常见，适用于没有使用过POI并希望快速操作Excel的入门项目，在中大型项目中并不推荐使用(为了保证知识体系的完整性，把EasyPOI也加了进来)。本文主要介绍SpringBoot集成EasyPOI实现Excel的导入，导出和填充模板等功能。@anarkh

  • SpringBoot集成文件 - 集成EasyPOI之Excel导入导出
  • 知识准备
  • 什么是EasyPOI
  • 如何看待EasyPOI
  • 实现案例
  • Pom依赖
  • 导出Excel
  • 导入Excel
  • 填充Excel模板
  • 示例源码
  • 参考文章

知识准备 ​

需要对EasyPOI特色功能和潜在缺陷。@anarkh

什么是EasyPOI ​

如下是EasyPOI官方在新窗口打开介绍的功能。

独特的功能：

  • 基于注解的导入导出,修改注解就可以修改Excel
  • 支持常用的样式自定义
  • 基于map可以灵活定义的表头字段
  • 支持一堆多的导出,导入
  • 支持模板的导出,一些常见的标签,自定义标签
  • 支持HTML/Excel转换,如果模板还不能满足用户的变态需求,请用这个功能
  • 支持word的导出,支持图片,Excel

如何看待EasyPOI ​

不建议在稍复杂的项目中使用EasyPOI 。@anarkh

  • 简单的功能通过对POI的封装成本也不高，复杂的一点的适配性差；有点像为了做某件事方便，引入了一个工具，最后发现大量的时间都在迎合/修理这个工具
  • 个人色彩，缺少稳定维护团队，潜在风险远大于节约的这点时间；同时个人开源又期望寻求盈利点，对开发者选择而言是要很慎重的。
  • 封装的思路可以借鉴下，在自行根据业务封装时可以参考下

实现案例 ​

这里展示SpringBoot集成EasyPOI导出用户列表的和导入用户列表的例子。

Pom依赖 ​

引入poi的依赖包

xml
<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>

导出Excel ​

User 类

java
package tech.anarkh.springboot.file.excel.easypoi.entity;

import cn.afterturn.easypoi.excel.annotation.Excel;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;


@Builder
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User implements BaseEntity {

    
    @Excel(name = "ID")
    private Long id;

    
    @Excel(name = "Name")
    private String userName;

    
    @Excel(name = "Email")
    private String email;

    
    @Excel(name = "Phone")
    private long phoneNumber;

    
    @Excel(name = "Description")
    private String description;


}

UserController中导出的方法

java
@ApiOperation("Download Excel")
@GetMapping("/excel/download")
public void download(HttpServletResponse response) {
    try {
        response.reset();
        response.setContentType("application/vnd.ms-excel");
        response.setHeader("Content-disposition",
                "attachment;filename=user_excel_" + System.currentTimeMillis() + ".xlsx");
        userService.downloadExcel(response.getOutputStream());
    } catch (Exception e) {
        e.printStackTrace();
    }
}

UserServiceImple中导出Excel的主方法

java
@Override
public void downloadExcel(ServletOutputStream outputStream) throws IOException {
    ExportParams exportParams = new ExportParams();
    exportParams.setTitle("User Table");
    exportParams.setSheetName("User Sheet");
    Workbook workbook = ExcelExportUtil.exportExcel(exportParams, User.class, getUserList());
    workbook.write(outputStream);
    workbook.close();
}

导出后的excel如下

PS：再吐槽下：

当getUserList用 Collections.singletonList时是直接报错，看了下源码~

java
private List&lt;User&gt; getUserList() {
    return Collections.singletonList(User.builder()
            .id(1L).userName("anarkh").email("anarkh@anarkh.tech").phoneNumber(121231231231L)
            .description("hello world")
            .build());
}

默默改成ArrayList, 因为源代码是通过remove来迭代的，且只对Unmodified Collection做了处理，而没有对singletonList... 只能说不建议在稍复杂的项目中使用EasyPOI...

java
private List&lt;User&gt; getUserList() {
    List&lt;User&gt; userList = new ArrayList<>();
    userList.add(User.builder()
            .id(1L).userName("anarkh").email("anarkh@anarkh.tech").phoneNumber(121231231231L)
            .description("hello world")
            .build());
    return userList;
}

导入Excel ​

UserController中导入的方法，（导入的文件在项目根目录）

java
@ApiOperation("Upload Excel")
@PostMapping("/excel/upload")
public ResponseResult&lt;String&gt; upload(@RequestParam(value = "file", required = true) MultipartFile file) {
    try {
        userService.upload(file.getInputStream());
    } catch (Exception e) {
        e.printStackTrace();
        return ResponseResult.fail(e.getMessage());
    }
    return ResponseResult.success();
}

UserServiceImple中导入Excel的主方法

java
@Override
public void upload(InputStream inputStream) throws Exception {
    ImportParams importParams = new ImportParams();
    List&lt;User&gt; userList = ExcelImportUtil.importExcel(inputStream, User.class, importParams);
    userList.stream().forEach(user -> log.info(user.toString()));
}

通过PostMan进行接口测试

日志如下

java
2022-06-15 22:20:48.145  INFO 52348 --- [nio-8080-exec-2] t.p.s.f.e.e.s.impl.UserServiceImpl       : User(id=1, userName=anarkh, email=anarkh@anarkh.tech, phoneNumber=121231231231, description=hello world)

填充Excel模板 ​

准备如下Excel模板

UserController中下载填充后的Excel方法

java
@ApiOperation("Fill Excel Template")
@GetMapping("/excel/fill")
public void fillTemplate(HttpServletResponse response) {
    try {
        response.reset();
        response.setContentType("application/vnd.ms-excel");
        response.setHeader("Content-disposition",
                "attachment;filename=user_excel_template_" + System.currentTimeMillis() + ".xlsx");
        userService.fillExcelTemplate(response.getOutputStream());
    } catch (Exception e) {
        e.printStackTrace();
    }
}

UserServiceImpl中填充excel模板的方法

java
@Override
public void fillExcelTemplate(ServletOutputStream outputStream) throws IOException {
    
    String templateFileName = "/Users/anarkh/Downloads/user_excel_template_easypoi.xlsx";
    TemplateExportParams params = new TemplateExportParams(templateFileName);

    Map&lt;String, Object&gt; map = new HashMap<>();
    map.put("user", "anarkh");
    map.put("date", new Date());
    map.put("userList", getUserList());
    Workbook workbook = ExcelExportUtil.exportExcel(params, map);
    workbook.write(outputStream);
    workbook.close();
}

private List&lt;User&gt; getUserList() {
    List&lt;User&gt; userList = new ArrayList<>();
    userList.add(User.builder()
            .id(1L).userName("anarkh").email("anarkh@anarkh.tech").phoneNumber(121231231231L)
            .description("hello world")
            .build());
    userList.add(User.builder()
            .id(2L).userName("anarkh2").email("anarkh2@anarkh.tech").phoneNumber(1212312312312L)
            .description("hello world2")
            .build());
    return userList;
}

访问http://localhost:8080/user/excel/fill 下载

(PS: 说实在的，稍复杂一些的，不如自己封装...)

示例源码 ​

https://github.com/realanarkh/tech-anarkh-spring-demos

参考文章 ​

http://doc.wupaas.com/docs/easypoi/easypoi-1c0u4mo8p4ro8