# simple-dao-demo

**Repository Path**: revent2021/simple-dao-demo

## Basic Information

- **Project Name**: simple-dao-demo
- **Description**: SimpleDAO 全部案例，由浅入深，覆盖单表CRUD、动态条件、分页、联表、聚合统计、数据权限、脱敏等高场景。SQL-First 理念贯穿始终，代码可直接复用，每个案例独立可运行，即开即用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2026-05-05
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> 🏠 返回主页：[SimpleDAO 核心特性 & 设计理念](https://gitee.com/gao_zhenzhong/simple-dao)

## 🚀 快速开始

> ⚠️ 环境与兼容版本：

| 依赖 | 版本要求 | 说明 |
|------|----------|------|
| JDK | 21+ | 必须 |
| Maven | 3.9+ | 必须 |
| Spring Boot | 3.x | 推荐 |
| Swagger Core | 2.x | 推荐 |

> 其他版本理论上兼容，但不保证。

### 🎯 Demo工程场景速查
| 序号 | Demo工程名称 | 对应场景 | 核心能力 |
|:---:|--------------|----------|----------|
| 01  | demo01_basic_crud | 单表 CRUD | 全量 CRUD、分页、逻辑删除、审计字段填充 |
| 02  | demo02_join_query | 联表查询 | 原生 SQL 联表，自定义查询逻辑 |
| 03  | demo03_condition_advance | 复杂条件查询 | 嵌套子查询、SQL 片段拼接 |
| 04  | demo04_condition_join_in | IN/区间查询 | 自动处理非空判断，消灭 if 逻辑 |
| 05  | demo05_report_aggregate | 报表汇总 | 多表汇总、数据库函数直接调用 |
| 06  | demo06_mergeParams | 多条件合并 | 多位置条件自动合并，报表开发效率翻倍 |
| 07  | demo07_data_auth | 数据权限 | 完全透明、高度可控、易于扩展的数据权限体系|
| 08  | demo08_desensitize | 字段脱敏 | 逻辑删除字段名配置、审计字段自定义、字段脱敏 |

### 引入依赖
在你自己的项目 `pom.xml` 中添加：
```xml
<dependency>
    <groupId>io.gitee.simpledao</groupId>
    <artifactId>simple-dao</artifactId>
    <version>1.2.1</version>
</dependency>
```
该依赖已发布至 Maven Central，国内用户也可通过阿里云等镜像快速拉取，无需额外配置私服。

### 1. 下载代码
```bash
git clone https://gitee.com/gao_zhenzhong/simple-dao-demo.git
```
 

### 2. 运行案例
1. 用 IDEA 打开 `simple-dao-demo` 项目的 `demo01_basic_crud` 模块。
2. 直接运行 `DemoApplication` 启动类。
3. 控制台自动输出完整执行日志，包含：
   - 自动生成的 SQL 语句
   - 增删改查 + 分页 + 审计字段填充结果
   - 逻辑删除执行效果

或者：
```bash
cd simple-dao-demo/v1/demo01_basic_crud
mvn spring-boot:run
```

### ✨ 关键说明
- 案例内置 **H2 内存数据库**，无需手动配置数据库、建表。
- 运行后无需任何操作，控制台可直接看到完整执行流程。
- 所有核心功能（ID 自动生成、审计字段填充、逻辑删除）已默认开启，无需任何配置。