GitHub | 博客 | 使用手冊(cè)

AutoExcel V2.0.0 帶來(lái)以下新特性

1. 支持百萬(wàn)數(shù)據(jù)秒級(jí)導(dǎo)入導(dǎo)出
2. 重寫(xiě)導(dǎo)入方法

Maven

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

支持百萬(wàn)數(shù)據(jù)秒級(jí)導(dǎo)入導(dǎo)出

以某巴巴的EasyExcel（版本2.2.6）作為對(duì)比，相同環(huán)境下測(cè)得以下結(jié)果，單位為毫秒

可見(jiàn)，AutoExcel和EasyExcel在導(dǎo)入導(dǎo)出效率上相差不大，因?yàn)閮烧叩膶?dǎo)出都是基于SXSSF，導(dǎo)入都是基于SAX，只是AutoExcel對(duì)POI的封裝更加輕量，所以效率會(huì)稍微高一些，數(shù)據(jù)量越大越明顯。

當(dāng)然，實(shí)際上，AutoExcel并非專(zhuān)注于導(dǎo)入導(dǎo)出的效率，而是開(kāi)發(fā)體驗(yàn)，為開(kāi)發(fā)者提供自動(dòng)化功能的同時(shí)，讓開(kāi)發(fā)者書(shū)寫(xiě)盡可能少的代碼。如自動(dòng)應(yīng)用單元格樣式、自動(dòng)填充行號(hào)、自動(dòng)填充公式、自動(dòng)匯總、自動(dòng)列寬等，詳細(xì)用法可前往AutoExcel——Excel導(dǎo)入導(dǎo)出利器查看。

重寫(xiě)導(dǎo)入方法

V1.0.0中基于模板的導(dǎo)入方式已被廢棄，新版中需使用FieldSetting來(lái)指定列名與字段名的映射關(guān)系

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);
    // 方式一、直接獲取數(shù)據(jù)，沒(méi)有類(lèi)型轉(zhuǎn)換，可通過(guò)這種方式檢驗(yàn)數(shù)據(jù)是否符合要求
    List<Map<String, Object>> products = dataSet.get("Product");
    List<Map<String, Object>> projects = dataSet.get("Project");
    // 方式二、通過(guò)sheet索引獲取指定類(lèi)的數(shù)據(jù)，類(lèi)型自動(dòng)轉(zhuǎn)換，轉(zhuǎn)換失敗將拋出異常
    // List<Product> products = dataSet.get(0, Product.class);
    // List<Project> projects= dataSet.get(1, Project.class);
    // 方式三、通過(guò)sheet名稱(chēng)獲取指定類(lèi)的數(shù)據(jù)，類(lèi)型自動(dòng)轉(zhuǎn)換，轉(zhuǎn)換失敗將拋出異常
    // 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構(gòu)造方法入?yún)ⅲ?/p>

1. sheetIndex：必填，sheet索引
2. fieldSettings：必填，列名與字段名映射設(shè)置
3. titleIndex：可省略，標(biāo)題行開(kāi)始索引，默認(rèn)為0
4. dataStartIndex：可省略，數(shù)據(jù)行開(kāi)始索引，默認(rèn)為1

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

1. 非侵入式，不影響原來(lái)的代碼
2. 在系統(tǒng)設(shè)計(jì)的時(shí)候，為了重用相同的配置，如頁(yè)面展示、導(dǎo)出、導(dǎo)入、打印都展示相同的列名，我們會(huì)將這些配置存放在存儲(chǔ)介質(zhì)如數(shù)據(jù)庫(kù)，待使用時(shí)加載出來(lái)，這種方式也可以避免硬編碼，還可以方便地進(jìn)行動(dòng)態(tài)配置，采用FieldSetting就是為了配合這種方式。AutoExcel盡可能讓導(dǎo)入導(dǎo)出融入到你的自動(dòng)化系統(tǒng)。