使用Apache?POI和SpringBoot實現(xiàn)Excel文件上傳和解析功能
在現(xiàn)代企業(yè)應(yīng)用開發(fā)中，數(shù)據(jù)的導(dǎo)入和導(dǎo)出是一項常見且重要的功能需求。Excel 作為一種廣泛使用的電子表格工具，因其直觀、易用的特性，常常被用來存儲和展示數(shù)據(jù)。因此，實現(xiàn) Excel 文件的上傳和解析功能，能夠方便地將外部數(shù)據(jù)導(dǎo)入到系統(tǒng)中，對于提高工作效率、實現(xiàn)數(shù)據(jù)共享具有重要意義。
一、技術(shù)選型與環(huán)境搭建
Apache POI 庫簡介
Apache POI 是一個開源的 Java 庫，用于處理 Microsoft Office 文檔。它提供了對 Excel 文件的讀寫支持，能夠處理 Excel 97-2003（.xls）和 Excel 2007+（.xlsx）兩種格式。POI 通過提供豐富的 API，使得開發(fā)者能夠方便地操作 Excel 文件中的單元格、行、列、工作表等元素，實現(xiàn)數(shù)據(jù)的讀取、寫入、格式化等功能。
Spring Boot 框架簡介
Spring Boot 是一個基于 Spring 框架的項目，旨在簡化 Spring 應(yīng)用的開發(fā)過程。它通過提供一系列的“Starters”依賴管理和自動配置功能，使得開發(fā)者能夠快速搭建起一個 Spring 應(yīng)用。Spring Boot 還內(nèi)置了 Tomcat 容器，無需部署 WAR 包，可以直接運行 Spring 應(yīng)用，極大地簡化了部署流程。此外，Spring Boot 還支持 RESTful API 的開發(fā)，通過注解的方式能夠輕松實現(xiàn)數(shù)據(jù)的接收和響應(yīng)。
環(huán)境搭建
開發(fā)工具：推薦使用 IntelliJ IDEA 或 Eclipse 等主流的 Java 開發(fā)工具，它們提供了豐富的插件支持和便捷的代碼提示功能，有助于提高開發(fā)效率。
JDK 版本：需要安裝 JDK 1.8 或更高版本，因為 Spring Boot 和 Apache POI 都依賴于 Java 8 及以上版本的新特性。
依賴管理：使用 Maven 或 Gradle 作為項目的依賴管理工具。在項目的pom.xml文件中引入 Apache POI 和 Spring Boot 相關(guān)的依賴。
<!-- Apache POI依賴 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.3</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.3</version>
</dependency>
<!-- Spring Boot Web依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>2.7.5</version>
</dependency>
<!-- Spring Boot文件上傳依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
<version>2.7.5</version>
</dependency>項目結(jié)構(gòu)：創(chuàng)建一個 Spring Boot 項目，并在項目中創(chuàng)建相應(yīng)的包結(jié)構(gòu)，如controller、service、model等，用于存放控制器、服務(wù)層代碼和數(shù)據(jù)模型等。
二、Excel 文件上傳接口實現(xiàn)
創(chuàng)建控制器
在 Spring Boot 項目中創(chuàng)建一個控制器類ExcelController，用于處理 Excel 文件的上傳請求。使用@RestController注解來定義控制器，表示該控制器中的所有方法都會返回 JSON 格式的數(shù)據(jù)。
@RestController
public class ExcelController {
// 文件上傳接口
@PostMapping("/upload")
public Result upload(@RequestParam("file") MultipartFile file) {
// 文件上傳處理邏輯
}
}
在upload方法中，使用@PostMapping注解來指定請求的 URL 路徑為/upload，并使用@RequestParam注解來接收前端上傳的文件。MultipartFile是 Spring 提供的一個接口，用于表示上傳的文件。
文件讀取與解析
在upload方法中，首先獲取上傳文件的輸入流，然后使用 Apache POI 庫來讀取和解析 Excel 文件。
try (InputStream inputStream = file.getInputStream()) {
Workbook workbook = WorkbookFactory.create(inputStream); // 使用WorkbookFactory來自動處理不同格式的Excel文件
Sheet sheet = workbook.getSheetAt(0); // 獲取第一個工作表
// 解析Excel數(shù)據(jù)的邏輯
}
WorkbookFactory.create(inputStream)方法會根據(jù)輸入流中的文件格式自動創(chuàng)建相應(yīng)的Workbook對象，無論是.xls還是.xlsx格式的 Excel 文件都能被正確處理。workbook.getSheetAt(0)方法用于獲取 Excel 文件中的第一個工作表。
數(shù)據(jù)解析與存儲
在獲取到工作表后，可以遍歷工作表中的每一行和每一列，將數(shù)據(jù)解析出來并存儲到合適的數(shù)據(jù)結(jié)構(gòu)中。通常情況下，第一行是列名，從第二行開始是實際的數(shù)據(jù)。
List<Map<String, String>> data = new ArrayList<>();
Row headerRow = sheet.getRow(0); // 獲取第一行作為列名
String[] headers = new String[3];
for (int i = 0; i < 3; i++) {
headers[i] = headerRow.getCell(i).getStringCellValue();
}
for (int i = 1; i <= sheet.getLastRowNum(); i++) {
Row row = sheet.getRow(i);
Map<String, String> rowData = new HashMap<>();
for (int j = 0; j < 3; j++) {
Cell cell = row.getCell(j);
String cellValue = "";
if (cell != null) {
switch (cell.getCellType()) {
case STRING:
cellValue = cell.getStringCellValue();
break;
case NUMERIC:
if (DateUtil.isCellDateFormatted(cell)) {
cellValue = cell.getDateCellValue().toString();
} else {
cellValue = String.format("%.0f", cell.getNumericCellValue());
}
break;
case BOOLEAN:
cellValue = String.valueOf(cell.getBooleanCellValue());
break;
case FORMULA:
cellValue = cell.getCellFormula();
break;
default:
cellValue = "";
}
}
rowData.put(headers[j], cellValue);
}
data.add(rowData);
}在上述代碼中，首先讀取第一行的列名，并存儲到headers數(shù)組中。然后從第二行開始遍歷每一行的數(shù)據(jù)，對于每個單元格，根據(jù)其類型（字符串、數(shù)值、日期、布爾值、公式等）進行相應(yīng)的處理，并將解析出的數(shù)據(jù)存儲到rowData這個Map中，其中鍵為列名，值為單元格的值。最后將每一行的數(shù)據(jù)rowData添加到data這個列表中。
數(shù)據(jù)處理與響應(yīng)
在解析完 Excel 文件中的數(shù)據(jù)后，可以根據(jù)實際需求對數(shù)據(jù)進行進一步的處理，例如存儲到數(shù)據(jù)庫中。在本示例中，僅簡單地將解析出的數(shù)據(jù)打印到控制臺，并返回一個結(jié)果對象表示操作是否成功。
System.out.println("讀取到的數(shù)據(jù): " + data);
return Result.ok("導(dǎo)入excel完成");
如果在處理過程中發(fā)生異常，則捕獲異常并返回錯誤結(jié)果。
} catch (Exception e) {
e.printStackTrace();
return Result.error("導(dǎo)入excel失敗");
}
三、前端頁面實現(xiàn)
創(chuàng)建 HTML 頁面
在 Spring Boot 項目的src/main/resources/static目錄下創(chuàng)建一個 HTML 頁面，用于實現(xiàn)文件上傳的功能。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Excel文件上傳</title>
</head>
<body>
<h1>Excel文件上傳</h1>
<form id="uploadForm" enctype="multipart/form-data">
<input type="file" id="file" name="file" accept=".xls,.xlsx" />
<button type="button" onclick="uploadFile()">上傳</button>
</form>
<script>
function uploadFile() {
var formData = new FormData(document.getElementById("uploadForm"));
fetch("/upload", {
method: "POST",
body: formData,
})
.then((response) => response.json())
.then((data) => {
if (data.status === "ok") {
alert("文件上傳成功！");
} else {
alert("文件上傳失?。? + data.message);
}
})
.catch((error) => {
console.error("上傳失?。?, error);
});
}
</script>
</body>
</html>在 HTML 頁面中，創(chuàng)建一個表單uploadForm，其中包含一個文件輸入框file和一個上傳按鈕。文件輸入框的accept屬性設(shè)置為.xls,.xlsx，表示只允許選擇 Excel 文件。點擊上傳按鈕時，會調(diào)用uploadFile函數(shù)，該函數(shù)使用 JavaScript 的FormData對象來構(gòu)建表單數(shù)據(jù)，并通過fetch API 發(fā)送 POST 請求到后端的/upload接口。
以上就是使用Apache POI和SpringBoot實現(xiàn)Excel文件上傳和解析功能的詳細內(nèi)容，更多關(guān)于SpringBoot Apache POI上傳和解析Excel的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
idea插件篇之java內(nèi)存分析工具(JProfiler)的使用
這篇文章主要介紹了idea插件篇之java內(nèi)存分析工具(JProfiler)，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-09-09
這篇文章主要介紹了Java如何將若干時間區(qū)間進行合并的方法步驟，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-02-02
這篇文章主要為大家分享了最有價值的三道關(guān)于Nginx的面試題，涵蓋內(nèi)容全面，包括數(shù)據(jù)結(jié)構(gòu)和算法相關(guān)的題目、經(jīng)典面試編程題等，感興趣的小伙伴們可以參考一下2021-08-08
這篇文章主要為大家詳細介紹了Java中文件管理操作的一些知識點和實現(xiàn)方法，文中的示例代碼講解詳細，感興趣的小伙伴可以跟隨小編一起了解一下2022-09-09
這篇文章主要幫助大家輕松掌握java組合模式,具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-09-09
java 重載（overload）與重寫(override)詳解及實例
這篇文章主要介紹了java 重載（overload）與重寫(override)詳解及實例的相關(guān)資料,并附實例代碼，需要的朋友可以參考下2016-10-10
AQS 同步隊列是很多的 Java 線程安全對象的實現(xiàn)，例如 ReentrantLock, Semaphore, CountDownLatch, ReentrantReadWriteLock 等等，本文就介紹了Java?AQS?線程安全同步隊列的實現(xiàn)，感興趣的可以了解一下2023-08-08
java中for循環(huán)執(zhí)行的順序圖文詳析
關(guān)于java的for循環(huán)想必大家非常熟悉,它是java常用的語句之一,這篇文章主要給大家介紹了關(guān)于java中for循環(huán)執(zhí)行順序的相關(guān)資料,需要的朋友可以參考下2021-06-06
詳解快速排序算法中的區(qū)間劃分法及Java實現(xiàn)示例
這篇文章主要介紹了詳解快速排序算法中的區(qū)間劃分法及Java實現(xiàn)示例,文中分別介紹了快排時兩種區(qū)間劃分的思路,需要的朋友可以參考下2016-04-04
java線程池:獲取運行線程數(shù)并控制線程啟動速度的方法
下面小編就為大家?guī)硪黄猨ava線程池:獲取運行線程數(shù)并控制線程啟動速度的方法。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-05-05