前提概要

針對於後端開發者而言的,作為報表的匯入和匯出是一個很基礎且有很棘手的問題!之前常用的工具和方案大概有這麼幾種:

  1. JXL(Java Excel API 工具服務),此種只支援xls的檔案格式,而且對於記憶體的管理特別的差,現在基本不用了!
  2. 目前大多數會操作Excel工具服務或者解析都是利用Apache POI進行操作。
  3. 其他第三方的工具很多也是基於POI作為實現基礎!

存在隱患問題

因為當資料量特別大的時候,比如:說Excel匯出,如果資料量在百萬級,很有可能會出現倆點記憶體溢位的問題以及頁面極具卡頓。

解決方案

  • 首先,在百萬級大資料量Excel檔案的匯出我們可以採用分批查詢資料來避免記憶體溢位的劇增!

  • 此外,POI給出的方案是:使用SXSSFWorkbook方式快取資料到檔案上以解決下載大檔案EXCEL卡死頁面的問題。

    • SXSSFWorkbook資料模型:主要可以解決在下載傳輸到瀏覽器的時候大Excel檔案轉換的輸出流記憶體溢位
    • 此外其還可以通過其建構函式執指定在記憶體中快取的行數剩餘的會自動快取在硬碟的臨時目錄上,同時,並不會存在頁面卡頓的情況
    1. SXSSF機制而言還是需要手動進行封裝及定製化開發增加了一定的工作量!
    2. POI的操作方式仍然還是存在記憶體佔用過大的問題,仍會存在記憶體溢位的隱患
    3. 存在空迴圈和整除的時候資料有缺陷的問題

更優秀的選擇

對此阿里巴巴發明咯一個“萬金油”!EasyExcel(簡單Excel操作工具,讓Excel變得更簡單!),除此之外它可以將解析的Excel的記憶體佔用控制在KB級別,並且絕對不會記憶體溢位,還有就是速度極快, 不用想了就它了!


EasyExcel的介紹說明

EasyExcel是一個基於Java實現的、以節省記憶體為主要目標的的讀寫Excel檔案的開源專案。經過官方統計,在儘可能節約記憶體的情況下支援讀寫百M的Excel檔案的讀寫操作能力!

技術原理對比

POI

當利用POI去讀取Excel時,首先會將資料全部載入到記憶體中,然後返回給呼叫者,當資料量比較大時,及其容易發生OOM。以下是執行流程圖:



EasyExcel

與POI 不用的是,EasyExcel主要是採用sax模式一行一行解析,並將一行的解析結果以觀察者的模式通知處理,即使資料量較大時也不會發生OOM,以下是其執行流程圖



技術原理圖

借用官方圖

節省記憶體的開銷

借用官方圖片:https://alibaba-easyexcel.github.io/images/large.png

64M記憶體1分鐘內讀取75M(46W行25列)的ExcelExcel 記憶體開銷圖。當然還有急速模式能更快,但是記憶體佔用會在100M多一點。其實就是拿空間換時間!

Maven倉庫依賴

我用的版本是2.2.6

  1. <dependency>
  2. <groupId>com.alibaba</groupId>
  3. <artifactId>easyexcel</artifactId>
  4. <version>2.2.6</version>
  5. </dependency>

注: 系統內部如果有POI的包一定讓poi和poi-ooxml的版本要保持一致。

注: 如果是springboot2.0,則不需要poi依賴,如果是1.0,則需要poi依賴,並且poi和poi-ooxml的版本要保持一致。

  1. <!-- poi -->
  2. <dependency>
  3. <groupId>org.apache.poi</groupId>
  4. <artifactId>poi</artifactId>
  5. <version>3.17</version>
  6. </dependency>
  7. <dependency>
  8. <groupId>org.apache.poi</groupId>
  9. <artifactId>poi-ooxml</artifactId>
  10. <version>3.17</version>
  11. </dependency>

