万事开头难—第一个SpringBoot应用

学习开发SpringBoot之初遇到的第一个拦路虎竟然是创建SpringBoot应用，网上选她千百度，蓦然回首发现网上的教程多多少少都存在问题。什么问题呢？首先都是都是创建DEMO，其次创建过程中遇到的选项含义不仅没有解释，而且很多选项选错了。为避免大家走同样的弯路，在这里重新编写了一篇基础教程。

废话少说，下面正式开始教程：

1. 第一步干什么呢？当然是打开IDEA啦

首先打开IDEA，点击 +Create New Project. 开始创建一个新项目：

打开IDEA新建项目

下面出现了创建新项目的第一步，请按照下图上的步骤选择即可：

选择初始化工具及模板选择

简单介绍一下上面的选项：

• 1. 选择左侧的Spring Initializr选项：Spring Initializr是官方提供的一个用来初始化的工具，通过在Spring Initializr的界面窗口上简单的配置，就能轻松完成Spring Boot的项目的初始化。
• 2. 选择顶部的Project SDK选项：通过这个项目可以选择项目运行JDK版本环境，这里默认读取的是当前用户的JAVA_HOME环境变量，如果这里没有任何的默认选项，请参考前面JDK环境搭建的章节。
• 3. 选择顶部的Initializr Service URL：选择生在项目模板的服务器地址，这里选择的是默认选项Default : https://start.spring.io，（如果默认的模板无法满足需求还可以选择Custom从指定的链接加载模板，动手能力强的同学还可以选择本地搭建spring Initializr服务器，这部分知识不是本节重点，这里不做拓展了，大家可以自行百度）还有一点需要注意，idea默认使用https://start.spring.io提供的在线模板，所以建议执行后续步骤的过程中保证网络畅通。
• 4. 以上选择完成后，点击Next按钮进入下一步。

2. 第二步 填写项目的元数据（Project Metadata）

所谓元数据也就是基本信息的意思，包含Group、Artifact、Name、Package等信息，如下图所示，下面将详细讲解如何填写这些信息：

填写项目元数据页面

从上图可以看到，需要填写及选择的内容一共10项：

• Group：创建项目的组织或团队的唯一标识，通常是com + 公司名称，按照国际惯例，这里建议所有的字母都使用小写
• Artifact：是项目的唯一的标识符，实际对应项目或系统的名称。按照国际惯例，这里建议所有的字母都使用小写
• Type：这里一共有4个选项，分别是Maven Project、Maven POM、Gradle Project和Gradle Config，其中Maven Project和Maven POM两个选项用于创建Maven方式管理的Java项目，区别是Maven Project帮我们生成整个完整的工程结构，而Maven POM选项只会在工程目录下生成pom.xml，没有src等等结构，所以对于新手建议选择Maven Project。下面的两个选项Gradle Project和Gradle Config用于创建Gradle方式管理的Java项目，和前两个一样，Gradle Project帮我们生成整个完整的工程，Gradle Config初始化的项目只有build.gradle配置文件。据了解国内很多大公司的项目都是使用Maven管理的，所以对于初学者建议选择Maven Project
• Language：语言也提供了3个选项，分别是Java、Kotlin和Groovy，Java应该不用多做介绍了，Kotlin和Groovy都是基于Java平台的面向对象的编程语言，业界有人认为Kotlin将会渠道Java的霸主地位，Kotlin提供了互操作性，代码安全性和准确性比较受程序员们的欢迎，大家不用也没关系，可以查资料了解一下这两种语言，丰富知识的宽度
• Packaging：提供了两种打包方式Jar和War，其中Jar的打包方式用于在服务器直接运行或提供给其他系统集成调用。War一般用于在Tomcat平台部署。这里大家根据自己的部署环境和用途进行选择
• Java Version：提供了8，11和15三个选项，大家根据自己的Java环境自行选择就好
• Version：项目或系统的版本号，后续可以修改，这里建议使用默认值
• Name：项目或系统的名称，可以是Artifact。（填写Artifact项完成后，初始化工具会自动使用Artifact的内功填充）
• Description：项目功能及用途的介绍，作为Jar包对外提供时，使用者可以通过 Description快速了解项目的能力。这个信息可以后期修改，可以直接跳过。
• Package：项目或系统的唯一标识，可以自定义，默认是Group + Artifact。（当填写Group和Artifact两项完成后，初始化工具会自动使用这两项的内容填充）

以上信息填写完成后，请点击右下角的Next按钮进入下一步。

3. 第三步 选择项目的依赖（Dependencies）

项目的依赖选项多到让人眼花缭乱措手不及，该从哪里下手呢？选哪个合适呢？

1）选择Spring Boot版本

Spring Boot版本选择界面
如果上图所示，Spring Boot的版本也有很多，如果大家没有必须要选择的版本，建议选择使用最新的版本，截止到2020年10月8日，最新的Spring Boot稳定版本是2.3.4，注意请尽量不要选择使用 (SNAPSHOT) 结尾版本，这些版本相当于开发版本，会存在一些未知的Bug，建议大家选择稳定版本，避免踩坑。

2）选择初始依赖库

选择初始依赖库的页面
界面共分为三列：左列是分类， 中间列是待选择的依赖库，右列是已选择的依赖库。
在这里需要说明一下，依赖库在项目创建完成后也可以添加，这里可以直接点击Next按钮跳过。
下面我说一下我常用的一些依赖库：

类别	依赖库
Developer Tools	Spring Boot DevTools
Web	Spring Web
SQL	Spring Data JPA

下面详细说一下这些依赖库的作用：

• Spring Boot DevTools：提供了热部署的能力，能节省很多程序员开发过程中调试部署的时间，强烈推荐使用。网上也有很多关于热部署原理的文章，建议大家拓展阅读一下
• Spring Web：Spring MVC核心组件之一，常用于用开发网络接口服务，使用Apache Tomcat作为运行环境。是开发网络服务的必要组件
• Spring Data JPA：Spring Data JPA是Spring，基于Hibernate开发的一个JPA框架，提供了更简单更优雅的访问数据库的方式，如果在项目中使用了关系型数据库，建议勾选上。
  完成选择依赖库以后，请点击右下角的Next按钮进入下一步。

4. 第四步 选择初始化位置

初始化位置选择页面

这也是初始化项目的最后一步了，填写项目的名称以及选择文件的初始化位置。

• Project name：项目或系统名称，可以是在第二步填写的Artifact，同时这个也是项目源代码文件夹的名称，建议使用驼峰命名法，提升可读性。
• Project location：选择项目代码初始化的位置，点击右侧的...按钮选择具体的路径。
  以上信息填写完成后，请点击右下角的Next按钮完成项目初始化。

5. 最后

项目创建完成后的目录结构
完成项目创建后您将看到以上目录结构，其中XXXApplication是项目的入口。
项目运行控制菜单
在窗口的右上方找到上图的几个按钮，点击中间的绿色三角按钮，即可运行项目。
在运行的过程中，您可能会遇到Failed to configure a DataSource: 'url' attribute is not specified and no embedd的错误：
运行错误截图
请参考我前面的文章Spring Boot应用报错：Failed to configure a DataSource: 'url' attribute is not specified and no embedd来解决此问题。
项目运行成功的截图
当您解决完所有问题后，再次运行后看到以上的截图中的两行日志，那么恭喜您，您的第一个Spring Boot项目创建完成了。

写在最后：大家在创建项目的过程中，如果遇到任何问题，请在评论区留言交流。