初始SpringBoot：详解特性和结构

??JAVA码农探花：

?? 推荐专栏：《SSM笔记》《SpringBoot笔记》

??学无止境，不骄不躁，知行合一

前言

一、SpringBoot项目结构

1.启动类的位置

2.pom文件

start

parent

打包

二、依赖管理特性

三、自动配置特性

总结

前言

SpringBoot项目结构，特性介绍（常用到的基本都讲解了，很详细，基于官方文档讲解）。

一、SpringBoot项目结构

IDEA创建非常简单，不是主要讲解，我使用的是IDEA2023.3（这里默认你Maven环境都配好了）

在这里插入图片描述

创建完成后的文件结构如下：

在这里插入图片描述

java：java包下存放的是开发创建的类、接口等。
- 这里restart是我的工程名，同时它就是项目工程文件夹，开发所创建的包、类基本都在这文件夹下。
- SpringBoot启动类（这里的启动类是RestartApplication，SpringBoot项目创建完成后默认的启动类名称是首字母大写的项目工程名+Application）放在工程文件夹下，即：工程文件夹 / 启动类。不在嵌套文件夹。
resources
- 存放静态资源文件的地方：html、css、照片、配置文件（properties文件，yaml文件等）。
pom.xml
- 引入依赖文件，用于引入你工程所需要的依赖。

1.启动类的位置

官方建议最佳实战就是将启动类放在工程文件夹下的第一层，不需要再嵌套文件夹。
官方说：@SpringBootApplication 注解一般都是注解在启动类上的。它默认会扫描当前类下的所有子包（也就是与当前启动类同级文件夹的包及其下的所有包，如下图的customer、order包及其下的所有包）。例如，如果你正在编写一个JPA应用程序，你的 @Entity 类只有定义在启动类的子包下才能被扫描加载到。这样的好处也显而易见，@SpringBootApplication 默认只会扫描加载你项目工程中的组件。

<span style="color:#000000"><span style="background-color:#fafafa"><code class="language-java"><span style="color:#708090">//初始创建的SpringBoot项目的启动类都是如下代码：</span>
<span style="color:#0077aa">import</span> org<span style="color:#999999">.</span>springframework<span style="color:#999999">.</span>boot<span style="color:#999999">.</span>SpringApplication<span style="color:#999999">;</span>
<span style="color:#0077aa">import</span> org<span style="color:#999999">.</span>springframework<span style="color:#999999">.</span>boot<span style="color:#999999">.</span>autoconfigure<span style="color:#999999">.</span>SpringBootApplication<span style="color:#999999">;</span><span style="color:#999999">@SpringBootApplication</span>
<span style="color:#0077aa">public</span> <span style="color:#0077aa">class</span> RestartApplication <span style="color:#999999">{</span><span style="color:#0077aa">public</span> <span style="color:#0077aa">static</span> <span style="color:#0077aa">void</span> <span style="color:#dd4a68">main</span><span style="color:#999999">(</span>String<span style="color:#999999">[</span><span style="color:#999999">]</span> args<span style="color:#999999">)</span> <span style="color:#999999">{</span>SpringApplication<span style="color:#999999">.</span><span style="color:#dd4a68">run</span><span style="color:#999999">(</span>RestartApplication<span style="color:#999999">.</span><span style="color:#0077aa">class</span><span style="color:#999999">,</span> args<span style="color:#999999">)</span><span style="color:#999999">;</span><span style="color:#999999">}</span><span style="color:#999999">}</span>
</code></span></span>

在这里插入图片描述

2.pom文件

在这里插入图片描述

大多数Spring Boot应用在POM的parent部分使用spring-boot-starter-parent。 spring-boot-starter-parent 是一个特殊的starter，提供有用的Maven默认值。
需要的依赖在 < dependency > 标签内导入需要的< dependeny>

start

Starter是一系列开箱即用的依赖，你可以在你的应用程序中导入它们。通过你Starter，可以获得所有你需要的Spring和相关技术的一站式服务，免去了需要到处大量复制粘贴依赖的烦恼。
例如，如果你想开始使用Spring和JPA进行数据库访问，那么可以直接在你的项目中导入 spring-boot-starter-data-jpa 依赖。（也就是说现在你想要什么依赖，只需要spring-boot-start-xxx就可以帮你自动导入这方面的所有常规依赖）

Starter含了很多你需要的依赖，以使项目快速启动和运行，并拥有一套一致的、受支持的可管理的过渡性依赖。

例子：
在idea的终端输入?mvn dependency:tree打印了一个项目依赖的树状图，如下：
在这里插入图片描述

你可以看到spring-boot-starter-parent本身没有导入什么依赖（就是一些基本的依赖如spring方面的，日志方面的等）。要导入必须的依赖，需要编辑 pom.xml 文件。

假如正在开发一个Web应用程序，我们添加一个 spring-boot-starter-web 依赖项：