基礎API介紹(參考官方文件)

  • EasyExcel 入口類,用於構建開始各種操作,屬於典型的門面+工廠模式
  1. public void testReadEntity() {
  2. // 被讀取的檔案絕對路徑
  3. String fileName = "path/testDemo.xlsx";
  4. // 接收解析出的目標物件(Entity)指的是你的實體類
  5. List<Entity> entityList = new ArrayList<>();
  6. // 這裡需要指定讀用哪個class去讀,然後讀取第一個sheet檔案流會自動關閉
  7. // excel中表的列要與物件的欄位相對應
  8. EasyExcel.read(fileName, Entity.class, new AnalysisEventListener<Student>() {
  9. // 每解析一條資料都會呼叫該方法
  10. @Override
  11. public void invoke(Entity entity, AnalysisContext analysisContext) {
  12. System.out.println("解析一條Row行物件:" + JSON.toJSONString(entity));
  13. entityList.add(student);
  14. }
  15. // 解析完畢的回撥方法
  16. @Override
  17. public void doAfterAllAnalysed(AnalysisContext analysisContext) {
  18. System.out.println("excel檔案讀取完畢!");
  19. }
  20. }).sheet().doRead();
  21. }
  22. // 通過Map作為整體的資料結構模型
  23. public void readWithoutObj() {
  24. // 被讀取的檔案絕對路徑
  25. String fileName = "path/testDemo.xlsx";
  26. // 接收結果集,為一個List列表,每個元素為一個map物件,key-value對為excel中每個列對應的值
  27. List<Map<Integer,String>> resultList = new ArrayList<>();
  28. EasyExcel.read(fileName, new AnalysisEventListener<Map<Integer,String>>() {
  29. @Override
  30. public void invoke(Map<Integer, String> map, AnalysisContext analysisContext) {
  31. System.out.println("解析到一條資料:" + JSON.toJSONString(map));
  32. resultList.add(map);
  33. }
  34. @Override
  35. public void doAfterAllAnalysed(AnalysisContext analysisContext) {
  36. System.out.println("excel檔案解析完畢!" + JSON.toJSONString(resultList));
  37. }
  38. }).sheet().doRead();
  39. }
  • invoke方法代表每解析一行就會呼叫一次,data資料表示解析出來一行的資料。

  • doAfterAllAnalysed 該方法表示將所有資料解析完畢以後才會去呼叫該方法。

  • 內部實現機制:(可以理解成一個excel物件,一個excel只要構建一個)

    • ExcelReaderBuilder 構建出一個 ReadWorkbook

      • excelType 當前excel的型別 預設會自動判斷
      • inputStream 與file二選一。讀取檔案的流,如果接收到的是流就只用,不用流建議使用file引數。因為使用了inputStream easyexcel會幫忙建立臨時檔案,最終還是file
      • file 與inputStream二選一。讀取檔案的檔案。
      • autoCloseStream 自動關閉流。
      • readCache 預設小於5M用 記憶體,超過5M會使用 EhCache,這裡不建議使用這個引數。
      • useDefaultListener @since 2.1.4 預設會加入ModelBuildEventListener 來幫忙轉換成傳入class的物件,設定成false後將不會協助轉換物件,自定義的監聽器會接收到Map<Integer,CellData>物件,如果還想繼續接聽到class物件,請呼叫readListener方法,加入自定義的beforeListener、 ModelBuildEventListener、 自定義的afterListener即可。
      • 方法體現:
        • EasyExcel.read 該方法是用來建立ExcelReaderBuilder物件,該物件就是用來解析Excel文件
        • read方法需要傳入三個引數:
          • 第一個引數:需要解析檔案的路徑,當然除了傳入一個檔案路徑以外,還可以傳入InputStream
          • 第二引數:資料型別的Class型別物件,可以不傳
          • 第三個引數:事件監聽器,在之前介紹這款框架時說過,該框架是基於SAX的一種解析,載入一行資料到記憶體就會去解析一行,主要是為了節約記憶體。
    • ExcelWriterBuilder 構建出一個 WriteWorkbook

      • excelType 當前excel的型別 預設xlsx
      • outputStream 與file二選一。寫入檔案的流
      • file 與outputStream二選一。寫入的檔案
      • templateInputStream 模板的檔案流
      • templateFile 模板檔案
      • autoCloseStream 自動關閉流。
      • password 寫的時候是否需要使用密碼
      • useDefaultStyle 寫的時候是否是使用預設頭
    • WriteTable(就把excel的一個Sheet,一塊區域看一個table)引數

      • tableNo 需要寫入的編碼。預設0
  • 內部實現機制:(可以理解成excel裡面的一頁,每一頁都要構建一個)

    • ExcelReaderSheetBuilder:構建出一個 ReadSheet物件。

      • sheetNo 需要讀取Sheet的編碼,建議使用這個來指定讀取哪個Sheet。
      • sheetName 根據名字去匹配Sheet,excel 2003不支援根據名字去匹配。
    • ExcelWriterSheetBuilder 構建出一個 WriteSheet物件。
      • 需要寫入的編碼。預設0
      • sheetName 需要些的Sheet名稱,默認同sheetNo
  • 內部實現機制:(可以理解成excel裡面的一頁,每一頁都要構建一個)

    • ReadListener:每一行讀取完畢後都會呼叫ReadListener來處理資料
    • WriteHandler :每一個操作包括建立單元格、建立表格等都會呼叫WriteHandler來處理資料

