# wsitm-clutter

**Repository Path**: wsitm/wsitm-clutter

## Basic Information

- **Project Name**: wsitm-clutter
- **Description**: 杂烩工具，基于 Hutool， 针对业务进一步封装的工具
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-04-27
- **Last Updated**: 2025-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wsitm-clutter

## 介绍
`wsitm-clutter` 是一个基于 [Hutool](https://github.com/looly/hutool) 的工具类库，针对业务场景进行了进一步封装，主要提供以下功能：

- 支持大数据量的 Excel（xlsx） 和 CSV 文件导出
- 树形结构数据导出并生成 Excel 文件

该项目适用于需要高效处理数据导出、树形结构转换以及统一响应处理的业务场景。

## 功能概览

| 模块 | 功能 |
|------|------|
| `ExportKit` | 提供多种方式导出数据为 Excel 或 CSV 文件 |
| `Tree2ExcelKit` | 将树形结构数据转换为 Excel 表格 |
| `Header` | 注解方式定义导出字段的表头信息 |

## 使用示例

### 数据导出为 Excel

```java
List<Demo> dataList = getData(); // 获取数据列表
ExportKit.exportXlsx(response, dataList); // 导出为 Excel 文件
```

### 数据导出为 CSV

```java
ExportKit.exportCsv(response, list -> {
    for (Demo demo : dataList) {
        list.accept(demo);
    }
});
```

### 树形结构导出为 Excel

```java
List<TreeE> treeData = getTreeData(); // 获取树形数据
Workbook workbook = new XSSFWorkbook(); // 创建 Excel 工作簿
Tree2ExcelKit.handle(workbook, treeData); // 导出树形结构
```

## 模块说明

### `ExportKit`

提供多种导出方式，支持 `OutputStream`、`File`、`ExcelWriter` 等参数类型，适用于不同场景下的导出需求。

### `Tree2ExcelKit`

将树形结构转换为 Excel 表格，支持自定义字段名、层级结构、样式等。

### `Header`

通过注解方式定义导出字段的表头信息，简化字段映射配置。

## 依赖说明

本项目基于 [Hutool](https://github.com/looly/hutool)，请确保项目中已引入以下依赖：

```xml
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.22</version>
</dependency>
```

## 许可证

本项目遵循 [MIT License](https://opensource.org/licenses/MIT)，详情请查看 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎提交 Issue 和 Pull Request，帮助我们完善项目。请遵循以下贡献流程：

1. Fork 项目
2. 创建新分支
3. 提交代码
4. 提交 Pull Request

## 联系方式

如有问题或建议，请提交 Issue 或联系项目维护者。

## 致谢

感谢 [Hutool](https://github.com/looly/hutool) 提供的基础工具支持。