干掉EasyExcel！FastExcel初體驗
我們知道 EasyExcel 在作者從阿里離職之后就停止維護了，但在前兩周 EasyExcel 原作者推出了他的升級版框架 FastExcel。以下是 FastExcel 的上手實戰(zhàn)過程，帶大家一起提供新框架的魅力。
FastExcel 是由原 EasyExcel 作者創(chuàng)建的最新作品，作者在 2023 年從阿里離職后，隨著阿里宣布停止更新 EasyExcel，所以他就決定繼續(xù)維護和升級這個項目。在重新開始時，作者為它起名為 FastExcel，以突出這個框架在處理 Excel 文件時的高性能表現(xiàn)，而不僅僅是簡單易用。
FastExcel 仍是免費的開源框架，它具備以下特點：
- 完全兼容原 EasyExcel 的所有功能和特性，這使得用戶可以無縫過渡。
- 從 EasyExcel 遷移到 FastExcel 只需簡單地更換包名和 Maven 依賴即可完成升級。
- 在功能上，比 EasyExcel 提供更多創(chuàng)新和改進。
- FastExcel 1.0.0 版本新增了讀取 Excel 指定行數(shù)和將 Excel 轉(zhuǎn)換為 PDF 的功能。
FastExcel 具體使用如下。
FastExcel 使用
1.添加依賴
<dependency>
<groupId>cn.idev.excel</groupId>
<artifactId>fastexcel</artifactId>
<version>1.0.0</version> <!-- 請確保使用最新版本 -->
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>2.創(chuàng)建實體類和監(jiān)聽器
（1）創(chuàng)建實體類
import cn.idev.excel.annotation.ExcelProperty;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;
@Setter
@Getter
@ToString
public class User {
@ExcelProperty("編號")
private Integer id;
@ExcelProperty("名字")
private String name;
@ExcelProperty("年齡")
private Integer age;
}（2）創(chuàng)建事件監(jiān)聽器
FastExcel 是依靠事件監(jiān)聽器實現(xiàn) Excel 逐行讀取文件的，如果沒有這種逐行處理的機制和數(shù)據(jù)監(jiān)聽器，在處理大文件時可能會導致內(nèi)存溢出。而事件監(jiān)聽器使得數(shù)據(jù)可以邊讀取邊處理，例如，可以直接將數(shù)據(jù)寫入數(shù)據(jù)庫或者進行其他業(yè)務邏輯處理，避免了大量數(shù)據(jù)在內(nèi)存中的堆積。
import cn.idev.excel.context.AnalysisContext;
import cn.idev.excel.event.AnalysisEventListener;
import java.util.ArrayList;
import java.util.List;
public class BaseExcelListener<T> extends AnalysisEventListener<T> {
// 用于存儲讀取到的Excel數(shù)據(jù)對象列表
private List<T> dataList = new ArrayList<>();
@Override
public void invoke(T t, AnalysisContext analysisContext) {
// 每讀取一行數(shù)據(jù)，就將其添加到dataList中
dataList.add(t);
}
@Override
public void doAfterAllAnalysed(AnalysisContext analysisContext) {
// 當所有數(shù)據(jù)讀取完成后，可以在這里進行一些后續(xù)操作，如打印讀取到的數(shù)據(jù)數(shù)量
System.out.println("讀取完成，共讀取了 " + dataList.size() + " 條數(shù)據(jù)");
}
// 提供一個方法用于獲取存儲數(shù)據(jù)的列表
public List<T> getDataList() {
return dataList;
}
}3.實現(xiàn)寫入和讀取功能
（1）Excel寫入功能
// Excel寫入功能
@GetMapping("/download")
public void download(HttpServletResponse response) throws IOException {
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setCharacterEncoding("utf-8");
String fileName = URLEncoder.encode("test", "UTF-8");
response.setHeader("Content-disposition",
"attachment;filename*=utf-8''" + fileName + ".xlsx");
// 寫入數(shù)據(jù)
FastExcel.write(response.getOutputStream(), User.class)
.sheet("模板")
.doWrite(buildData());
}
// 創(chuàng)建測試數(shù)據(jù)
private List<User> buildData() {
// 創(chuàng)建 User 測試數(shù)據(jù)
User user1 = new User();
user1.setId(1);
user1.setName("張三");
user1.setAge(18);
User user2 = new User();
user2.setId(2);
user2.setName("李四");
user2.setAge(19);
return List.of(user1, user2);
}以上代碼執(zhí)行效果如下：
（2）Excel讀取功能
// Excel讀取功能
@PostMapping("/upload")
public ResponseEntity<String> upload(@RequestParam("file") MultipartFile file) {
if (file.isEmpty()) {
return ResponseEntity.badRequest().body("請選擇一個文件上傳！");
}
try {
BaseExcelListener<User> baseExcelListener = new BaseExcelListener<>();
FastExcel.read(file.getInputStream(), User.class,
baseExcelListener).sheet().doRead();
// 得到讀取數(shù)據(jù)
List<User> dataList = baseExcelListener.getDataList();
System.out.println(dataList);
return ResponseEntity.ok("文件上傳并處理成功！");
} catch (IOException e) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("文件處理失敗！");
}
}以上代碼執(zhí)行效果如下：
EasyExcel 如何升級到FastExcel
1.修改依賴
將 EasyExcel 的依賴替換為 FastExcel 的依賴，如下：
<!-- easyexcel 依賴 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>xxxx</version>
</dependency>依賴替換為：
<dependency>
<groupId>cn.idev.excel</groupId>
<artifactId>fastexcel</artifactId>
<version>1.0.0</version>
</dependency>2.修改代碼
將 EasyExcel 的包名替換為 FastExcel 的包名，如下：
// 將 easyexcel 的包名替換為 FastExcel 的包名
import com.alibaba.excel.**;替換為：
import cn.idev.excel.**;Excel轉(zhuǎn)換為PDF
FastExcel 支持將 Excel 文件轉(zhuǎn)換為 PDF 文件，F(xiàn)astExcel 將 Excel 轉(zhuǎn)為Pdf 底層依賴于 Apache POI 和 itext-pdf。受限于 itext-pdf 的許可證，請確保您的使用符合 itext-pdf 的許可證，后續(xù) FastExcel 將支持更多的 PDF 轉(zhuǎn)換功能替換 itext-pdf，實現(xiàn)代碼如下：
FastExcel.convertToPdf(new File("excelFile"),new File("pdfFile"),null,null);小結(jié)
FastExcel 依然是原來的那個 EasyExcel，但又不完全是 EasyExcel，希望 FastExcel 越做越好。各位小伙伴們，一起體驗起來吧。