所有配置都是繼承的,Workbook的配置會被Sheet繼承,所以在用EasyExcel設定引數的時候,在EasyExcel...sheet()方法之前作用域是整個sheet,之後針對單個sheet。

  • 相關使用註解

    • ExcelProperty index 指定寫到第幾列,預設根據成員變數排序。value指定寫入的名稱,預設成員變數的名字,多個value可以參照快速開始中的複雜頭。
    • ExcelIgnore 預設所有欄位都會寫入excel,這個註解會忽略這個欄位
    • DateTimeFormat 日期轉換,將Date寫到excel會呼叫這個註解。裡面的value參照java.text.SimpleDateFormat
    • NumberFormat 數字轉換,用Number寫excel會呼叫這個註解。裡面的value參照java.text.DecimalFormat
    • ExcelIgnoreUnannotated 預設不加ExcelProperty的註解的都會參與讀寫,加了不會參與。
    • 使用案例:
    1. @Data
    2. public class TestEntity {
    3. /**
    4. * 從0開始,2代表強制讀取第三個,
    5. * 不建議 index 和 name 同時用
    6. */
    7. @ExcelProperty(index = 2)
    8. private Double doubleData;
    9. /**
    10. * 用名字去匹配,這裡需要注意,
    11. * 名字重複,會導致只有一個欄位讀取到資料
    12. */
    13. @ExcelProperty("字串標題")
    14. private String string;
    15. @ExcelProperty("日期標題")
    16. private Date date;
    17. }
    1. @Data
    2. public class MultiHeaderEntity implements Serializable {
    3. @ExcelProperty(value = {"一層資訊","二層1"})
    4. private Integer id;
    5. @ExcelProperty(value = {"一層資訊","二層2"})
    6. private String name;
    7. @ExcelProperty(value = {"一層資訊","二層4"})
    8. private String description;
    9. @ExcelProperty(value = {"一層資訊","二層3"})
    10. private Date birthday;
    11. }
    1. @Data
    2. public class ConverterData {
    3. /**
    4. * 我自定義 轉換器,不管資料庫傳過來什麼 。我給他加上“自定義:”
    5. */
    6. @ExcelProperty(converter = CustomStringStringConverter.class)
    7. private String string;
    8. /**
    9. * 這裡用string 去接日期才能格式化。我想接收年月日格式
    10. */
    11. @DateTimeFormat("yyyy年MM月dd日HH時mm分ss秒")
    12. private String date;
    13. /**
    14. * 我想接收百分比的數字
    15. */
    16. @NumberFormat("#.##%")
    17. private String doubleData;
    18. }

注意 :如果使用該類的物件去裝載Excel中的資料,那麼讀取時就只能讀取以下樣式的Excel資料模型,否則資料部分丟失或者全部丟失

實戰案例

讀取Excel實現Demo
資料模型DemoModel
  1. @Data
  2. public class DemoModel {
  3. private String attribute1;
  4. private Date attribute2;
  5. private Double attribute3;
  6. }
讀取回調監聽器

注意:DemoModelAnalysisListener 不要是單例模式或者全域性共享,要每次讀取excel都要new,否則會出現複用之前讀取的過程資料!

  1. @Slf4j
  2. public class DemoModelAnalysisListener extends AnalysisEventListener<DemoData> {
  3. /**
  4. * 每隔500條儲存資料庫,然後清理list ,方便記憶體回收
  5. */
  6. static final int BATCH_COUNT = 500;
  7. List<DemoModel> list = new ArrayList<>();
  8. /**
  9. * 這個也可以是一個service。當然如果不用儲存這個物件沒用。
  10. */
  11. private DemoService demoService;
  12. public DemoModelAnalysisListener(DemoService demoService) {
  13. this.demoService = demoService;
  14. }
  15. /**
  16. * 這個每一條資料解析都會來呼叫
  17. * @param data
  18. * one row value. Is is same as {@link AnalysisContext#readRowHolder()}
  19. * @param context
  20. */
  21. @Override
  22. public void invoke(DemoData data, AnalysisContext context) {
  23. log.info("解析到一條資料:{}", JSON.toJSONString(data));
  24. list.add(data);
  25. // 達到BATCH_COUNT了,需要去儲存一次資料庫,
  26. // 防止資料幾萬條資料在記憶體,容易OOM
  27. if (list.size() >= BATCH_COUNT) {
  28. saveData();
  29. }
  30. }
  31. /**
  32. * 所有資料解析完成了 都會來呼叫
  33. * @param context
  34. */
  35. @Override
  36. public void doAfterAllAnalysed(AnalysisContext context) {
  37. // 這裡也要儲存資料,確保最後遺留的資料也儲存到資料庫
  38. saveData();
  39. log.info("所有資料解析完成!");
  40. }
  41. /**
  42. * 加上儲存資料庫
  43. */
  44. private void saveData() {
  45. log.info("{}條資料,開始儲存資料庫!", list.size());
  46. demoService.insert(list);
  47. // 儲存完成清理 list
  48. list.clear();//解析結束銷燬不用的資源
  49. log.info("儲存資料庫成功!");
  50. }
  51. }
