使用 Apache POI 的 DataFormatter 处理 Excel 数据

在处理 Excel 文件时，确保正确格式化和读取数据是一个常见的需求。Apache POI 是一个强大的 Java 库，可以用来读写 Microsoft Office 格式的文件，包括 Excel。本文将介绍如何使用 Apache POI 的 DataFormatter 类来简化数据的格式化和读取过程。

为什么使用 DataFormatter？

当我们从 Excel 文件中读取数据时，数据可能包含不同的格式，如日期、数字、货币等。直接读取单元格的原始值可能不会反映用户在 Excel 中看到的格式。DataFormatter 类可以帮助我们将这些数据格式化为易于理解的字符串形式。

Apache POI 和 Maven 依赖

在使用 DataFormatter 之前，确保你的项目中已经包含了 Apache POI 的相关依赖。如果你使用 Maven 作为构建工具，可以在 pom.xml 文件中添加以下依赖：

<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>

DataFormatter 类的使用

DataFormatter 是 Apache POI 库中用于格式化 Excel 单元格数据的类。它可以根据单元格的格式设置（如日期格式、货币格式等）自动转换数据类型为字符串。

示例代码

以下示例演示了如何使用 DataFormatter 读取 Excel 文件，并将每个单元格的数据格式化为字符串：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileInputStream;
import java.io.IOException;

public class DataFormatterExample {
    public static void main(String[] args) {
        // Excel 文件路径
        String filePath = "example.xlsx";
        
        // 创建 DataFormatter 实例
        DataFormatter dataFormatter = new DataFormatter();
        
        try (FileInputStream fis = new FileInputStream(filePath);
             Workbook workbook = new XSSFWorkbook(fis)) {

            // 获取第一个工作表
            Sheet sheet = workbook.getSheetAt(0);

            // 遍历每一行
            for (Row row : sheet) {
                // 遍历每一列
                for (Cell cell : row) {
                    // 使用 DataFormatter 格式化单元格数据
                    String cellValue = dataFormatter.formatCellValue(cell);
                    System.out.print(cellValue + "\t");
                }
                System.out.println();
            }

        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

代码解析

1. 创建 DataFormatter 实例: DataFormatter 对象用于将不同格式的单元格值转换为标准字符串。

2. 读取 Excel 文件: 使用 FileInputStream 和 XSSFWorkbook 读取 .xlsx 格式的 Excel 文件。如果你的文件是 .xls 格式，可以使用 HSSFWorkbook 类。

3. 获取工作表和单元格数据: 通过 Sheet、Row 和 Cell 类遍历工作表中的数据。

4. 格式化单元格数据: formatCellValue(Cell cell) 方法将单元格的内容转换为格式化后的字符串。

总结

使用 Apache POI 的 DataFormatter 类可以极大地简化 Excel 文件数据的读取和格式化过程。它自动处理不同的数据格式，使得从 Excel 文件中提取和显示数据变得更加容易。通过本示例代码，你可以开始将 DataFormatter 应用于你的项目中，提升数据处理的效率和准确性。

希望这篇博客能帮助你更好地理解和使用 Apache POI 的 DataFormatter 类。如果你有任何问题或建议，欢迎在下方留言。