<span style="color:#000000"><span style="background-color:#fafafa"><code class="language-xml"><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"><</span>dependencies</span><span style="color:#999999">></span></span><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"><</span>dependency</span><span style="color:#999999">></span></span><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"><</span>groupId</span><span style="color:#999999">></span></span>org.springframework.boot<span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"></</span>groupId</span><span style="color:#999999">></span></span><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"><</span>artifactId</span><span style="color:#999999">></span></span>spring-boot-starter-web<span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"></</span>artifactId</span><span style="color:#999999">></span></span><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"></</span>dependency</span><span style="color:#999999">></span></span>
<span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"></</span>dependencies</span><span style="color:#999999">></span></span>
</code></span></span>

如果你再次运行mvn dependency:tree?，你会看到现在有一些额外的依赖，包括Tomcat web服务器等。基本将常规依赖都引入进来了。
在这里插入图片描述

parent

spring-boot-starter-parent 是一个特殊的starter，它在POM.xml里面声明了spring boot的各个依赖及其版本。子项目直接继承它，子项在导入 spring boot 依赖时，不需要声明版本号。
通俗的说parent部分就是在你导入spring-boot-start–parent时，自动帮你冲裁了版本号，你在dependenys标签里的依赖可以不用写版本号

提问：不想使用仲裁版本怎么办？
在pom.xml重写配置，如下面的代码（这里以mysql为例，换成5.1.43版本）：

<span style="color:#000000"><span style="background-color:#fafafa"><code class="language-xml"><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"><</span>properties</span><span style="color:#999999">></span></span><span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"><</span>mysql.version</span><span style="color:#999999">></span></span>5.1.43<span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"></</span>mysql.version</span><span style="color:#999999">></span></span>
<span style="color:#e45649"><span style="color:#e45649"><span style="color:#999999"></</span>properties</span><span style="color:#999999">></span></span>
</code></span></span>

打包

使用Maven快速打包

IDEA内终端运行mvn package

<span style="color:#000000"><span style="background-color:#fafafa"><code class="language-java">$ mvn <span style="color:#0077aa">package</span><span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> Scanning <span style="color:#0077aa">for</span> projects<span style="color:#999999">.</span><span style="color:#999999">.</span><span style="color:#999999">.</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> Building myproject <span style="color:#986801">0.0</span><span style="color:#986801">.1</span><span style="color:#a67f59">-</span><span style="color:#986801">SNAPSHOT</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#999999">.</span><span style="color:#999999">.</span><span style="color:#999999">.</span><span style="color:#999999">.</span> <span style="color:#999999">.</span><span style="color:#999999">.</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#a67f59">--</span><span style="color:#a67f59">-</span> maven<span style="color:#a67f59">-</span>jar<span style="color:#a67f59">-</span>plugin<span style="color:#a67f59">:</span><span style="color:#986801">2.4</span><span style="color:#a67f59">:</span>jar <span style="color:#999999">(</span><span style="color:#0077aa">default</span><span style="color:#a67f59">-</span>jar<span style="color:#999999">)</span> @ myproject <span style="color:#a67f59">--</span><span style="color:#a67f59">-</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> Building jar<span style="color:#a67f59">:</span> <span style="color:#a67f59">/</span>Users<span style="color:#a67f59">/</span>developer<span style="color:#a67f59">/</span>example<span style="color:#a67f59">/</span>spring<span style="color:#a67f59">-</span>boot<span style="color:#a67f59">-</span>example<span style="color:#a67f59">/</span>target<span style="color:#a67f59">/</span>myproject<span style="color:#a67f59">-</span><span style="color:#986801">0.0</span><span style="color:#986801">.1</span><span style="color:#a67f59">-</span><span style="color:#986801">SNAPSHOT</span><span style="color:#999999">.</span>jar
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#a67f59">--</span><span style="color:#a67f59">-</span> spring<span style="color:#a67f59">-</span>boot<span style="color:#a67f59">-</span>maven<span style="color:#a67f59">-</span>plugin<span style="color:#a67f59">:</span><span style="color:#986801">3.2</span><span style="color:#986801">.0</span><span style="color:#a67f59">-</span><span style="color:#986801">SNAPSHOT</span><span style="color:#a67f59">:</span>repackage <span style="color:#999999">(</span><span style="color:#0077aa">default</span><span style="color:#999999">)</span> @ myproject <span style="color:#a67f59">--</span><span style="color:#a67f59">-</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#986801">BUILD</span> <span style="color:#986801">SUCCESS</span>
<span style="color:#999999">[</span><span style="color:#986801">INFO</span><span style="color:#999999">]</span> <span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span><span style="color:#a67f59">--</span></code></span></span>

另一种：
在这里插入图片描述

运行后你会发现工程内多个target文件夹：
在这里插入图片描述

如果你查看 target 目录，你应该看到项目名-0.0.1-SNAPSHOT.jar
（没有target可以在从电脑中找到项目文件夹，里面应该能找到target文件夹，在jar包所在文件夹打开电脑终端，运行java -jar 项目名-1.0-SNAPSHOT.jar）

在这里插入图片描述

IDEA终端运行java -jar target/myproject-0.0.1-SNAPSHOT.jar：

