搭建SpringBoot脚手架工程系列(1):Spring Initializr的超能力

前言

SpringBoot作为Java后端最主流的技术栈，是每个Java程序员必备的技能。在微服务架构流行的时代，一个普通的企业级项目通常会有5-10个微服务，业务复杂的企业级项目甚至会有20个以上的微服务。这时候就需要一个脚手架项目，可以帮助开发人员在项目需要时，能够快速搭建新的微服务。

快速搭建

Spring官网提供搭建Spring Boot模版项目的功能，我们可以直接利用官方平台，来为我们搭建脚手架项目助力，避免一些没有必要的版本冲突问题。

• Spring官网地址：
  start.spring.io
• 界面介绍
  
• 操作步骤
  1.选择项目依赖管理工具，如Gradle/Maven。
  2.选择你的项目语言，一般SpringBoot项目还是以Java为主，有的公司在一些探索性项目上会使用Kotlin或Groovy但比较少见。
  3.选择SpringBoot的版本，目前最新版已经到了SpringBoot 3.0。
  4.选择打包类型以及JDK版本，打包类型选Jar，在前后端分离的时代，War包已经很少有公司会使用了，然后Java版本要选17，因为SpringBoot 3.0的JDK版本要求最低是Java 17。
  5.添加需要的依赖，点击“ADD DEPENDENCIES”按钮可以看到常用的依赖选项，因为是脚手架工程，考虑到没有必要添加过多的依赖，于是添加了最常用的几项，如Spring MVC，Spring Data JPA，DevTools，Lombok，MySQL驱动。
  6.最后点击“GENERATE”按钮生成即可。

脚手架工程

• 项目结构
  使用Idea打开Spring官网生成的项目，项目结构如截图所示：
  
  在项目根目录下使用./gradlew bootRun命令启动应用，不出意外会报错，因为项目中没有配置数据源。
  

• 配置数据源
  springboot官网默认生成的配置文件是application.properties，我们将文件类型修改为yml，然后在application.yml配置数据源（该配置前提条件是本地需要先启动一个MySQL数据库，可以使用docker启动，如果不了解docker可以自行百度/谷歌搜索一下，这里不重点介绍了)。

  spring:
  datasource:
  url: jdbc:mysql://localhost:3306/xxx_test
  username: root
  password: password
  driver-class-name: com.mysql.cj.jdbc.Driver
  

  再次使用./gradlew bootRun命令启动应用，可以看到Tomcat已经正常启动了:
  

• 测试接口
  新建ScaffoldController用于测试api调用是否正常，如以下截图是ScaffoldController返回的内容，接口调用成功会返回“scaffold api test”。
  
  我们使用Postman测试下，不出意外接口404了，因为本地服务并没有加载新建的ScaffoldController，新建的接口自然Not Found。
  按照一般的本地开发步骤，这个时候可能就得开发人员重新启动下本地服务了。但别忘了我们的项目引用了spring-boot-devtools的依赖，所以只需要重新编译类文件，让devtools感知到class有变化让其本地服务自动重启即可。
  
  点击Build->Recompile 'xxx.java’后，我们再次用Postman测试，这时候发现接口可以返回测试数据，这表明项目的api调用没有问题，同时也证明了devtools工具的热部署是生效的。
  （可能有小伙伴会说可以设置自动编译，这样就不用再手动recompile一次了，这个看个人习惯吧。我之所不设置自动编译是因为一旦自动编译后，稍微一丁点的修改就会让应用频繁的重启，我觉得这并没有太大意义，通常本地开发更多是一个功能点初步写完后才会想去测试。）
  

结语

到这里一个简单SpringBoot脚手架项目就利用Spring Initializr的能力搭建成功并验证完成。
但一个企业级的脚手架项目还需要考虑的更多，比如：统一团队代码格式，代码质量检查，代码提交检查等，碍于篇幅就不在这里深入，请查本系列下一篇内容。
搭建SpringBoot脚手架工程系列(2):代码格式化/质量审核/提交检查