Skip to content

Commit 9da559e

Browse files
author
fangzheng
committed
first add
0 parents  commit 9da559e

File tree

217 files changed

+9288
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

217 files changed

+9288
-0
lines changed

.gitignore

+28
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Compiled class file
2+
*.class
3+
4+
# Log file
5+
*.log
6+
7+
# BlueJ files
8+
*.ctxt
9+
10+
# Mobile Tools for Java (J2ME)
11+
.mtj.tmp/
12+
13+
# Package Files #
14+
*.jar
15+
*.war
16+
*.nar
17+
*.ear
18+
*.zip
19+
*.tar.gz
20+
*.rar
21+
22+
# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
23+
hs_err_pid*
24+
replay_pid*
25+
.idea
26+
**/target/
27+
28+
*.pid

LICENSE

+674
Large diffs are not rendered by default.

README.md

+205
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,205 @@
1+
![DBApi](https://socialify.git.ci/FearlessPeople/DBApi/image?description=1&forks=1&issues=1&language=1&name=1&owner=1&pattern=Circuit%20Board&pulls=1&stargazers=1&theme=Light)
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+
![login-img](docs/login-img.png)
163+
164+
接口列表
165+
![api-list1](docs/api-list1.png)
166+
167+
新建接口
168+
![api-create](docs/api-create.png)
169+
170+
接口设计
171+
![api-design](docs/api-design.png)
172+
173+
接口文档
174+
![api-doc](docs/api-doc.png)
175+
176+
接口调用
177+
![api-request](docs/api-request.png)
178+
179+
数据源列表
180+
![datasource](docs/datasource.png)
181+
182+
角色列表
183+
![role-list](docs/role-list.png)
184+
185+
给角色分配权限
186+
![set-permission](docs/set-permission.png)
187+
188+
用户中心
189+
![user-center](docs/user-center.png)
190+
191+
用户列表
192+
![user-list](docs/user-list.png)
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

Comments
 (0)