Easypoi是什么
Easypoi 功能如同名字easy,主打的功能就是容易憔足,讓一個(gè)沒(méi)接觸過(guò)poi的人員胁附,就可以方便的寫(xiě)出Excel導(dǎo)出、Excel模板導(dǎo)出滓彰、Excel導(dǎo)入控妻、Word模板導(dǎo)出,通過(guò)簡(jiǎn)單的注解和模板語(yǔ)言(熟悉的表達(dá)式fe語(yǔ)法)揭绑,完成以前復(fù)雜的寫(xiě)法
開(kāi)源地址:https://gitee.com/lemur/easypoi
獨(dú)特的功能
- 基于注解的導(dǎo)入導(dǎo)出,修改注解就可以修改Excel
- 支持常用的樣式自定義
- 基于map可以靈活定義的表頭字段
- 支持一堆多的導(dǎo)出,導(dǎo)入
- 支持模板的導(dǎo)出,一些常見(jiàn)的標(biāo)簽,自定義標(biāo)簽
- 支持HTML/Excel轉(zhuǎn)換,如果模板還不能滿足用戶的變態(tài)需求,請(qǐng)用這個(gè)功能
- 支持word的導(dǎo)出,支持圖片,Excel
更多特性與功能詳解:easypoi官網(wǎng)說(shuō)明
官方demo
官網(wǎng)實(shí)例工程:easypoi-test
導(dǎo)入
1. 指定模板導(dǎo)入
在導(dǎo)入指定Excel模板的過(guò)程中弓候,可能會(huì)碰到列名重復(fù)的問(wèn)題,當(dāng)我們使用Easypoi的注解方式進(jìn)行導(dǎo)入時(shí)他匪,會(huì)發(fā)現(xiàn)出現(xiàn)丟失數(shù)據(jù)的情況菇存,原因是源碼在解析注解映射關(guān)系的時(shí)候,使用的map進(jìn)行存儲(chǔ)邦蜜,當(dāng)實(shí)體的注解存在相同名稱時(shí)依鸥,key會(huì)被重新覆蓋,導(dǎo)致數(shù)據(jù)列丟失悼沈,如圖通過(guò)添加fixedIndex
屬性得以解決:
需要注意的是:
fixedIndex
是從0開(kāi)始
Excel文件如圖:
2. Map自由導(dǎo)入
ImportParams importParams = new ImportParams();
importParams.setTitleRows(3);//標(biāo)題行
importParams.setHeadRows(1);//表頭行
importParams.setStartSheetIndex(0);//開(kāi)始的sheet下標(biāo)
importParams.setKeyIndex(null);//設(shè)置讀取空值
File file = new File("/file/file.xlsx");//文件路徑
try {
List<Map> list = ExcelImportUtil.importExcel(file, Map.class, importParams);
} catch (Exception e) {
e.printStackTrace();
}
存在的問(wèn)題
- 導(dǎo)入相同列名依舊會(huì)有丟失數(shù)據(jù)的問(wèn)題贱迟,原因key重復(fù)姐扮,目前好像沒(méi)找到解決辦法
- 遍歷時(shí)默認(rèn)map的值為空則不返回,通過(guò)設(shè)置
setKeyIndex(null)
可以解決該問(wèn)題 - 當(dāng)表頭存在多個(gè)的時(shí)候关筒,遍歷的titlemap存在問(wèn)題溶握,詳見(jiàn)issues
小結(jié)
總的來(lái)說(shuō),easypoi功能還是很強(qiáng)大蒸播,使用上也簡(jiǎn)單,主要是把數(shù)據(jù)結(jié)構(gòu)想清楚萍肆,之后的導(dǎo)入導(dǎo)出邏輯就很簡(jiǎn)單了袍榆,本文example 在GitHub上地址:easypoi-demo