|
| 1 | + |
| 2 | + |
| 3 | +<h1 align="center">DBApi 快速开发平台</h1> |
| 4 | + |
| 5 | +<div align="center"> |
| 6 | + |
| 7 | +[特性](#特性) | [在线体验](#在线体验) | [技术架构](#技术架构) | [快速开始](#快速开始) | [使用说明](#使用说明) | [运行截图](#运行截图) | [学习交流](#学习交流) |
| 8 | + |
| 9 | +🚀 **DBApi** 是一个高效且灵活的解决方案,旨在缩短数据库与 Web API 之间的距离。通过 DBApi,开发者可以轻松地将 SQL 查询转换为 RESTful API,使数据集成与共享更加简单。 |
| 10 | + |
| 11 | +DBApi 非常适合开发者、数据工程师和希望简化数据访问、缩短开发时间并提升生产力的企业。立即使用 DBApi,充分释放数据的潜力。 |
| 12 | + |
| 13 | +</div> |
| 14 | + |
| 15 | +--- |
| 16 | + |
| 17 | +# 👻 特性 |
| 18 | + |
| 19 | +- [x] 轻松将复杂的 SQL 查询转换为简单的 RESTful 接口。 |
| 20 | +- [x] 支持多数据源管理,满足不同场景的集成需求。 |
| 21 | +- [x] 提供接口调用日志记录功能,方便问题排查和性能监控。 |
| 22 | +- [ ] 支持多种数据库类型(MySQL / PostgreSQL / MongoDB 等,未来支持更多)。 |
| 23 | +- [ ] 内置身份验证和授权机制,保障数据安全。 |
| 24 | +- [ ] 动态生成 API 文档,快速对接开发团队。 |
| 25 | + |
| 26 | +--- |
| 27 | + |
| 28 | +# 在线体验 |
| 29 | + |
| 30 | +[在线体验](http://111.229.110.183:8088) |
| 31 | + |
| 32 | +用户名密码:guest/guest |
| 33 | + |
| 34 | +> 不要随意删用户及权限 |
| 35 | +
|
| 36 | +# ✨ 技术架构 |
| 37 | + |
| 38 | +## 后端 |
| 39 | + |
| 40 | +- **Spring Boot**:核心框架,提供 RESTful API 支持并实现快速开发与配置。 |
| 41 | +- **MyBatis Plus**:增强型 ORM 框架,简化数据库操作。 |
| 42 | +- **Druid**:高性能数据库连接池,支持 SQL 监控与统计功能。 |
| 43 | +- **JWT**:用于用户认证和授权的安全方案。 |
| 44 | +- **Swagger**:自动生成接口文档,便于开发和测试。 |
| 45 | +- **Lombok**:通过注解生成代码,提高开发效率。 |
| 46 | +- **Hutool**:功能丰富的 Java 工具库,加速开发流程。 |
| 47 | + |
| 48 | +## 前端 |
| 49 | + |
| 50 | +- **Vue 3**:基于 Composition API 的现代化前端框架。 |
| 51 | +- **Pinia**:轻量级状态管理工具,替代 Vuex。 |
| 52 | +- **Vite**:极速开发和构建工具,提升开发效率。 |
| 53 | +- **TypeScript**:类型安全,提升代码维护性。 |
| 54 | +- **Arco Design**:企业级 UI 组件库,提供优雅设计风格。 |
| 55 | +- **Axios**:用于与后端 API 通信的轻量级 HTTP 客户端。 |
| 56 | +- **Codemirror**:代码编辑器,支持高亮 SQL 和 JSON 数据。 |
| 57 | + |
| 58 | +--- |
| 59 | + |
| 60 | +# 🚀 快速开始 |
| 61 | + |
| 62 | +## 直接运行 |
| 63 | + |
| 64 | +1. **下载发布包** |
| 65 | + 从 [Release 页面](https://github.com/FearlessPeople/DBApi/releases/) 下载最新版本的发布包的tar.gz包并解压。 |
| 66 | + |
| 67 | +2. **配置数据库** |
| 68 | + 1. 新建数据库`CREATE DATABASE dbapi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;` |
| 69 | + 2. 初始化数据库`init.sql`在resource目录下:`source /opt/dbapi-web-0.0.2-SNAPSHOT/init.sql;` |
| 70 | + 3. 修改解压后的 `config/application.yml`,配置数据库连接信息。 |
| 71 | + 4. 修改解压后的 `config/application.yml`,配置redis连接信息。 |
| 72 | + |
| 73 | +3. **启动应用** |
| 74 | + 切换到 `bin` 目录,根据操作系统运行以下命令: |
| 75 | + - Linux/MacOS: `sh dbapi.sh` |
| 76 | + - Windows: 双击运行 `dbapi.bat` |
| 77 | + |
| 78 | +4. **访问系统** |
| 79 | + 打开浏览器访问 [http://localhost:8088/](http://localhost:8088/) 进入登录页面。 |
| 80 | + |
| 81 | +--- |
| 82 | + |
| 83 | +## 源码运行 |
| 84 | + |
| 85 | +### 环境要求 |
| 86 | + |
| 87 | +- **JDK**:11 及以上版本 |
| 88 | +- **Spring Boot**:2.5 及以上版本 |
| 89 | +- **数据库**:MySQL / PostgreSQL / MongoDB |
| 90 | +- **Maven**:3.6 及以上版本 |
| 91 | + |
| 92 | +### 步骤 |
| 93 | + |
| 94 | +1. **克隆项目** |
| 95 | + |
| 96 | + ```bash |
| 97 | + git clone https://github.com/yourusername/DBApi.git |
| 98 | + cd DBApi |
| 99 | + ``` |
| 100 | + |
| 101 | +2. **初始化数据库** |
| 102 | + |
| 103 | + 创建数据库 |
| 104 | + |
| 105 | + ```sql |
| 106 | + CREATE |
| 107 | + DATABASE dbapi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; |
| 108 | + ``` |
| 109 | + |
| 110 | + 初始化表:`init.sql`在resource目录下 |
| 111 | + |
| 112 | + ```sql |
| 113 | + source src/main/resources/init.sql |
| 114 | + ``` |
| 115 | + |
| 116 | +3. **修改数据库配置** |
| 117 | + |
| 118 | + 根据需要修改 `src/main/resources/application.yml` 文件中的数据库配置: |
| 119 | + |
| 120 | + ```yaml |
| 121 | + spring: |
| 122 | + datasource: |
| 123 | + url: jdbc:mysql://localhost:3306/dbapi |
| 124 | + username: root |
| 125 | + password: your_password |
| 126 | + ``` |
| 127 | + |
| 128 | +4. **运行项目** |
| 129 | + |
| 130 | + 使用 IDE 或命令行运行 `src/main/java/com/dbapi/DBApiApplication.java` 文件启动项目。 |
| 131 | + |
| 132 | +# 📖 使用说明 |
| 133 | + |
| 134 | +1. **登录系统** |
| 135 | + 使用默认管理员账户登录系统(初始用户名:`admin`,密码:`admin`)。登录成功后,可根据需求修改管理员密码。 |
| 136 | + |
| 137 | +2. **配置数据源** |
| 138 | + 在 "数据源管理" 页面点击 "新增数据源",填写数据库连接信息,包括数据库类型、URL、用户名和密码等。完成后点击 "测试连接" 确保连接成功。 |
| 139 | + |
| 140 | +3. **创建接口** |
| 141 | + - 在 "API接口" 页面点击 "新建接口" 按钮。 |
| 142 | + - 填写接口的基本信息(如名称、路径、描述等)。 |
| 143 | + - 在接口设计区编写 SQL 查询语句以及参数配置。 |
| 144 | + - 保存后可以在生成的 API 列表中查看并测试新创建的接口。 |
| 145 | + |
| 146 | +4. **调用 API** |
| 147 | + 使用 Postman、cURL 或其他 HTTP 客户端调用生成的 RESTful API。调用时注意: |
| 148 | + - 请求 URL 格式:`http://<host>:<port>/api/<your_endpoint>` |
| 149 | + - 根据接口的设计发送 GET、POST 等方法的请求,并附加必要的参数。 |
| 150 | + |
| 151 | +5. **查看日志** |
| 152 | + 在 "日志管理" 页面可以查看所有 API 的调用记录,包括请求时间、调用参数、返回结果及可能的错误信息。这对排查问题和优化性能非常有用。 |
| 153 | + |
| 154 | +6. **管理用户权限** |
| 155 | + - 在 "用户管理" 页面添加新用户并分配角色。 |
| 156 | + - 通过 "角色管理" 为不同角色配置权限 |
| 157 | + |
| 158 | + |
| 159 | +# 运行截图 |
| 160 | + |
| 161 | +登录截图 |
| 162 | + |
| 163 | + |
| 164 | +接口列表 |
| 165 | + |
| 166 | + |
| 167 | +新建接口 |
| 168 | + |
| 169 | + |
| 170 | +接口设计 |
| 171 | + |
| 172 | + |
| 173 | +接口文档 |
| 174 | + |
| 175 | + |
| 176 | +接口调用 |
| 177 | + |
| 178 | + |
| 179 | +数据源列表 |
| 180 | + |
| 181 | + |
| 182 | +角色列表 |
| 183 | + |
| 184 | + |
| 185 | +给角色分配权限 |
| 186 | + |
| 187 | + |
| 188 | +用户中心 |
| 189 | + |
| 190 | + |
| 191 | +用户列表 |
| 192 | + |
| 193 | + |
| 194 | + |
| 195 | +# 🎓 学习交流 |
| 196 | + |
| 197 | +- **GitHub 项目主页** |
| 198 | + [https://github.com/FearlessPeople/DBApi](https://github.com/FearlessPeople/DBApi) |
| 199 | + 欢迎提交 Issue 和 Pull Request,为项目贡献代码或提出建议。 |
| 200 | + |
| 201 | +- **常见问题与文档** |
| 202 | + 请访问 [项目 Wiki](https://github.com/FearlessPeople/DBApi/wiki) 查看详细使用文档和常见问题解答。 |
| 203 | + |
| 204 | +**欢迎 Star 项目并分享给更多人,一起让 DBApi 更加完善!** |
| 205 | + |
0 commit comments