引用easyExcel作者的一段話:
Java解析、生成Excel比較有名的框架有Apache poi、jxl。但他們都存在一個嚴重的問題就是非常的耗內存,poi有一套SAX模式的API可以一定程度的解決一些內存溢出的問題,但POI還是有一些缺陷,比如07版Excel解壓縮以及解壓后存儲都是在內存中完成的,內存消耗依然很大。easyexcel重寫了poi對07版Excel的解析,能夠原本一個3M的excel用POI sax依然需要100M左右內存降低到KB級別,并且再大的excel不會出現內存溢出,03版依賴POI的sax模式。在上層做了模型轉換的封裝,讓使用者更加簡單方便
一、導包
<dependency>
<groupId>com.alibaba</groupI>
<artifactId>easyexcel</artifactId>
<version>1.1.2-beta5</version>
</dependency>
二、常見名詞解釋
名詞 | 解釋 |
---|---|
workbook | 工作簿,03版xls,07版本xlsx |
sheet | 一個工作區間,03版最多65535行 07版最多1048576行 |
ROW | 一行 |
column | 一列 |
cell | 單元格 |
range | 區域 |
comment | 單元格內容 |
Font | 字體樣式 |
headLineMun | 表頭占幾行 |
table | 表格 |
三、寫excel
寫excel表格主要用到ExcelWriter
類
構造函數說明:
public ExcelWriter(OutputStream outputStream, ExcelTypeEnum typeEnum,boolean needHead) {
this(outputStream, typeEnum, needHead);
}
參數 | 說明 |
---|---|
outputStream | 文件/響應輸出流 |
typeEnum | 文件類型,用于區分excel03和07版本 |
needHead | 布爾類型,是否寫入表頭,可不填,默認為ture |
將數據寫入本地文件(無模板)
try (OutputStream out = new FileOutputStream("noHeader.xlsx");){
//獲取ExcelWriter
ExcelWriter writer = EasyExcelFactory.getWriter(out);
Sheet sheet = new Sheet(1, 0);
sheet.setSheetName("第一個sheet");
//List<List<String>> 寫入數據的形式為二維數組
List<List<String>> data = new ArrayList<>();
for (int i = 0; i < 10; i++) {
List<String> item = new ArrayList<>();
item.add("item0" + i);
item.add("item1" + i);
item.add("item2" + i);
data.add(item);
}
//將數據一次寫入sheet
writer.write0(data, sheet);
writer.finish();
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
結果如下圖:
圖片
將數據寫入文件(有模板)
編寫模板類
/**模板類需要繼承BaseRowModel
* @author by Crux
* @Date 2019/8/6 9:52
*/
@Data
public class Model extends BaseRowModel {
@ExcelProperty(value ="test0",index = 0)
private String name;
@ExcelProperty(value ="test1",index = 1)
private String price;
}
按模板寫入數據(表頭)
public void writeWithHeader() {
try (OutputStream out = new FileOutputStream("noHeader.xlsx");) {
ExcelWriter writer = EasyExcelFactory.getWriter(out);
Sheet sheet = new Sheet(1, 3, Model.class);
sheet.setSheetName("第一個sheet");
List<List<String>> data = new ArrayList<>();
for (int i = 0; i < 3; i++) {
List<String> item = new ArrayList<>();
item.add("item0" + i);
item.add("item1" + i);
data.add(item);
}
sheet.setStartRow(0);
writer.write0(data, sheet);
writer.finish();
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
@ExcelProperty value參數為表頭 index表頭的順序(不重復,不覆蓋)
image
四、讀Excel
寫excel表格主要用到ExcelReader
類
帶模板讀取
模板類使用上文中Model.class
public void readByModel() {
try(FileInputStream fileInputStream = new FileInputStream("header.xlsx")) {
ReadEventListener readEventListener = new ReadEventListener<>();
//小于1000行采取一次性讀取
//List<Object> data = EasyExcelFactory.read(inputStream, new Sheet(1, 0));
//大于1000行控制一次性讀取大小
EasyExcelFactory.readBySax(fileInputStream, new Sheet(1, 1, Model.class), readEventListener);
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
讀取sheet
public void read() {
try( FileInputStream fileInputStream = new FileInputStream("header.xlsx")) {
ExcelListener excelListener = new ExcelListener();
ExcelReader excelReader = EasyExcelFactory.getReader(fileInputStream, excelListener);
//獲取sheeet列表
List<Sheet> sheets = excelReader.getSheets();
for (Sheet sheet : sheets) {
if (sheet.getSheetNo() == 1) {
excelReader.read(sheet);
} else if (sheet.getSheetNo() == 2) {
//同一表頭 不再統計
sheet.setHeadLineMun(1);
sheet.setClazz(TotalAmont.class);
excelReader.read(sheet);
} else if (sheet.getSheetNo() == 3) {
sheet.setHeadLineMun(1);
sheet.setClazz(TotalAmont.class);
excelReader.read(sheet);
}
}
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
五、提供web下載
@RequestMapping(value = "/export",method = RequestMethod.GET)
public void getExcel(@RequestParam("file_name")String fileName, HttpServletRequest request, HttpServletResponse response){
try ( ServletOutputStream out = response.getOutputStream()){
response.setContentType("multipart/form-data");
response.setCharacterEncoding("utf-8");
//設置返回頭為附件形式,并提供下載文件名
response.setHeader("Content-disposition","attachment;filename="+URLEncoder.encode(fileName,"utf-8")+".xlsx");
ExcelWriter writer = new ExcelWriter(out,ExcelTypeEnum.XLSX,true);
//提供excel表頭模板
Sheet sheet = new Sheet(1,0,TotalAmont.class);
sheet.setSheetName("第一個");
//寫入數據,數據格式為List<List<String>>
writer.write0(null,sheet);
writer.write1(null,new Sheet(1,1,Model.class));
writer.finish();
out.flush();
} catch (IOException e) {
e.printStackTrace();
}
}
六、注意事項
- @ExcelProperty注解 不支持localDate
- model和excel表格的映射實際上是字段@ExcelProperty參數index的一一映射
- ExcelReader 讀excel類,所有讀操作來源于此類
- ExcelWriter 寫excel類,所有寫操作來源于此類
- EasyExcelFactory 可以通過此類去選擇讀寫方式
- 寫excel,在同一sheet中寫入兩次數據,后寫入者無效
- 該組件主要優化excel導入導出功能,其他excel操作(如追加,求合等)需自行實現
七、組件使用常規操作(流程)
excel 導入
image.png
easyExcel按行讀取時,每讀一行,都會出發監聽類中的invoke方法,需要在此處進行數據解析和處理(存入數據庫)
excel 導出
image.png
out.flush() 是把緩沖區的內容強制的寫出