# lzh-1.8-excel-spring-boot-starter

**Repository Path**: coding_13/lzh-1.8-excel-spring-boot-starter

## Basic Information

- **Project Name**: lzh-1.8-excel-spring-boot-starter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-08
- **Last Updated**: 2025-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lzh-1.8-excel-spring-boot-starter

这是一个 Spring Boot Starter 项目，旨在简化使用 EasyExcel 进行 Excel 导入导出操作。该项目提供了一系列的转换器、处理器、监听器和工具类，以支持各种数据类型的处理和业务场景。

## 特性

- **多种数据类型转换器**：支持 BigDecimal、Double、Integer、Boolean、Date、LocalDate、YearMonth 等数据类型的转换。
- **导入导出处理器**：提供抽象类和接口，方便实现自定义的导入导出逻辑。
- **错误处理**：在导入过程中捕获并处理错误，支持将错误数据写入 Excel 文件。
- **合并单元格策略**：支持自定义合并单元格的策略。
- **工具类**：提供便捷的 Excel 操作工具方法。

## 模块结构

- **converter**：包含各种数据类型转换器，用于 Excel 单元格与 Java 对象之间的转换。
- **exception**：定义了自定义异常类 `ExcelException` 和错误码枚举 `ErrorCode`。
- **exports**：包含导出处理器，用于处理 Excel 导出逻辑。
- **imports**：包含导入处理器、监听器和策略类，用于处理 Excel 导入逻辑。
- **function**：包含函数式接口 `ThirdConsumer`。
- **util**：包含工具类 `ExcelUtil`，提供静态方法辅助 Excel 操作。

## 使用示例

### 导出 Excel

```java
// 示例：导出 Excel 文件
public void exportData(HttpServletResponse response) {
    List<MyData> dataList = getData(); // 获取数据
    ExcelUtil.writeExcelToResponse(response, "output.xlsx", dataList, MyData.class, (out, data, clazz) -> {
        // 自定义写入逻辑
    });
}
```

### 导入 Excel

```java
// 示例：导入 Excel 文件
public void importData(MultipartFile file) {
    ImportAbstractProcessor<MyCondition, MyResult, MyData> processor = new MyImportProcessor();
    MyResult result = processor.importFile(file, new MyCondition());
    // 处理导入结果
}
```

## 贡献

欢迎贡献代码和提出问题。请确保提交的代码符合项目的编码规范，并添加相应的测试用例。

## 许可证

该项目采用 MIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。