# diboot 新手训练营
初步了解diboot之后,跟随本教程一步步玩转diboot。
# 1. 克隆playground项目
以IDEA为例:
- "File -> New -> Project from version control..."菜单打开克隆项目对话框:
- URL中输入如下playground项目路径,指定项目本地路径(避免中文路径),点击 Clone 按钮:
https://gitee.com/dibo_software/playground.git
1
提示:如没有git环境,也可以通过访问 playground 项目 (opens new window) 下载项目zip包导入的方式创建项目。
- 待克隆完成后,在右侧Maven视图中,添加demo项目下的pom.xml
# 2. 准备空数据库
- 在你的开发库中创建一个数据库实例,比如: playground
-- mysql示例
CREATE DATABASE playground DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
1
2
2
- 根据你本地情况修改application.properties中的配置参数,比如:
- 数据库连接信息:
- spring.datasource.url=
- spring.datasource.username=
- spring.datasource.password=
- 前端项目相对路径(前端Vue框架选择antd还是element,默认是antd):
- diboot.devtools.output-path-admin-ui=diboot-antd-admin/
- 默认本地文件存储路径:
- diboot.component.file.storage-directory=D:/temp/playground
- 数据库连接信息:
# 3. 运行demo项目
- 点击 "Add Configuration...",添加DemoApplication启动类配置。 添加的应用类型可以选择"Spring Boot" 或 "Application"(社区版IDEA)。
注意:取消勾选 "JMX agent" 选项,以免报JMX异常。
- 进入devtools 正常情况下启动完毕会打印如下devtools入口信息:
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-- Diboot devtools v2.x.x 初始化完成:
-> URL: http://localhost:8080/api/diboot/index.html
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
1
2
3
4
2
3
4
如您的IDEA启动完成并未打印出该信息,则您的版本对maven的provided支持有差异,需要手动删除devtools依赖配置中的:
<scope>provided</scope>
1
如下图所示:
提示:devtools是开发过程工具,正式打包前需要剔除devtools依赖。
# 4. 使用devtools初始化代码
- 点击控制台中打印出的URL,进入devtools操作页面。(个人用户初次使用需要扫码)
- 初次启动devtools会提示初始化组件的基础代码(为了方便自定义修改,devtools将controller等代码生成到本地项目中)。 依次点击各组件的"生成代码"按钮。
打开demo目录下的java目录,将会看到相关组件的初始化代码已生成。
注意:如果启动前端后发现验证码无法显示,则需要检查是否执行了这个步骤并重启了项目。登录验证相关的controller需要此步骤中生成。
# 5. 重启demo项目,并启动前端
- 重启DemoApplication,确保新生成的后端代码生效
- 切换到对应的前端路径下,(需要预先安装node运行环境),依次运行
yarn install
yarn run serve
# OR
npm install
npm run serve
1
2
3
4
5
2
3
4
5
启动成功后,打开链接进入前端,输入账号: admin/123456 登录系统,即可进入管理后台。
# 6. 使用devtools生成后端代码
- 点击"数据表管理"菜单,在这里可以建表、维护表字段与关联关系、索引、生成及更新后端代码等。
devtools功能设计的原则是简单易用,您可以自行体验相关功能。如需更多帮助可查阅devtools文档
# 7. 使用devtools生成前端代码
devtools除了具备后端能力外,还有强大的前端组件编排和CRUD导入导出等完整功能的生成能力 (devtools订阅用户专享)。
- 点击控制台中打印出的devtools URL,进入devtools操作页面,点击"PC前端功能生成" 或 "前端面板组件生成" 或 "移动端前端生成", 在这里可以配置生成前端页面增删改查、导入导出、弹框表单、多tab页展示、树形结构、时间轴等各种场景的前端代码生成。
关于devtools前端生成功能更多文档,可查阅devtools文档。
至此,您已经了解并上手了diboot,如需了解更多可以: