# 文件系统 📁

了解 MockM 生成的文件结构,便于数据管理和问题排查。

# 📊 目录结构

运行 MockM 后,会在 dataDir 目录下生成以下文件:

httpData/                    # 📁 数据根目录
├── db.json                  # 🗃️ RESTful API 数据存储
├── httpHistory.json         # 📜 请求历史记录索引
├── store.json              # ⚙️ 应用状态信息
├── apiWeb.json             # 🌐 Web界面创建的API配置
├── log.err.txt             # 📝 错误日志
└── request/                # 📂 请求详情存储目录
    ├── api_users_1001/     # 📁 按接口路径分组
    │   ├── get_1001_req.json    # 📤 请求详情
    │   ├── get_1001_res.json    # 📥 响应详情
    │   └── get_1001_info.json   # ℹ️ 请求元信息
    └── api_posts_1002/
        ├── post_1002_req.json
        ├── post_1002_res.json
        └── post_1002_info.json

# 🗃️ 核心文件说明

# db.json - RESTful 数据库

存储通过 config.db 定义的数据。

用途

  • 🔄 RESTful API 的数据源
  • 📝 支持 CRUD 操作的持久化
  • 🔍 搜索和分页功能的数据基础

示例结构

{
  "users": [
    { "id": 1, "name": "张三", "email": "zhang@example.com" },
    { "id": 2, "name": "李四", "email": "li@example.com" }
  ],
  "posts": [
    { "id": 1, "title": "第一篇文章", "userId": 1 }
  ]
}

# httpHistory.json - 请求索引

记录所有请求的基础信息,用于 Web 界面显示。

包含信息

  • 📋 请求 ID、方法、路径
  • ⏰ 时间戳、状态码
  • 📊 请求/响应大小
  • 🔗 关联的详细文件路径

# apiWeb.json - Web API 配置

存储通过 Web 界面创建的 API 定义。

功能

  • ✏️ 在线编辑的 API 配置
  • 🔄 表格模式和代码模式的数据
  • 🎛️ 接口开关状态
  • 📋 自定义响应头设置

# request/ - 请求详情目录

按接口路径分组存储每个请求的完整信息。

文件命名规则

  • {method}_{id}_req.json - 请求详情(Headers、Body、Query等)
  • {method}_{id}_res.json - 响应详情(Status、Headers、Body等)
  • {method}_{id}_info.json - 元信息(时间、处理耗时等)

# ⚙️ 自定义存储路径

可以通过配置调整文件存储位置:

配置项 说明 默认值
dataDir 数据根目录 ./httpData
dbJsonPath RESTful 数据文件 ${dataDir}/db.json
apiWeb Web API 配置文件 ${dataDir}/apiWeb.json

示例配置

module.exports = {
  dataDir: './my-mock-data',
  dbJsonPath: './database/api-data.json',
  apiWeb: './config/web-apis.json'
}
最后更新时间: 2025/7/25 03:25:39