22
33本篇主要介绍在本地启动TinyEngine前端并对接本地Java版本后端方式(默认为前端使用mockServer方式)进行开发联调。
44
5- Tips:
6- - 对接Node.js版本服务端与Java版本服务端过程类似。另外Node.js版本后续不再进行新特性开发,只维护基础功能,建议使用Java版本服务端。
7- - 本篇以Clone前端源码方式启动为例,使用CLI创建新设计器启动前端方式对接后端与之类似。
5+ ** Tips:**
6+
7+ - 对接 Node.js 版本服务端与 Java 版本服务端过程类似。另外 Node.js 版本后续不再进行新特性开发,只维护基础功能,建议使用 Java 版本服务端。
8+ - 本篇以 Clone 前端源码方式启动为例,使用 CLI 创建新设计器启动前端方式对接后端与之类似。
89
910## 启动前的准备
1011
@@ -13,85 +14,106 @@ Tips:
1314
1415## 启动服务
1516
16- ### 1.前端启动
1717
18- - 把前端项目工程导入 vscode 后下载依赖,进入项目根目录下执行 ` pnpm i `
18+ ### 1.后端启动
1919
20- - 在项目根目录下执行构建` pnpm run setup `
20+ #### 1.1 新建数据库
21+ 首先新建 MySQL 数据库连接,以 Navicat 为例:
2122
22- - 修改文件配置
23+ 选择“新建连接”->“MySQL”->“下一步”->输入连接名称、用户名、密码->“测试连接”->“确定”
2324
24- 修改 ` tiny-engine/designer-demo/env/.env.development ` 中的 VITE_ORIGIN 变量为自己本地的服务端地址端口
25+ 如下图所示
2526
26- ![ ] ( ./imgs/java-debugging-image33 .png )
27+ ![ ] ( ./imgs/java-debugging-image36 .png )
2728
28- 修改` tiny-engine/designer-demo/engine.config.js ` 中的 material 获取物料组件
29+ 继续新建数据库:
30+ “新建数据库”->输入数据库名称
2931
30- ![ ] ( ./imgs/java-debugging-image34.png )
32+ 如下图所示
3133
32- - 在项目根目录下执行启动 ` pnpm run serve:frontend `
34+ ![ ] ( ./imgs/java-debugging-image37.png )
3335
34- 出现如下图所示表示启动成功,启动成功后浏览器会自动打开设计器页面
36+ #### 1.2 执行 SQL 文件导入数据库表与基础数据
3537
36- ![ ] ( ./imgs/java-debugging-image35.png )
38+ ** 在按照上述操作后的新建的数据库名称上右键选择“运行 SQL 文件”->在文件项选择下面两个 SQL 文件导入运行 **
3739
38- ### 2.后端启动
40+ 如下图所示
3941
40- #### 新建数据库
42+ ![ ] ( ./imgs/java-debugging-image38.png )
4143
42- ** 步骤 1 鼠标右键选择“新建连接”->“MySQL”->“下一步”->输入连接名称、用户名、密码->“测试连接”->“确定” **
44+ 执行以下 SQL 文件去创建设计器涉及的表(按照序号依次导入执行),目录如下:
4345
44- 如下图所示
46+ ` tiny-engine-backend-java/app/src/main/resources/sql/mysql/*.sql `
4547
46- ![ ] ( ./imgs/java-debugging-image36.png )
4748
48- ** 步骤二 在步骤一新建的连接上右键选择“新建数据库”->输入数据库名称 **
49+ 执行以下 SQL 文件去添加表的基础数据(按照日期依次导入执行),目录如下:
4950
50- 如下图所示
51+ ` tiny-engine-backend-java/app/src/main/resources/sql/mysql/init_data*.sql `
5152
52- ![ ] ( ./imgs/java-debugging-image37.png )
53+ ** Tips: ** 多条 SQL 依次导入比较麻烦,可以拼接成一条 SQL 一次性导入该 SQL:
5354
54- #### 执行脚本文件
55+ ``` sh
56+ cd docker-deploy-data/mysql/init
57+ cat ./* .sql > complete.sql
58+ # 导入complete.sql
59+ ```
5560
56- ** 步骤一 在按照上述操作后的新建的数据库名称上右键选择“运行 SQL 文件”->在文件项选择下面两个 SQL 文件导入运行**
5761
58- 如下图所示
62+ #### 1.3 修改数据库等相关的配置项
5963
60- ![ ] ( ./imgs/java-debugging-image38.png )
64+ 在 ` tiny-engine-backend-java/app/src/main/resources/application-dev.yml ` 文件中设置自己的端口号 ` port ` (和前端 ` tiny-engine/designer-demo/env/.env.development ` 文件中的 ` VITE_ORIGIN ` 变量中的端口号保持一致)、还有数据库连接信息(用户名 ` username ` 、密码 ` password ` 、 ` URL ` )
6165
62- 执行以下 SQL 文件去创建设计器涉及的表,目录如下:
66+ ![ ] ( ./imgs/java-debugging-image39.png )
6367
64- ` tiny-engine-backend-java/app/src/main/resources/sql/mysql/create_all_tables_ddl_v1.mysql.sql `
68+ #### 1.4 启动后端项目
6569
66- 执行以下 SQL 文件去添加表的基础数据,目录如下:
70+ ** 步骤一 ** :先安装 Maven,若没有从 [ Maven 官网 ] ( https://maven.apache.org/download.cgi ) 下载并解压,Maven 3.5 以上即可,并配置环境变量
6771
68- ` tiny-engine-backend-java/app/src/main/resources/sql/mysql/init_data_for_test.sql `
72+ ** 步骤二 ** :在项目根目录执行构建打包
6973
70- #### 修改数据库等相关的配置项
74+ ``` sh
75+ mvn clean package
76+ ```
7177
72- 在 ` tiny-engine-backend-java/app/src/main/resources/application-dev.yml ` 文件中设置自己的端口号 port(和前端 ` tiny-engine/designer-demo/env/.env.development ` 文件中的 VITE_ORIGIN 变量中的端口号保持一致)、还有数据库连接信息(用户名 username、密码 password、URL)
78+ ** 步骤三 ** :在项目根目录执行启动
7379
74- ![ ] ( ./imgs/java-debugging-image39.png )
80+ ``` sh
81+ java -jar app/target/tiny-engine-app-1.0-SNAPSHOT.jar
82+ ```
7583
76- #### 启动后端项目
84+ 执行后终端中看到下图界面表示后端服务启动成功:
7785
78- 步骤一 先安装 maven,若没有从 [ Maven 官网 ] ( https://maven.apache.org/download.cgi ) 下载并解压,Maven 3.5 以上即可,并配置环境变量
86+ ![ ] ( ./imgs/java-debugging-image40.png )
7987
80- 步骤二 在项目根目录执行构建打包` mvn clean package `
88+ Swagger 访问链接路径:
89+ ` localhost:9091/swagger-ui.html `
8190
82- 步骤三 在项目根目录执行启动 ` java -jar app/target/tiny-engine-app-1.0-SNAPSHOT.jar `
91+ ** 可详细查看接口 API ** :
8392
84- 按照以上步骤执行前后端操作,即能成功启动本地前后端关联进行调试
93+ ![ ] ( ./imgs/java-debugging-image42.png )
8594
86- ![ ] ( ./imgs/java-debugging-image40.png )
95+ ### 2. 前端启动
8796
88- 前后端启动成功后页面会自动弹出,如下可看连接数据库数据接口调通能返回正常数据
97+ - 把前端项目工程导入 VSCode 后下载依赖,进入项目根目录下执行 ` pnpm i `
8998
90- ![ ] ( ./imgs/java-debugging-image41.png )
99+ - 修改文件配置
91100
92- 三、swagger 访问链接路径:
93- ` localhost:9091/swagger-ui.html `
101+ 修改 ` tiny-engine/designer-demo/env/.env.development ` 中的 ` VITE_ORIGIN ` 变量为自己本地的服务端地址端口:
94102
95- ** 可详细查看接口 api **
103+ ![ ] ( ./imgs/java-debugging-image33.png )
96104
97- ![ ] ( ./imgs/java-debugging-image42.png )
105+ - 在项目根目录下执行启动
106+
107+ ``` sh
108+ pnpm dev:withAuth
109+ ```
110+
111+ 出现如下图所示表示启动成功,启动成功后浏览器会自动打开设计器页面:
112+
113+ ![ ] ( ./imgs/java-debugging-image35.png )
114+
115+ 前后端启动成功后页面自动弹出,如下可看连接数据库数据接口调通能返回正常数据:
116+
117+ ![ ] ( ./imgs/java-debugging-image41.png )
118+
119+ 按照以上步骤执行前后端操作,即已成功启动本地前后端关联进行调试。
0 commit comments