# dynamic-excel

**Repository Path**: halfhumanz/dynamic-excel

## Basic Information

- **Project Name**: dynamic-excel
- **Description**: Java poi 根据数据库数据配置，动态导入导出Excel
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-12-30
- **Last Updated**: 2024-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dynamic-excel

#### 介绍

Java poi 根据数据库数据配置，动态导入导出Excel。

1. 动态配置 Excel 导入数据功能。配置Excel的Sheet页及表头字段对应。
2. 导入数据配置支持：
    - 支持单元格非空校验
    - 支持单元格数据重复校验
    - 支持单元格字典枚举翻译
    - 支持自定义单元格内容校验
    - 支持自定义行内容校验
    - 支持单Sheet页一对多数据整理
3. 动态配置Excel导出数据功能。
    - 支持单元格字典枚举翻译

#### 软件架构

- spring-boot：2.2
- poi：5.2.2

#### 使用教程

1.  根据不同数据库执行对应数据库SQL文件
2.  将项目打包，作为依赖包。在新项目中引入。

#### 使用说明

1.  数据库配置：excel_template表。新增一个excel模板。
2.  数据库配置：excel_sheet表。新增excel对应的 sheet 数据页模板。
3.  数据库配置：excel_header表。新增每个 sheet 数据页的表头配置。
4.  如果有复杂的校验逻辑 请继承`com.blackcat.dynamicexcel.service.DynamicExcelService`类，重写下面对应方面逻辑：
    - `saveDatabase`：数据校验通过，保存数据处理。
    - `supplementCustomCellCheck`：补充据校验：单元格校验。
    - `supplementCustomRowCheck`：补充据校验：行校验。需要多个单元格同时校验时需要。
5. 调用：`com.blackcat.dynamicexcel.service.dynamicExport`方法即可实现导出功能。
6. 调用：`com.blackcat.dynamicexcel.service.dynamicImport`方法即可实现导入功能。
7. 详细使用文档及示例，查看文章：
8. 接口调用 API 示例：https://apifox.com/apidoc/shared-5b10a158-91e4-4425-9eeb-fd840d2494d6/api-57879538

#### 后续考虑优化

1. 下载模板
2. 页面配置
3. 新增格式校验，包含email，电话，身份证等特殊格式，长度等