讀取操作測試類
  1. @Test
  2. public void readExcelTest() {
  3. // 寫法1:
  4. DemoService demoService = getService(); //獲取service業務實現類
  5. String fileName = TestFileUtil.getPath() + "demo" + File.separator + "demo.xlsx";
  6. // 這裡 需要指定讀用哪個class去讀,然後讀取第一個sheet 檔案流會自動關閉
  7. EasyExcel.read(fileName, DemoData.class, new DemoModelAnalysisListener(demoService)).sheet().doRead();
  8. // 寫法2:
  9. fileName = TestFileUtil.getPath() + "demo" + File.separator + "demo.xlsx";
  10. ExcelReader excelReader = null;
  11. try {
  12. excelReader = EasyExcel.read(fileName, DemoData.class, new DemoModelAnalysisListener(demoService)).build();
  13. ReadSheet readSheet = EasyExcel.readSheet(0).build();
  14. excelReader.read(readSheet);
  15. } finally {
  16. if (excelReader != null) {
  17. // 這裡千萬別忘記關閉,讀的時候會建立臨時檔案,到時磁碟會崩的
  18. excelReader.finish();
  19. }
  20. }
  21. }
寫入Excel實現Demo
寫入資料模型
  1. @Data
  2. public class DemoData {
  3. @ExcelProperty("字串標題")
  4. private String string;
  5. @ExcelProperty("日期標題")
  6. private Date date;
  7. @ExcelProperty("數字標題")
  8. private Double doubleData;
  9. /**
  10. * 忽略這個欄位
  11. */
  12. @ExcelIgnore
  13. private String ignore;
  14. }
寫入操作程式碼
  1. @Test
  2. public void demoWriteTest() {
  3. // 寫法1
  4. String fileName = TestFileUtil.getPath() + "simpleWrite" + System.currentTimeMillis() + ".xlsx";
  5. // 這裡 需要指定寫用哪個class去寫,然後寫到第一個sheet,名字為模板 然後檔案流會自動關閉
  6. // 如果這裡想使用03 則 傳入excelType引數即可
  7. EasyExcel.write(fileName, DemoData.class).sheet("模板").doWrite(data());
  8. // 寫法2
  9. fileName = TestFileUtil.getPath() + "simpleWrite" + System.currentTimeMillis() + ".xlsx";
  10. // 這裡 需要指定寫用哪個class去寫
  11. ExcelWriter excelWriter = null;
  12. try {
  13. excelWriter = EasyExcel.write(fileName, DemoData.class).build();
  14. WriteSheet writeSheet = EasyExcel.writerSheet("模板").build();
  15. excelWriter.write(data(), writeSheet);
  16. } finally {
  17. // 千萬別忘記finish 會幫忙關閉流
  18. if (excelWriter != null) {
  19. excelWriter.finish();
  20. }
  21. }
  22. }
複雜頭寫入
  1. @Data
  2. public class MultiHeaderEntity implements Serializable {
  3. @ExcelProperty(value = {"一層資訊","二層1"})
  4. private Integer id;
  5. @ExcelProperty(value = {"一層資訊","二層2"})
  6. private String name;
  7. @ExcelProperty(value = {"一層資訊","二層4"})
  8. private String description;
  9. @ExcelProperty(value = {"一層資訊","二層3"})
  10. private Date birthday;
  11. }
複雜頭的寫入操作
  1. @Test
  2. public void complexHeadWrite() {
  3. String fileName = TestFileUtil.getPath() + "complexHeadWrite" + System.currentTimeMillis() + ".xlsx";
  4. // 這裡 需要指定寫用哪個class去寫,然後寫到第一個sheet,名字為模板 然後檔案流會自動關閉
  5. EasyExcel.write(fileName, MultiHeaderEntity.class).sheet("複雜").doWrite(datalist());
  6. }