Poiji：简单易用的Java Excel解析库

1. 项目介绍

Poiji 是一个简单、快速且易于使用的 Java 库，用于解析 Excel 文件。它基于 Apache POI，但是提供了更加简单直观的 API，使得处理 Excel 文件变得异常方便。Poiji 支持读取 XLS 和 XLSX 格式的 Excel 文件，并可以将数据转换为 Java 对象。

2. 项目快速启动

以下是一个简单的示例，展示如何使用 Poiji 读取 Excel 文件并将数据转换成 Java 对象。

首先，确保你的项目已经包含了 Poiji 依赖。如果你使用 Maven，可以在 pom.xml 文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>com.github.ozlerhakan</groupId>
        <artifactId>poiji</artifactId>
        <version>2.1.0</version>
    </dependency>
</dependencies>

然后，创建一个 Java 类来表示 Excel 文件中的行：

public class ExcelData {
    private String name;
    private int age;
    private String email;

    // 省略 getter 和 setter 方法
}

接下来，使用 Poiji 读取 Excel 文件：

import com.github.ozlerhakan.poiji.Poiji;
import com.github.ozlerhakan.poiji.model.ExcelReader;

import java.io.File;
import java.io.IOException;
import java.util.List;

public class PoijiExample {
    public static void main(String[] args) {
        File excelFile = new File("path/to/your/excel/file.xlsx");

        try (ExcelReader reader = Poiji.fromFile(excelFile, ExcelData.class)) {
            List<ExcelData> excelDataList = readerToList(reader);
            for (ExcelData data : excelDataList) {
                System.out.println("Name: " + data.getName() + ", Age: " + data.getAge() + ", Email: " + data.getEmail());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private static List<ExcelData> readerToList(ExcelReader reader) {
        return reader.read();
    }
}

确保将 "path/to/your/excel/file.xlsx" 替换为你的 Excel 文件的实际路径。

3. 应用案例和最佳实践

读取大型 Excel 文件

当处理大型 Excel 文件时，可以使用 Poiji 的流式 API 来减少内存消耗：

try (ExcelReader reader = Poiji.fromFile(excelFile, ExcelData.class)) {
    reader.forEach(System.out::println);
} catch (IOException e) {
    e.printStackTrace();
}

自定义数据格式

如果需要自定义数据格式，例如日期格式，可以在 fromFile 方法中指定：

try (ExcelReader reader = Poiji.fromFile(excelFile, ExcelData.class, "yyyy-MM-dd")) {
    List<ExcelData> excelDataList = readerToList(reader);
    // ...
} catch (IOException e) {
    e.printStackTrace();
}

4. 典型生态项目

目前，Poiji 社区较小，但是它的设计简洁，易于集成到现有的 Java 项目中。以下是一些可能的生态项目：

• 与 Spring Boot 集成，为 Web 应用提供 Excel 文件上传和解析功能。
• 在数据导入导出工具中集成 Poiji，简化数据处理流程。
• 利用 Poiji 开发数据报表生成工具，自动生成 Excel 报告。

通过上述介绍，你可以看到 Poiji 是一个非常有用的库，可以让 Java 开发者轻松处理 Excel 文件。