java将excel数据存入list

作者：excel问答网

220人看过

发布时间：2026-01-26 07:59:33

标签：

Java中将Excel数据存入List的实践方法与深度解析在Java开发中，数据的处理能力直接影响着应用的性能和用户体验。Excel作为一种常见的数据存储格式，常用于数据导入、导出和处理。在Java中，将Excel文件中的数据存入Li

Java中将Excel数据存入List的实践方法与深度解析
在Java开发中，数据的处理能力直接影响着应用的性能和用户体验。Excel作为一种常见的数据存储格式，常用于数据导入、导出和处理。在Java中，将Excel文件中的数据存入List，是数据处理过程中不可或缺的一环。
一、理解Excel文件结构与数据类型
Excel文件本质上是二进制文件，其结构由多个工作表组成，每个工作表由行和列构成。每一行代表一条记录，每一列代表一个字段。Excel文件通常使用 `.xls` 或 `.xlsx` 作为扩展名，分别对应旧版和新版的Excel文件。在Java中，处理Excel文件通常采用Apache POI库，该库提供了丰富的API，支持读取和写入Excel文件。
在Java中，Excel文件中的数据字段可以是字符串、数字、日期、布尔值等类型。例如，一个Excel文件可能包含以下字段：
| 列名 | 数据类型 |
||--|
| ID | 整数 |
| Name | 字符串 |
| Age | 整数 |
| Status | 布尔值 |
这些数据在读取后，可以被存入Java的List集合中，用于后续的数据处理或展示。
二、Apache POI库的引入与使用
Apache POI是一个流行的Java库，用于处理Office文档，包括Excel文件。它提供了多个类来处理Excel文件，其中`HSSFWorkbook`和`XSSFWorkbook`分别用于处理 `.xls` 和 `.xlsx` 文件。在Java中，使用Apache POI读取Excel文件的核心步骤如下：
1. 添加依赖：在Maven项目中，添加Apache POI的依赖。例如：
xml

org.apache.poi
poi
5.2.3

org.apache.poi
poi-ooxml
5.2.3

2. 读取Excel文件：使用`HSSFWorkbook`或`XSSFWorkbook`加载Excel文件，然后通过`sheet`对象获取工作表。
3. 遍历行和列：通过`sheet.getRow(i)`获取某一行，再通过`row.getCell(j)`获取某一列的数据。
4. 将数据存入List：将读取到的数据存入Java的`List`或`List>`集合中。
三、读取Excel文件的基本实现
下面是一个简单的Java代码示例，演示如何读取Excel文件并存入List：
java
import org.apache.poi.ss.usermodel.;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.File;
import java.io.FileInputStream;
import java.util.;
public class ExcelToJavaList
public static void main(String[] args)
String filePath = "data.xlsx";
List> dataList = new ArrayList<>();
try (FileInputStream fis = new FileInputStream(new File(filePath));
Workbook workbook = new XSSFWorkbook(fis))
Sheet sheet = workbook.getSheetAt(0);
Row headerRow = sheet.getRow(0);
// 读取表头
for (int i = 0; i < headerRow.getCell(0).getStringCellValue().length(); i++)
String header = headerRow.getCell(i).getStringCellValue();
dataList.add(new HashMap<>());
dataList.get(dataList.size() - 1).put(header, null);

// 读取数据行
for (int rowNum = 1; rowNum <= sheet.getLastRowNum(); rowNum++)
Row row = sheet.getRow(rowNum);
if (row == null) continue;
Map data = new HashMap<>();
for (int colNum = 0; colNum < row.getPhysicalNumberOfCells(); colNum++)
Cell cell = row.getCell(colNum);
if (cell == null) continue;
String cellValue = cell.getStringCellValue();
if (cell.getColumnIndex() == 0)
data.put("ID", cellValue);
else if (cell.getColumnIndex() == 1)
data.put("Name", cellValue);
else if (cell.getColumnIndex() == 2)
data.put("Age", cellValue);
else if (cell.getColumnIndex() == 3)
data.put("Status", cellValue);

dataList.add(data);

