# DBMocker

**Repository Path**: yxkj_admin/dbmocker

## Basic Information

- **Project Name**: DBMocker
- **Description**: 一个轻量级数据库造数工具，支持规则模板配置、自动识别表结构、批量生成数据。无需复杂依赖，前后端集成，适合测试、开发、演示等场景。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-01
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DBMocker - 一款灵活强大的造数工具

🚀 **DBMocker** 是一款专为开发、测试、数据验证等场景打造的轻量级数据造数工具，支持灵活配置、多种结构、无需依赖、开箱即用，助你一键生成各类模拟数据。

---

## ✨ 项目特点

- ✅ **自定义模板规则**：使用类似 的规则生成格式化 ID、手机号、时间、随机值等。
- ✅ **零依赖纯 Java 实现**：无需额外依赖库，部署轻便。
- ✅ **支持多种数据类型**：
    - 姓名、手机号、邮箱、UUID
    - 指定时间/时间范围
    - 指定数值/数值范围
    - 枚举字段、递增序列等
- ✅ **嵌入式 Web 页面**：通过 Web 界面配置规则，生成结果即时预览。
- ✅ **支持字段配置和结构预设**：适配多种数据库结构或测试场景。
- ✅ **Mock 工具化**：适合测试数据批量造数、接口联调、自动化测试前置数据生成。

---

## 🧱 示例规则说明

| 规则                 | 说明               |
|--------------------|------------------|
| `{date:yyMMdd}`    | 当前日期（例：250727）   |
| `{seq:5}`          | 5 位递增序列（例：00001） |
| `{uuid:6}`         | 截取 UUID 前 6 位    |
| `{rand:1000-9999}` | 生成范围内的随机整数       |
| `{enum:男,女,未知}`    | 枚举随机选择值          |

📌 示例：

模板规则：
USR{date:yyMMdd}_{seq:5}-{uuid:6}$#{rand:1000-9999}-{enum:男,女,未知}

生成结果：
> USR2507208_00105-edf781$#6866-男
> 
> USR240727_00001-8f3dce$#7231-女


![img_2.png](img_2.png)
![img_1.png](img_1.png)

---

## 🛠 使用方式

### 1. 克隆项目

```bash
git clone https://github.com/icaozm/DBMocker.git
cd DBMocker
```

2. 运行方式（支持以下任意方式）


    🔹  本地运行（需要 JDK 1.8 以上）


3. 访问页面
浏览器打开：
http://localhost:9527/


🧩 自定义扩展

你可以轻松实现自己的规则 handler：
``` java
public class CustomHandler implements PlaceholderHandler {
    @Override
    public String handle(String param, RuleContext ctx) {
        // 自定义逻辑
    }
}
```
然后注册到引擎中：
``` java
  engine.registerHandler("mytag", new CustomHandler());
```



🧳 TODO 规划

	• 模板保存功能

🙋‍♂️ 作者信息

	• Author: [caozm]
	• Email: iczming@163.com
	• 欢迎 PR / 提建议 / 一起共建！