GitHub | 博客 | 使用手冊

AutoExcel V2.0.0 帶來以下新特性

1. 支持百萬數據秒級導入導出
2. 重寫導入方法

Maven

<dependency>
  <groupId>net.fenghaitao</groupId>
  <artifactId>auto-excel</artifactId>
  <version>2.0.0</version>
</dependency>

支持百萬數據秒級導入導出

以某巴巴的EasyExcel（版本2.2.6）作為對比，相同環境下測得以下結果，單位為毫秒

可見，AutoExcel和EasyExcel在導入導出效率上相差不大，因為兩者的導出都是基于SXSSF，導入都是基于SAX，只是AutoExcel對POI的封裝更加輕量，所以效率會稍微高一些，數據量越大越明顯。

當然，實際上，AutoExcel并非專注于導入導出的效率，而是開發體驗，為開發者提供自動化功能的同時，讓開發者書寫盡可能少的代碼。如自動應用單元格樣式、自動填充行號、自動填充公式、自動匯總、自動列寬等，詳細用法可前往AutoExcel——Excel導入導出利器查看。

重寫導入方法

V1.0.0中基于模板的導入方式已被廢棄，新版中需使用FieldSetting來指定列名與字段名的映射關系

public void importExcel() {
    List<ImportPara> importParas = new ArrayList<ImportPara>() {{
        add(new ImportPara(0, DataGenerator.genProductFieldSettings()));
        add(new ImportPara(1, DataGenerator.genProjectFieldSettings(), 1, 5));
    }};
    String fileName = this.getClass().getResource("/template/Import.xlsx").getPath();
    DataSet dataSet = AutoExcel.read(fileName, importParas);
    // 方式一、直接獲取數據，沒有類型轉換，可通過這種方式檢驗數據是否符合要求
    List<Map<String, Object>> products = dataSet.get("Product");
    List<Map<String, Object>> projects = dataSet.get("Project");
    // 方式二、通過sheet索引獲取指定類的數據，類型自動轉換，轉換失敗將拋出異常
    // List<Product> products = dataSet.get(0, Product.class);
    // List<Project> projects= dataSet.get(1, Project.class);
    // 方式三、通過sheet名稱獲取指定類的數據，類型自動轉換，轉換失敗將拋出異常
    // List<Product> products = dataSet.get("Product", Product.class);
    // List<Project> projects = dataSet.get("Project", Project.class);
}

public static List<FieldSetting> genProjectFieldSettings() {
    List<FieldSetting> fieldSettings = new ArrayList<>();
    fieldSettings.add(new FieldSetting("projName", "Project Name"));
    fieldSettings.add(new FieldSetting("projInfo", "Project Info."));
    fieldSettings.add(new FieldSetting("basalArea", "Basal Area"));
    fieldSettings.add(new FieldSetting("availableArea", "Available Area"));
    fieldSettings.add(new FieldSetting("buildingArea", "Building Area"));
    fieldSettings.add(new FieldSetting("buildingsNumber", "Buildings Number"));
    fieldSettings.add(new FieldSetting("saleStartDate", "Sales Start Date"));
    fieldSettings.add(new FieldSetting("landAcquisitionTime", "Land Acquisition Time"));
    fieldSettings.add(new FieldSetting("availablePrice", "Available Price"));
    fieldSettings.add(new FieldSetting("availableAmount", "Available Amount"));
    fieldSettings.add(new FieldSetting("insideArea", "Inside Area"));
    return fieldSettings;
}

public static List<FieldSetting> genProductFieldSettings() {
    List<FieldSetting> fieldSettings = new ArrayList<FieldSetting>() {{
        add(new FieldSetting("projName", "Project Name"));
        add(new FieldSetting("basalArea", "Basal Area"));
        add(new FieldSetting("availableArea", "Available Area"));
        add(new FieldSetting("buildingArea", "Building Area"));
        add(new FieldSetting("buildingsNumber", "Buildings Number"));
    }};
    return fieldSettings;
}

ImportPara構造方法入參：

1. sheetIndex：必填，sheet索引
2. fieldSettings：必填，列名與字段名映射設置
3. titleIndex：可省略，標題行開始索引，默認為0
4. dataStartIndex：可省略，數據行開始索引，默認為1

為什么使用FieldSetting不采用注解的方式聲明列名？

1. 非侵入式，不影響原來的代碼
2. 在系統設計的時候，為了重用相同的配置，如頁面展示、導出、導入、打印都展示相同的列名，我們會將這些配置存放在存儲介質如數據庫，待使用時加載出來，這種方式也可以避免硬編碼，還可以方便地進行動態配置，采用FieldSetting就是為了配合這種方式。AutoExcel盡可能讓導入導出融入到你的自動化系統。