catch (Exception e)
e.printStackTrace();

这段代码首先加载Excel文件，读取第一行作为表头，然后读取后续行作为数据，将数据存入`List>`中。这种方式适用于简单数据的读取。
四、使用Map存储数据的优缺点
使用`Map`存储数据有其优势，例如可以方便地通过键名访问数据，适合需要频繁查找数据的场景。然而，这种方式也存在一些缺点：
1. 数据类型不固定：`Object`类型无法直接判断数据类型，可能导致类型转换错误。
2. 性能较低：`Map`的查找和插入操作的时间复杂度较高，不适合大量数据。
3. 可读性差：数据存储在Map中，不利于后续的调试和维护。
因此，在实际开发中，建议使用`List>`或`List`来存储数据，以提高性能和可读性。
五、使用Row对象存储数据的实现
另一种常见的做法是将每一行数据存入`Row`对象，然后将`Row`对象存入`List`中。这种方式适用于需要保留行结构的场景，例如处理表格数据时，每行数据可以被单独处理。
java
import org.apache.poi.ss.usermodel.;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.File;
import java.io.FileInputStream;
import java.util.;
public class ExcelToJavaList
public static void main(String[] args)
String filePath = "data.xlsx";
List dataList = new ArrayList<>();
try (FileInputStream fis = new FileInputStream(new File(filePath));
Workbook workbook = new XSSFWorkbook(fis))
Sheet sheet = workbook.getSheetAt(0);
Row headerRow = sheet.getRow(0);
// 读取表头
for (int i = 0; i < headerRow.getCell(0).getStringCellValue().length(); i++)
String header = headerRow.getCell(i).getStringCellValue();
dataList.add(new Row());
((Row) dataList.get(dataList.size() - 1)).setCell(i, new Cell());
((Cell) ((Row) dataList.get(dataList.size() - 1)).getCell(i)).setCellValue(header);

// 读取数据行
for (int rowNum = 1; rowNum <= sheet.getLastRowNum(); rowNum++)
Row row = sheet.getRow(rowNum);
if (row == null) continue;
Row dataRow = new Row();
for (int colNum = 0; colNum < row.getPhysicalNumberOfCells(); colNum++)
Cell cell = row.getCell(colNum);
if (cell == null) continue;
Cell dataCell = new Cell();
dataCell.setCellValue(cell.getStringCellValue());
dataRow.addCell(dataCell);

dataList.add(dataRow);

catch (Exception e)
e.printStackTrace();

这种方式更注重数据的结构化存储，适合需要保留行和列信息的场景。
六、使用List存储数据的优缺点
使用`List`存储数据的方式，具有以下优点：
1. 结构清晰：每行数据都被单独存储，便于后续处理。
2. 可扩展性强：可以方便地添加新行或修改现有行。
3. 便于处理复杂数据：适合需要处理多列、多行数据的场景。
但也有其缺点：
1. 性能较低：`Row`对象的处理需要较多的内存和计算资源。
2. 数据类型不固定：`Row`对象中存储的是`Cell`对象，而非直接的数据类型，需要额外处理。
因此，应根据实际需求选择合适的数据存储方式。
七、处理Excel文件中的特殊格式
Excel文件中可能包含特殊格式的数据，例如合并单元格、公式、条件格式等。在Java中，处理这些格式时，需要特别注意。
1. 合并单元格：在读取Excel文件时，合并单元格的处理需要特别注意，避免数据被错误地分割。
2. 公式：Excel中的公式需要被正确解析，以避免在Java中出现计算错误。
3. 条件格式：条件格式的处理需要使用`ConditionalFormatting`接口，以确保数据的正确显示。
八、处理Excel文件中的错误与异常
在处理Excel文件时，可能会遇到各种错误，例如文件不存在、文件格式不正确、数据格式不匹配等。在Java中，需要妥善处理这些异常，以确保程序的健壮性。
1. 文件不存在异常：`FileNotFoundException`。
2. 文件格式异常：`InvalidFormatException`。
3. 数据格式异常：`IllegalStateException`。
在代码中，应添加异常处理机制，以避免程序因异常而崩溃。
九、使用Java的Excel处理库（如JExcelApi）
除了Apache POI，Java中还存在其他Excel处理库，例如JExcelApi。JExcelApi是一个较老的库，支持读写Excel文件，但功能较为简单。在Java中，使用JExcelApi的示例代码如下：
java
import org.apache.poi.ss.usermodel.;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.File;
import java.io.FileInputStream;
import java.util.;
public class ExcelToJavaList
public static void main(String[] args)
String filePath = "data.xlsx";
List> dataList = new ArrayList<>();
try (FileInputStream fis = new FileInputStream(new File(filePath));
Workbook workbook = new XSSFWorkbook(fis))
Sheet sheet = workbook.getSheetAt(0);
Row headerRow = sheet.getRow(0);
// 读取表头
for (int i = 0; i < headerRow.getCell(0).getStringCellValue().length(); i++)
String header = headerRow.getCell(i).getStringCellValue();
dataList.add(new HashMap<>());
dataList.get(dataList.size() - 1).put(header, null);

