# diboot 新手训练营

初步了解diboot之后,跟随本教程一步步玩转diboot。

# 1. 下载新手体验包

# 2. 在IDE中打开并配置playground项目

  • 以IDEA为例,通过"Open..."菜单打开解压后的playground目录: 打开项目

  • 在右侧Maven视图中,添加demo项目下的pom.xml 设置maven项目

  • 在你的开发库中创建一个数据库实例,比如: playground

-- mysql示例
CREATE DATABASE playground DEFAULT CHARSET utf8 COLLATE utf8_general_ci;
  • 根据你本地情况修改application.properties中的配置参数,比如:
    • 数据库连接信息:
      • spring.datasource.url=
      • spring.datasource.username=
      • spring.datasource.password=
    • 前端项目相对路径(前端Vue框架选择antd还是element,默认是antd):
      • diboot.devtools.output-path-frontend=diboot-antd-admin/
    • 默认本地文件存储路径:
      • files.storage.directory=D:/temp/playground

# 3. 运行demo项目

  • 点击 "Add Configuration...",添加DemoApplication启动类配置。 添加的应用类型可以选择"Spring Boot" 或 "Application"(社区版IDEA)。 运行

  • 启动DemoApplication 正常情况下启动完毕会打印如下devtools入口信息:

-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-- Diboot devtools v2.x.x 初始化完成: 
-> URL: http://localhost:8080/api/diboot/index.html
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

如您的IDEA启动完成并未打印出该信息,则您的版本对maven的provided支持有差异,需要手动删除devtools依赖配置中的:

<scope>provided</scope>

如下图所示: 移除provided

提示:devtools是开发过程工具,正式打包前需要剔除devtools依赖。

# 4. 使用devtools

  • 点击控制台中打印出的URL,进入devtools操作页面。(个人用户初次使用需要扫码)
  • 初次启动devtools会提示初始化组件的基础代码(为了方便自定义修改,devtools将controller等代码生成到本地项目中)。 依次点击各组件的"生成代码"按钮。 生成初始代码 打开demo目录下的java目录,将会看到相关组件的初始化代码已生成。
  • 点击"数据表管理"菜单,在这里可以建表、维护表字段与关联关系、生成及更新后端代码等。 数据表管理

devtools功能设计的原则是简单易用,您可以自行体验相关功能。如需更多帮助可查阅devtools文档

# 5. 重启demo项目,启动前端

  • 重启DemoApplication,确保新生成的后端代码生效
  • 切换到前端路径下,(需要预先安装node运行环境),依次运行
npm install
npm run serve

启动成功后,打开链接进入前端,输入账号: admin/123456 登录系统,即可进入管理后台。 登录

# 6. 使用devtools前端生成能力 (企业版)

devtools除了具备后端能力外,还有强大的前端组件编排和CRUD导入导出等完整功能的生成能力。

  • 点击控制台中打印出的devtools URL,进入devtools操作页面,点击"前端功能生成" 或“ "前端面板生成", 在这里可以配置生成前端页面增删改查、导入导出、弹框表单、多tab页展示、树形结构、时间轴等各种场景的前端代码生成。

关于devtools前端生成功能如需更多帮助可查阅"企业版技术白皮书"。

至此,您已经了解并上手了diboot,如需了解更多可以:

# 进阶 - 深入学习