<span style="color:#000000"><span style="background-color:#fafafa"><code class="language-java">$ java <span style="color:#a67f59">-</span>jar target<span style="color:#a67f59">/</span>myproject<span style="color:#a67f59">-</span><span style="color:#986801">0.0</span><span style="color:#986801">.1</span><span style="color:#a67f59">-</span><span style="color:#986801">SNAPSHOT</span><span style="color:#999999">.</span>jar<span style="color:#999999">.</span>   ____          _            __ _ _<span style="color:#a67f59">/</span>\ <span style="color:#a67f59">/</span> ___'_ __ _ <span style="color:#dd4a68">_</span><span style="color:#999999">(</span>_<span style="color:#999999">)</span>_ __  __ _

( ( )___ | '_ | '| | ’ / ` |
<span style=“color:#a67f59”>/ )| |)| | | | | || (| | ) ) ) )
’ || .__|| ||| |, | / / / /
=||==|/=///_/
:: Spring Boot :: (v3.1.2-SNAPSHOT)
....... . . .
....... . . . (log output here)
....... . . .
........ Started MyApplication in 0.999 seconds (process running for 1.253)

</code></span></span>

要退出应用程序，按 ctrl-c。

如果你想看看这jar里面到底有什么东西，你可以使用 jar tvf：jar tvf target/项目名-0.0.1-SNAPSHOT.jar

二、依赖管理特性

Spring Boot的每个版本都提供了一个它所支持的依赖的列表。在实践中，你不需要在构建配置中为这些依赖声明版本，因为Spring Boot会帮你管理这些。当你升级Spring Boot本身时，这些依赖也会一同升级。(所以现在你联系一下parent和start是不是豁然开朗)

开发导入starter场景启动器
1. spring-boot-starter-* ： * 就是某种场景
2. 只要引入starter，这个场景的所有常规需要的依赖我们都自动引入
3. 更多SpringBoot所有支持的场景
4. *-spring-boot-starter：第三方为我们提供的简化开发的场景启动器。
所有场景启动器最底层的依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> <version>3.1.2</version> <scope>compile</scope> </dependency>
无需关注版本号，自动版本仲裁
1. 引入依赖默认都可以不写版本
2. 引入非版本仲裁的jar，要写版本号。
可以修改默认版本号
1. 查看spring-boot-dependencies里面规定当前依赖的版本用的 key。
2. 在当前项目里面重写配置，如下面的代码。
<properties> <mysql.version>5.1.43</mysql.version> </properties>

IDEA快捷键：

ctrl + shift + alt + U：以图的方式显示项目中依赖之间的关系。
alt + ins：相当于Eclipse的 Ctrl + N，创建新类，新包等。

三、自动配置特性

自动配好Tomcat
- 引入Tomcat依赖。
- 配置Tomcat
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <version>3.1.2</version> <scope>compile</scope> </dependency>
自动配好SpringMVC
- 引入SpringMVC全套组件
- 自动配好SpringMVC常用组件（功能）

自动配好Web常见功能，如：字符编码问题

SpringBoot帮我们配置好了所有web开发的常见场景

public static void main(String[] args) { //1、返回我们IOC容器 ConfigurableApplicationContext run = SpringApplication.run(MainApplication.class, args);

<span style="color:#708090">//2、查看容器里面的组件</span>
String<span style="color:#999999">[</span><span style="color:#999999">]</span> names <span style="color:#a67f59">=</span> run<span style="color:#999999">.</span><span style="color:#dd4a68">getBeanDefinitionNames</span><span style="color:#999999">(</span><span style="color:#999999">)</span><span style="color:#999999">;</span>
<span style="color:#0077aa">for</span> <span style="color:#999999">(</span>String name <span style="color:#a67f59">:</span> names<span style="color:#999999">)</span> <span style="color:#999999">{</span>System<span style="color:#999999">.</span>out<span style="color:#999999">.</span><span style="color:#dd4a68">println</span><span style="color:#999999">(</span>name<span style="color:#999999">)</span><span style="color:#999999">;</span>
<span style="color:#999999">}</span>

}

在这里插入图片描述
这里截取了一部分，可以看出里面SpringBoot真的很强大，不需要SSM一样导入一堆依赖。

默认的包结构
- 主程序所在包及其下面的所有子包里面的组件都会被默认扫描进来
- 无需以前的包扫描配置
- 想要改变扫描路径
  - @SpringBootApplication(scanBasePackages=“com.dragon”)
  - @ComponentScan 指定扫描路径
@SpringBootApplication 等同于 @SpringBootConfiguration @EnableAutoConfiguration @ComponentScan(“com.lun”)
各种配置拥有默认值
- 默认配置最终都是映射到某个类上，如：MultipartProperties
- 配置文件的值最终会绑定每个类上，这个类会在容器中创建对象
按需加载所有自动配置项
- 非常多的starter
- 引入了哪些场景这个场景的自动配置才会开启
- SpringBoot所有的自动配置功能都在 spring-boot-autoconfigure 包里面