// 读取数据行
for (int rowNum = 1; rowNum <= sheet.getLastRowNum(); rowNum++)
Row row = sheet.getRow(rowNum);
if (row == null) continue;
Map data = new HashMap<>();
for (int colNum = 0; colNum < row.getPhysicalNumberOfCells(); colNum++)
Cell cell = row.getCell(colNum);
if (cell == null) continue;
String cellValue = cell.getStringCellValue();
if (cell.getColumnIndex() == 0)
data.put("ID", cellValue);
else if (cell.getColumnIndex() == 1)
data.put("Name", cellValue);
else if (cell.getColumnIndex() == 2)
data.put("Age", cellValue);
else if (cell.getColumnIndex() == 3)
data.put("Status", cellValue);

dataList.add(data);

catch (Exception e)
e.printStackTrace();

JExcelApi的功能相对简单，适用于小型项目，但在处理复杂Excel文件时，性能和功能上可能不如Apache POI。
十、使用Java的Excel处理库（如Apache POI）的高级功能
Apache POI不仅支持基础的Excel文件读取，还提供了丰富的高级功能，例如：
1. 样式处理：可以处理Excel中的字体、颜色、边框等样式。
2. 公式处理：可以解析和执行Excel中的公式。
3. 条件格式处理：可以处理Excel中的条件格式，如填充、颜色填充等。
4. 数据验证：可以设置单元格的验证规则，如整数、日期等。
这些高级功能在处理复杂Excel文件时非常有用。
十一、数据存储的优化策略
在将Excel数据存入List时，可以采取一些优化策略，以提高性能和内存使用效率：
1. 使用流式处理：避免一次性加载整个Excel文件到内存中，而是分块处理。
2. 使用缓存：对于频繁读取的数据，可以使用缓存机制提高读取效率。
3. 使用内存映射：使用内存映射技术，将Excel文件映射到内存中，提高读取速度。
4. 使用多线程处理：对于大规模数据，可以使用多线程处理，提高处理效率。
十二、实际应用场景与案例分析
在实际应用中，将Excel数据存入List的场景非常广泛，包括：
1. 数据导入：将Excel文件中的数据导入到Java项目中。
2. 数据统计：对Excel文件中的数据进行统计分析。
3. 数据可视化：将Excel数据存入List后，使用图表库（如ECharts、JFreeChart）进行数据可视化。
4. 数据导出：将Java中的数据导出为Excel文件。
在实际开发中，应根据具体需求选择合适的数据存储方式，以提高性能和可维护性。

在Java中，将Excel数据存入List是一项基础而重要的技能。通过掌握Apache POI等库的使用，可以高效地处理Excel文件，满足各种数据处理需求。在实际开发中，应根据具体场景选择合适的数据存储方式，以提高性能和可维护性。同时，应关注Excel文件的格式、数据类型、异常处理等问题，确保程序的健壮性和稳定性。

上一篇 : 数据导出excel字体怎么表达

下一篇 : excel表格数据复制是乱码