Java基于POI實(shí)現(xiàn)Excel文件的導(dǎo)入導(dǎo)出
更新時(shí)間：2026年02月12日 08:29:58 作者：J_liaty
Apache POI是Apache軟件基金會(huì)提供的開源Java API,用于處理Microsoft Office格式文件,比EasyExcel、Hutool等封裝框架,原始POI提供了最底層的控制能力,適合需要高度定制化的場景,本文給大家介紹了Java基于POI實(shí)現(xiàn)Excel文件的導(dǎo)入導(dǎo)出,需要的朋友可以參考下
1. 引言
Apache POI（Poor Obfuscation Implementation）是Apache軟件基金會(huì)提供的開源Java API，用于處理Microsoft Office格式文件。其中HSSF處理Excel 97-2003（.xls）格式，XSSF處理Excel 2007+（.xlsx）格式，SXSSF則用于處理大數(shù)據(jù)量的流式寫入。
Excel操作在企業(yè)開發(fā)中的核心應(yīng)用場景：
- 數(shù)據(jù)報(bào)表導(dǎo)出（銷售數(shù)據(jù)、財(cái)務(wù)報(bào)表、用戶列表等）
- 批量數(shù)據(jù)導(dǎo)入（商品信息、員工檔案、訂單數(shù)據(jù)等）
- 數(shù)據(jù)統(tǒng)計(jì)分析后的結(jié)果呈現(xiàn)
- 系統(tǒng)間的數(shù)據(jù)交換與備份
相比EasyExcel、Hutool等封裝框架，原始POI提供了最底層的控制能力，適合需要高度定制化的場景。
2. 環(huán)境準(zhǔn)備
2.1 Maven依賴配置
<dependencies>
<!-- POI核心依賴 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.3</version>
</dependency>
<!-- 處理.xlsx格式 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.3</version>
</dependency>
<!-- 可選：處理日期工具 -->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-collections4</artifactId>
<version>4.4</version>
</dependency>
</dependencies>
版本說明：
- 建議使用5.x版本，4.x版本存在內(nèi)存泄漏問題
- 如需支持.xls格式，poi依賴必不可少
- poi-ooxml包含.xmlbeans和ooxml-security等傳遞依賴
2.2 環(huán)境要求
| 組件 | 最低版本 | 推薦版本 |
|---|---|---|
| JDK | 1.8 | 11+ |
| POI | 3.17 | 5.2.3+ |
| Maven | 3.6+ | 3.8+ |
3. Excel導(dǎo)出實(shí)現(xiàn)
3.1 創(chuàng)建工作簿結(jié)構(gòu)
/**
* 創(chuàng)建Excel工作簿基礎(chǔ)結(jié)構(gòu)
*/
public static Workbook createWorkbook() {
// 創(chuàng)建.xlsx格式工作簿
Workbook workbook = new XSSFWorkbook();
return workbook;
}
/**
* 創(chuàng)建工作表并設(shè)置標(biāo)題
*/
public static Sheet createSheet(Workbook workbook, String sheetName) {
Sheet sheet = workbook.createSheet(sheetName);
// 設(shè)置列寬（以字符寬度為單位，256為一個(gè)字符寬度）
sheet.setColumnWidth(0, 20 * 256); // A列寬度為20個(gè)字符
sheet.setColumnWidth(1, 15 * 256); // B列寬度為15個(gè)字符
return sheet;
}
/**
* 創(chuàng)建標(biāo)題行
*/
public static Row createHeaderRow(Sheet sheet, String[] headers) {
Row row = sheet.createRow(0);
for (int i = 0; i < headers.length; i++) {
Cell cell = row.createCell(i);
cell.setCellValue(headers[i]);
}
return row;
}
3.2 單元格樣式設(shè)置
/**
* 創(chuàng)建標(biāo)題樣式（居中、加粗、背景色）
*/
public static CellStyle createHeaderStyle(Workbook workbook) {
CellStyle style = workbook.createCellStyle();
// 水平居中
style.setAlignment(HorizontalAlignment.CENTER);
// 垂直居中
style.setVerticalAlignment(VerticalAlignment.CENTER);
// 設(shè)置字體
Font font = workbook.createFont();
font.setFontName("微軟雅黑");
font.setFontHeightInPoints((short) 12);
font.setBold(true);
style.setFont(font);
// 設(shè)置背景色（淡藍(lán)色）
style.setFillForegroundColor(IndexedColors.PALE_BLUE.getIndex());
style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
// 設(shè)置邊框
style.setBorderTop(BorderStyle.THIN);
style.setBorderBottom(BorderStyle.THIN);
style.setBorderLeft(BorderStyle.THIN);
style.setBorderRight(BorderStyle.THIN);
return style;
}
/**
* 創(chuàng)建數(shù)據(jù)樣式（左對(duì)齊、自動(dòng)換行）
*/
public static CellStyle createDataStyle(Workbook workbook) {
CellStyle style = workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.LEFT);
style.setVerticalAlignment(VerticalAlignment.CENTER);
style.setWrapText(true); // 自動(dòng)換行
// 設(shè)置邊框
style.setBorderTop(BorderStyle.THIN);
style.setBorderBottom(BorderStyle.THIN);
style.setBorderLeft(BorderStyle.THIN);
style.setBorderRight(BorderStyle.THIN);
return style;
}
/**
* 創(chuàng)建數(shù)字格式樣式（保留兩位小數(shù)）
*/
public static CellStyle createNumberStyle(Workbook workbook) {
CellStyle style = workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.RIGHT);
// 創(chuàng)建數(shù)字格式
DataFormat format = workbook.createDataFormat();
style.setDataFormat(format.getFormat("#,##0.00"));
style.setBorderTop(BorderStyle.THIN);
style.setBorderBottom(BorderStyle.THIN);
style.setBorderLeft(BorderStyle.THIN);
style.setBorderRight(BorderStyle.THIN);
return style;
}
3.3 處理不同數(shù)據(jù)類型
/**
* 設(shè)置單元格值（支持多種數(shù)據(jù)類型）
*/
public static void setCellValue(Cell cell, Object value) {
if (value == null) {
cell.setCellValue("");
return;
}
if (value instanceof String) {
cell.setCellValue((String) value);
} else if (value instanceof Number) {
cell.setCellValue(((Number) value).doubleValue());
} else if (value instanceof Date) {
cell.setCellValue((Date) value);
} else if (value instanceof Boolean) {
cell.setCellValue((Boolean) value);
} else if (value instanceof Calendar) {
cell.setCellValue((Calendar) value);
} else {
cell.setCellValue(value.toString());
}
}
/**
* 設(shè)置日期格式單元格
*/
public static void setDateCellValue(Cell cell, Date date, Workbook workbook) {
CellStyle dateStyle = workbook.createCellStyle();
DataFormat format = workbook.createDataFormat();
dateStyle.setDataFormat(format.getFormat("yyyy年mm月dd日"));
cell.setCellStyle(dateStyle);
cell.setCellValue(date);
}
3.4 響應(yīng)輸出流處理
/**
* 導(dǎo)出Excel到HTTP響應(yīng)
* @param response HttpServletResponse對(duì)象
* @param workbook Excel工作簿
* @param fileName 導(dǎo)出文件名
*/
public static void exportExcel(HttpServletResponse response,
Workbook workbook,
String fileName) throws IOException {
// 設(shè)置響應(yīng)頭
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setCharacterEncoding("UTF-8");
// 處理文件名編碼（防止中文亂碼）
String encodedFileName = URLEncoder.encode(fileName, "UTF-8")
.replaceAll("\\+", "%20");
response.setHeader("Content-Disposition",
"attachment;filename*=UTF-8''" + encodedFileName + ".xlsx");
// 寫入輸出流
try (OutputStream out = response.getOutputStream()) {
workbook.write(out);
out.flush();
} finally {
// 關(guān)閉工作簿釋放資源
if (workbook != null) {
workbook.close();
}
}
}
4. Excel導(dǎo)入實(shí)現(xiàn)
4.1 文件上傳與輸入流處理
/**
* 從MultipartFile讀取Excel文件
* @param file Spring MVC上傳的文件
* @return Excel工作簿對(duì)象
*/
public static Workbook readExcel(MultipartFile file) throws IOException {
String fileName = file.getOriginalFilename();
InputStream inputStream = file.getInputStream();
// 根據(jù)文件后綴判斷版本
if (fileName.endsWith(".xlsx")) {
return new XSSFWorkbook(inputStream);
} else if (fileName.endsWith(".xls")) {
return new HSSFWorkbook(inputStream);
} else {
throw new IllegalArgumentException("不支持的文件格式，僅支持.xlsx和.xls");
}
}
4.2 工作表讀取與數(shù)據(jù)解析
/**
* 讀取工作表數(shù)據(jù)（默認(rèn)讀取第一個(gè)工作表）
*/
public static List<List<String>> readSheetData(Sheet sheet) {
List<List<String>> dataList = new ArrayList<>();
// 從第一行開始讀?。ㄌ^標(biāo)題行可從1開始）
for (int rowIndex = 0; rowIndex <= sheet.getLastRowNum(); rowIndex++) {
Row row = sheet.getRow(rowIndex);
if (row == null) continue;
List<String> rowData = new ArrayList<>();
// 遍歷該行的所有單元格
for (int cellIndex = 0; cellIndex < row.getLastCellNum(); cellIndex++) {
Cell cell = row.getCell(cellIndex);
String cellValue = getCellValueAsString(cell);
rowData.add(cellValue);
}
dataList.add(rowData);
}
return dataList;
}
4.3 單元格數(shù)據(jù)類型轉(zhuǎn)換
/**
* 獲取單元格字符串值（處理各種數(shù)據(jù)類型）
*/
public static String getCellValueAsString(Cell cell) {
if (cell == null) {
return "";
}
// 根據(jù)單元格類型進(jìn)行轉(zhuǎn)換
switch (cell.getCellType()) {
case STRING:
return cell.getStringCellValue().trim();
case NUMERIC:
// 判斷是否為日期類型
if (DateUtil.isCellDateFormatted(cell)) {
Date date = cell.getDateCellValue();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
return sdf.format(date);
} else {
// 避免科學(xué)計(jì)數(shù)法和精度丟失
DecimalFormat df = new DecimalFormat("0");
return df.format(cell.getNumericCellValue());
}
case BOOLEAN:
return String.valueOf(cell.getBooleanCellValue());
case FORMULA:
// 處理公式單元格
try {
return String.valueOf(cell.getNumericCellValue());
} catch (IllegalStateException e) {
return cell.getStringCellValue();
}
case BLANK:
return "";
default:
return "";
}
}
/**
* 獲取指定類型的單元格值
*/
public static <T> T getCellValue(Cell cell, Class<T> clazz) {
if (cell == null) return null;
if (clazz == String.class) {
return clazz.cast(getCellValueAsString(cell));
} else if (clazz == Integer.class || clazz == int.class) {
return clazz.cast((int) cell.getNumericCellValue());
} else if (clazz == Long.class || clazz == long.class) {
return clazz.cast((long) cell.getNumericCellValue());
} else if (clazz == Double.class || clazz == double.class) {
return clazz.cast(cell.getNumericCellValue());
} else if (clazz == Boolean.class || clazz == boolean.class) {
return clazz.cast(cell.getBooleanCellValue());
} else if (clazz == Date.class) {
return clazz.cast(cell.getDateCellValue());
}
return null;
}
4.4 異常處理與數(shù)據(jù)驗(yàn)證
/**
* 導(dǎo)入時(shí)進(jìn)行數(shù)據(jù)驗(yàn)證
*/
public static class ValidationResult {
private boolean valid;
private String errorMessage;
private int rowIndex;
private int columnIndex;
// 構(gòu)造方法、getter和setter省略...
}
/**
* 驗(yàn)證導(dǎo)入數(shù)據(jù)
*/
public static ValidationResult validateCell(Cell cell, String fieldName,
boolean required,
int max_length) {
ValidationResult result = new ValidationResult();
result.setValid(true);
String value = getCellValueAsString(cell);
// 必填驗(yàn)證
if (required && (value == null || value.isEmpty())) {
result.setValid(false);
result.setErrorMessage(fieldName + "不能為空");
return result;
}
// 長度驗(yàn)證
if (max_length > 0 && value.length() > max_length) {
result.setValid(false);
result.setErrorMessage(fieldName + "長度不能超過" + max_length + "個(gè)字符");
return result;
}
// 其他業(yè)務(wù)驗(yàn)證邏輯...
return result;
}
/**
* 導(dǎo)入Excel并驗(yàn)證數(shù)據(jù)
*/
public static List<ValidationResult> importExcelWithValidation(
MultipartFile file,
boolean skipHeader) throws IOException {
Workbook workbook = readExcel(file);
Sheet sheet = workbook.getSheetAt(0);
List<ValidationResult> errors = new ArrayList<>();
int startRow = skipHeader ? 1 : 0;
for (int i = startRow; i <= sheet.getLastRowNum(); i++) {
Row row = sheet.getRow(i);
if (row == null) continue;
// 示例：驗(yàn)證第一列（姓名）
Cell nameCell = row.getCell(0);
ValidationResult result = validateCell(nameCell, "姓名", true, 50);
if (!result.isValid()) {
result.setRowIndex(i + 1);
result.setColumnIndex(1);
errors.add(result);
}
// 驗(yàn)證第二列（年齡）
Cell ageCell = row.getCell(1);
if (ageCell != null) {
try {
int age = (int) ageCell.getNumericCellValue();
if (age < 0 || age > 150) {
ValidationResult ageError = new ValidationResult();
ageError.setValid(false);
ageError.setErrorMessage("年齡必須在0-150之間");
ageError.setRowIndex(i + 1);
ageError.setColumnIndex(2);
errors.add(ageError);
}
} catch (Exception e) {
ValidationResult ageError = new ValidationResult();
ageError.setValid(false);
ageError.setErrorMessage("年齡必須是數(shù)字");
ageError.setRowIndex(i + 1);
ageError.setColumnIndex(2);
errors.add(ageError);
}
}
}
workbook.close();
return errors;
}
5. 完整示例代碼
5.1 Excel導(dǎo)出工具類
package com.example.excel.util;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.util.Date;
import java.util.List;
/**
* Excel導(dǎo)出工具類
*/
public class ExcelExportUtil {
/**
* 導(dǎo)出數(shù)據(jù)到Excel
* @param headers 表頭數(shù)組
* @param dataList 數(shù)據(jù)列表（每行數(shù)據(jù)為List<Object>）
* @param fileName 文件名
* @param sheetName 工作表名
*/
public static void exportData(HttpServletResponse response,
String[] headers,
List<List<Object>> dataList,
String fileName,
String sheetName) throws IOException {
// 創(chuàng)建工作簿
Workbook workbook = new XSSFWorkbook();
Sheet sheet = workbook.createSheet(sheetName);
// 創(chuàng)建樣式
CellStyle headerStyle = createHeaderStyle(workbook);
CellStyle dataStyle = createDataStyle(workbook);
CellStyle numberStyle = createNumberStyle(workbook);
// 創(chuàng)建標(biāo)題行
Row headerRow = sheet.createRow(0);
for (int i = 0; i < headers.length; i++) {
Cell cell = headerRow.createCell(i);
cell.setCellValue(headers[i]);
cell.setCellStyle(headerStyle);
}
// 填充數(shù)據(jù)
for (int i = 0; i < dataList.size(); i++) {
Row row = sheet.createRow(i + 1);
List<Object> rowData = dataList.get(i);
for (int j = 0; j < rowData.size(); j++) {
Cell cell = row.createCell(j);
Object value = rowData.get(j);
// 根據(jù)數(shù)據(jù)類型設(shè)置樣式和值
if (value == null) {
cell.setCellValue("");
cell.setCellStyle(dataStyle);
} else if (value instanceof Number) {
cell.setCellValue(((Number) value).doubleValue());
cell.setCellStyle(numberStyle);
} else if (value instanceof Date) {
CellStyle dateStyle = workbook.createCellStyle();
DataFormat format = workbook.createDataFormat();
dateStyle.setDataFormat(format.getFormat("yyyy-MM-dd"));
dateStyle.setAlignment(HorizontalAlignment.CENTER);
dateStyle.setBorderTop(BorderStyle.THIN);
dateStyle.setBorderBottom(BorderStyle.THIN);
dateStyle.setBorderLeft(BorderStyle.THIN);
dateStyle.setBorderRight(BorderStyle.THIN);
cell.setCellStyle(dateStyle);
cell.setCellValue((Date) value);
} else {
cell.setCellValue(value.toString());
cell.setCellStyle(dataStyle);
}
}
}
// 自動(dòng)調(diào)整列寬
autoSizeColumns(sheet, headers.length);
// 導(dǎo)出文件
exportExcel(response, workbook, fileName);
}
/**
* 自動(dòng)調(diào)整列寬
*/
private static void autoSizeColumns(Sheet sheet, int columnCount) {
for (int i = 0; i < columnCount; i++) {
sheet.autoSizeColumn(i);
// 設(shè)置最小列寬，防止過窄
if (sheet.getColumnWidth(i) < 15 * 256) {
sheet.setColumnWidth(i, 15 * 256);
}
// 設(shè)置最大列寬，防止過寬
if (sheet.getColumnWidth(i) > 50 * 256) {
sheet.setColumnWidth(i, 50 * 256);
}
}
}
/**
* 創(chuàng)建標(biāo)題樣式
*/
public static CellStyle createHeaderStyle(Workbook workbook) {
CellStyle style = workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.CENTER);
style.setVerticalAlignment(VerticalAlignment.CENTER);
Font font = workbook.createFont();
font.setFontName("微軟雅黑");
font.setFontHeightInPoints((short) 12);
font.setBold(true);
style.setFont(font);
style.setFillForegroundColor(IndexedColors.PALE_BLUE.getIndex());
style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
style.setBorderTop(BorderStyle.THIN);
style.setBorderBottom(BorderStyle.THIN);
style.setBorderLeft(BorderStyle.THIN);
style.setBorderRight(BorderStyle.THIN);
return style;
}
/**
* 創(chuàng)建數(shù)據(jù)樣式
*/
public static CellStyle createDataStyle(Workbook workbook) {
CellStyle style = workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.LEFT);
style.setVerticalAlignment(VerticalAlignment.CENTER);
style.setWrapText(true);
style.setBorderTop(BorderStyle.THIN);
style.setBorderBottom(BorderStyle.THIN);
style.setBorderLeft(BorderStyle.THIN);
style.setBorderRight(BorderStyle.THIN);
return style;
}
/**
* 創(chuàng)建數(shù)字格式樣式
*/
public static CellStyle createNumberStyle(Workbook workbook) {
CellStyle style = workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.RIGHT);
DataFormat format = workbook.createDataFormat();
style.setDataFormat(format.getFormat("#,##0.00"));
style.setBorderTop(BorderStyle.THIN);
style.setBorderBottom(BorderStyle.THIN);
style.setBorderLeft(BorderStyle.THIN);
style.setBorderRight(BorderStyle.THIN);
return style;
}
/**
* 導(dǎo)出Excel到HTTP響應(yīng)
*/
public static void exportExcel(HttpServletResponse response,
Workbook workbook, String fileName) throws IOException {
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setCharacterEncoding("UTF-8");
String encodedFileName = URLEncoder.encode(fileName, "UTF-8")
.replaceAll("\\+", "%20");
response.setHeader("Content-Disposition",
"attachment;filename*=UTF-8''" + encodedFileName + ".xlsx");
try (OutputStream out = response.getOutputStream()) {
workbook.write(out);
out.flush();
} finally {
if (workbook != null) {
workbook.close();
}
}
}
}
5.2 Excel導(dǎo)入工具類
package com.example.excel.util;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.io.InputStream;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
/**
* Excel導(dǎo)入工具類
*/
public class ExcelImportUtil {
/**
* 導(dǎo)入Excel文件并返回?cái)?shù)據(jù)
* @param file 上傳的Excel文件
* @param skipHeader 是否跳過標(biāo)題行
* @return 數(shù)據(jù)列表（每行數(shù)據(jù)為List<String>）
*/
public static List<List<String>> importExcel(MultipartFile file, boolean skipHeader)
throws IOException {
Workbook workbook = readExcel(file);
Sheet sheet = workbook.getSheetAt(0);
List<List<String>> dataList = new ArrayList<>();
int startRow = skipHeader ? 1 : 0;
for (int i = startRow; i <= sheet.getLastRowNum(); i++) {
Row row = sheet.getRow(i);
if (row == null) continue;
List<String> rowData = new ArrayList<>();
for (int j = 0; j < row.getLastCellNum(); j++) {
Cell cell = row.getCell(j);
String value = getCellValueAsString(cell);
rowData.add(value);
}
dataList.add(rowData);
}
workbook.close();
return dataList;
}
/**
* 讀取Excel文件
*/
public static Workbook readExcel(MultipartFile file) throws IOException {
String fileName = file.getOriginalFilename();
InputStream inputStream = file.getInputStream();
if (fileName.endsWith(".xlsx")) {
return new XSSFWorkbook(inputStream);
} else if (fileName.endsWith(".xls")) {
return new HSSFWorkbook(inputStream);
} else {
throw new IllegalArgumentException("不支持的文件格式");
}
}
/**
* 獲取單元格字符串值
*/
public static String getCellValueAsString(Cell cell) {
if (cell == null) return "";
switch (cell.getCellType()) {
case STRING:
return cell.getStringCellValue().trim();
case NUMERIC:
if (DateUtil.isCellDateFormatted(cell)) {
Date date = cell.getDateCellValue();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
return sdf.format(date);
} else {
java.text.DecimalFormat df = new java.text.DecimalFormat("0");
return df.format(cell.getNumericCellValue());
}
case BOOLEAN:
return String.valueOf(cell.getBooleanCellValue());
case FORMULA:
try {
return String.valueOf(cell.getNumericCellValue());
} catch (IllegalStateException e) {
return cell.getStringCellValue();
}
case BLANK:
return "";
default:
return "";
}
}
}
5.3 Controller使用示例
package com.example.excel.controller;
import com.example.excel.util.ExcelExportUtil;
import com.example.excel.util.ExcelImportUtil;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
/**
* Excel操作Controller示例
*/
@RestController
@RequestMapping("/excel")
public class ExcelController {
/**
* 導(dǎo)出示例
*/
@GetMapping("/export")
public void exportUserList(HttpServletResponse response) throws IOException {
// 準(zhǔn)備表頭
String[] headers = {"用戶ID", "用戶名", "年齡", "注冊(cè)日期", "狀態(tài)"};
// 準(zhǔn)備數(shù)據(jù)
List<List<Object>> dataList = new ArrayList<>();
for (int i = 1; i <= 10; i++) {
List<Object> row = new ArrayList<>();
row.add(i);
row.add("用戶" + i);
row.add(20 + i);
row.add(new java.util.Date());
row.add(i % 2 == 0 ? "啟用" : "禁用");
dataList.add(row);
}
// 導(dǎo)出
ExcelExportUtil.exportData(response, headers, dataList,
"用戶列表", "用戶數(shù)據(jù)");
}
/**
* 導(dǎo)入示例
*/
@PostMapping("/import")
public String importUserList(@RequestParam("file") MultipartFile file) {
try {
List<List<String>> dataList = ExcelImportUtil.importExcel(file, true);
// 處理導(dǎo)入數(shù)據(jù)
for (List<String> row : dataList) {
System.out.println("導(dǎo)入數(shù)據(jù)：" + row);
// 數(shù)據(jù)庫操作...
}
return "導(dǎo)入成功，共導(dǎo)入" + dataList.size() + "條數(shù)據(jù)";
} catch (IOException e) {
e.printStackTrace();
return "導(dǎo)入失?。? + e.getMessage();
}
}
}
6. 常見問題與解決方案
6.1 大文件內(nèi)存溢出問題
| 問題 | 解決方案 | 實(shí)現(xiàn)方式 |
|---|---|---|
| 大文件OOM | 使用SXSSF流式寫入 | new SXSSFWorkbook(rowAccessWindowSize) |
| 大文件讀取 | 使用事件模型 | XSSF and SAX (Event API) |
| 樣式過多 | 復(fù)用樣式對(duì)象 | 避免為每個(gè)單元格創(chuàng)建新樣式 |
SXSSF流式寫入示例：
// 設(shè)置內(nèi)存中保留100行，超過后寫入臨時(shí)文件
SXSSFWorkbook workbook = new SXSSFWorkbook(100);
Sheet sheet = workbook.createSheet("大數(shù)據(jù)導(dǎo)出");
// 寫入數(shù)據(jù)...
for (int i = 0; i < 100000; i++) {
Row row = sheet.createRow(i);
// ...
}
// 清理臨時(shí)文件
workbook.dispose();
6.2 數(shù)字精度丟失問題
// 錯(cuò)誤寫法：可能丟失精度
double value = cell.getNumericCellValue();
// 正確寫法：使用BigDecimal
BigDecimal decimal = new BigDecimal(cell.getNumericCellValue())
.setScale(2, RoundingMode.HALF_UP);
6.3 日期格式問題
// 判斷單元格是否為日期格式
if (DateUtil.isCellDateFormatted(cell)) {
Date date = cell.getDateCellValue();
// 處理日期...
} else {
// 處理數(shù)字...
}
6.4 文件名亂碼問題
// 完整的文件名編碼處理
String encodedFileName = URLEncoder.encode(fileName, "UTF-8")
.replaceAll("\\+", "%20");
response.setHeader("Content-Disposition",
"attachment;filename*=UTF-8''" + encodedFileName + ".xlsx");
6.5 版本兼容性
// 動(dòng)態(tài)判斷文件版本
Workbook workbook = null;
String fileName = file.getOriginalFilename();
if (fileName.endsWith(".xlsx")) {
workbook = new XSSFWorkbook(inputStream);
} else if (fileName.endsWith(".xls")) {
workbook = new HSSFWorkbook(inputStream);
} else {
throw new IllegalArgumentException("不支持的文件格式");
}
7. 總結(jié)與擴(kuò)展
7.1 框架對(duì)比
| 特性 | Apache POI | EasyExcel | Hutool |
|---|---|---|---|
| 學(xué)習(xí)成本 | 高 | 低 | 低 |
| 性能 | 一般 | 優(yōu)秀 | 一般 |
| 內(nèi)存占用 | 較高 | 低 | 較高 |
| 功能完整性 | 豐富 | 基礎(chǔ) | 較全 |
| 定制化能力 | 強(qiáng) | 弱 | 中等 |
選擇建議：
- 需要高度定制化樣式和功能 → Apache POI
- 處理百萬級(jí)大數(shù)據(jù)量 → EasyExcel
- 快速開發(fā)、簡單場景 → Hutool
7.2 性能優(yōu)化要點(diǎn)
- 樣式復(fù)用：避免為每個(gè)單元格創(chuàng)建新樣式，全局創(chuàng)建并復(fù)用
- 流式處理：大數(shù)據(jù)場景使用SXSSF
- 批量操作：減少頻繁的IO操作
- 及時(shí)釋放：使用try-with-resources確保資源釋放
7.3 實(shí)際應(yīng)用場景
- 報(bào)表系統(tǒng)：銷售報(bào)表、財(cái)務(wù)報(bào)表、數(shù)據(jù)分析結(jié)果導(dǎo)出
- 數(shù)據(jù)遷移：系統(tǒng)間數(shù)據(jù)交換、歷史數(shù)據(jù)導(dǎo)入
- 后臺(tái)管理：用戶列表、商品管理、訂單導(dǎo)出
- 數(shù)據(jù)分析：業(yè)務(wù)數(shù)據(jù)統(tǒng)計(jì)、趨勢分析報(bào)告
7.4 擴(kuò)展建議
- 結(jié)合注解：基于注解實(shí)現(xiàn)自動(dòng)映射（如Excel導(dǎo)入直接轉(zhuǎn)為實(shí)體對(duì)象）
- 異步處理：大文件導(dǎo)出采用異步+通知機(jī)制
- 模板導(dǎo)出：基于預(yù)先設(shè)計(jì)好的Excel模板進(jìn)行數(shù)據(jù)填充
- 多Sheet處理：復(fù)雜報(bào)表使用多Sheet組織數(shù)據(jù)
總結(jié)：Apache POI提供了完整的Excel處理能力，雖然API相對(duì)復(fù)雜，但在需要精細(xì)控制和高度定制化的場景下仍是不二之選。通過合理封裝和優(yōu)化，可以構(gòu)建穩(wěn)定高效的Excel處理工具。
以上就是Java基于POI實(shí)現(xiàn)Excel文件的導(dǎo)入導(dǎo)出的詳細(xì)內(nèi)容，更多關(guān)于Java POI實(shí)現(xiàn)Excel導(dǎo)入導(dǎo)出的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
RestTemplate使用之如何設(shè)置請(qǐng)求頭、請(qǐng)求體
這篇文章主要介紹了RestTemplate使用之如何設(shè)置請(qǐng)求頭、請(qǐng)求體問題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2023-07-07
在Spring Boot中處理文件上傳功能實(shí)現(xiàn)
這篇文章主要介紹了如何在Spring Boot中處理文件上傳,通過配置文件上傳屬性、創(chuàng)建控制器來處理上傳的文件,并通過異常處理器來管理錯(cuò)誤情況,可以快速實(shí)現(xiàn)文件上傳功能,需要的朋友可以參考下2024-06-06
部署springboot項(xiàng)目到云服務(wù)器的兩種方式(jar+war)
本文主要介紹了部署springboot項(xiàng)目到云服務(wù)器的兩種方式，主要介紹了jar和war兩種方式，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2021-12-12
Java中synchronized關(guān)鍵字引出的多種鎖 問題
synchronized關(guān)鍵字是JAVA中常用的同步功能，提供了簡單易用的鎖功能。這篇文章主要介紹了Java中synchronized關(guān)鍵字引出的多種鎖問題,需要的朋友可以參考下2019-07-07
Java基于socket服務(wù)實(shí)現(xiàn)UDP協(xié)議的方法
這篇文章主要介紹了Java基于socket服務(wù)實(shí)現(xiàn)UDP協(xié)議的方法,通過兩個(gè)簡單實(shí)例分析了java通過socket實(shí)現(xiàn)UDP發(fā)送與接收的技巧,需要的朋友可以參考下2015-05-05
今天小編就為大家分享一篇關(guān)于重新認(rèn)識(shí)Java的System.in，小編覺得內(nèi)容挺不錯(cuò)的，現(xiàn)在分享給大家，具有很好的參考價(jià)值，需要的朋友一起跟隨小編來看看吧2018-12-12
Java零基礎(chǔ)也看得懂的單例模式與final及抽象類和接口詳解
本文主要講了單例模式中的餓漢式和懶漢式的區(qū)別，final的使用，抽象類的介紹以及接口的具體內(nèi)容，感興趣的朋友來看看吧2022-05-05
java基于雙向環(huán)形鏈表解決丟手帕問題的方法示例
這篇文章主要介紹了java基于雙向環(huán)形鏈表解決丟手帕問題的方法,簡單描述了丟手帕問題,并結(jié)合實(shí)例形式給出了Java基于雙向環(huán)形鏈表解決丟手帕問題的步驟與相關(guān)操作技巧,需要的朋友可以參考下2017-11-11
Java實(shí)現(xiàn)Kruskal算法的示例代碼
Kruskal算法是一種用來尋找最小生成樹的算法，由Joseph Kruskal在1956年發(fā)表。用來解決同樣問題的還有Prim算法和Boruvka算法等。本文將介紹用Java語言實(shí)現(xiàn)Kruskal算法的示例代碼，需要的可以參考一下2022-07-07
在Java開發(fā)中,我們經(jīng)常需要將對(duì)象進(jìn)行序列化和反序列化,以便在網(wǎng)絡(luò)傳輸或存儲(chǔ)到持久化介質(zhì)中,Java提供了一種機(jī)制,即通過實(shí)現(xiàn)Serializable接口來實(shí)現(xiàn)對(duì)象的串行化,本文將詳細(xì)介紹Java串行化接口的用法和原理,以及一些相關(guān)的注意事項(xiàng),需要的朋友可以參考下2023-11-11