Spring Boot

约 7444 字大约 25 分钟

2025-04-11

1.Spring Boot 全面概述

Spring Boot 是一个构建在 Spring 框架顶部的项目（也就是一个模块）。它提供了一种简便，快捷的方式来设置，配置和运行基于 Web 的简单应用程序。是简化版的 Spring，旨在快速开发中小型的、快速交付、微服务架构的项目，要比 Spring 来得轻量。

它是一个 Spring 模块，提供了 RAD(快速应用程序开发) 功能。它用于创建独立的基于 Spring 的应用程序，因为它需要最少的 Spring 配置，因此可以运行。

基本上 Spring Boot = Spring Framework + Embedded HTTP Server - XML

可以使用 Spring STS IDE, Spring Initializr, IDEA Ultimate 构建一个 Spring Boot 项目。

2.Spring Boot 基本功能

Web 开发 这是用于 Web 应用程序开发的非常适合的子模块。我们可以轻松创建一个独立的 HTTP 应用程序，该应用程序使用 Tomca, Jetty, Undertow 等嵌入式服务器。我们可以使用 spring-boot-starter-web 模块快速启动和运行应用程序。
SpringApplication 类 提供了一种方便的方式来引导 Spring 应用程序，可以从 main 方法开始，我们可以仅通过调用静态 run() 方法来调用应用程序。
```
// Main.java
public static void main(String[] args) {
    SpringApplication.run(ClassName.class, args);  
}
```
应用程序事件和侦听器 Spring Boot 使用事件来处理各种任务。它允许我们创建用于添加侦听器的工厂文件。我们可以使用 ApplicationListener 键 来引用它。总是在 META-INF 文件夹中创建工厂文件，例如 META-INF/spring.factories。
应用管理 Spring Boot 提供了为应用程序启用与管理员相关的功能的功能。它用于远程访问和管理应用程序。我们可以使用 spring.application.admin.enabled 属性在 Spring Boot 应用程序中启用它。
外部配置 Spring Boot 允许我们外部化我们的配置，以便我们可以在不同环境中使用同一应用程序。该应用程序使用 YAML 文件来外部化配置。
属性文件 Spring Boot 提供了一组丰富的应用程序属性。因此，我们可以在项目的属性文件中使用它。该属性文件用于设置诸如 server-port = 8082 等属性，它有助于组织应用程序属性。
YAML 支持 它提供了一种方便的方法来指定层次结构。它是 JSON 的超集（任何 JSON 文档复制进去都可以通过使用）。 SpringApplication 类自动支持 YAML，它是属性文件的代替方法。
类型安全配置 强大的类型安全配置用于管理和验证应用程序的配置。应用程序配置始终是至关重要的任务，应该是类型安全的。我们还可以使用此库提供的注释。
日志 Spring Boot 对所有内部记录都使用通用记录。默认情况下管理日志记录依赖项。如果不需要自定义，我们不应更改日志记录依赖项。
安全性 Spring Boot 应用程序是 spring 的 Web 应用程序。因此，默认情况下，通过所有 HTTP 端点上的基本身份验证，它是安全的。可以使用一组丰富的端点来开发安全的 Spring Boot 应用程序。

补充：如果不在 application.properties 配置文件中加入 spring.jackson.deserialization.fail-on-unknown-properties=true 就会默认不约束 JSON 报文数据。但是如果加上了，并且没有对资源描述做 // @JsonIgnoreProperties(ignoreUnknown = true) 忽略，在有字段缺失时，就会抛出异常。

重要

补充：@JsonIgnoreProperties 其实还有一些其他的用法，比如对某些特定字段进行忽略...

警告

警告：上述代码中有一个 /html 的接口，可以直接组合 HTML 返回一个前端页面，这是前后端不分离的做法，也就是类似 Spring MVC 的做法，Spring Boot 开发一般不会这么做，这只是我为了进行方便的测试 POST 方法而已。

当然，如果您不希望使用 Spring Boot 做页面返回这种奇怪的做法（毕竟几乎没有人会这么做），可以在启动文件中定义一个定义一个 RestTemplate 客户端，用来模拟浏览器进行接口测试（这是 Spring 提供的），只需要在启动文件中加入一些代码即可。

// MyRestfulWebApplicationTests.java: 启动文件
// 注意无需进行任何改动!
package com.limou.myrestfulweb;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.client.RestTemplateBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Profile;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpMethod;
import org.springframework.http.ResponseEntity;
import org.springframework.web.client.RestTemplate;

/**
 * @SpringBootApplication 是一个便捷的注释，它添加了以下所有内容:
 * = @SpringBootConfiguration 标识这是一个 Spring Boot 应用程序的配置类
 * + @EnableAutoConfiguration 启用 Spring Boot 的自动配置机制, 根据依赖和类路径内容自动配置应用程序, 避免手动配置大量的 Spring 配置类
 * + @ComponentScan 启用组件扫描, 默认会扫描当前包及其子包中的所有类(如 @Controller, @Service, @Repository, @Component 等注解标记的类)
 */

@SpringBootApplication
public class MyRestfulWebApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyRestfulWebApplication.class, args);
    }

    private static final Logger log = LoggerFactory.getLogger(MyRestfulWebApplication.class);

    @Bean
    public RestTemplate restTemplate(RestTemplateBuilder builder) {
        return builder.build();
    }

    @Bean
    @Profile("!test")
    public CommandLineRunner run(RestTemplate restTemplate) throws Exception {
        return args -> {
            try {
                String getUrl = "http://127.0.0.1:8080/greeting_get?name=gimou";

                // 创建请求头
                HttpHeaders headers = new HttpHeaders();
                headers.add("Cookie", "your_cookie_value"); // 在这里添加 Cookie 请求头

                // 创建 HttpEntity 并将请求头和请求体设置进去
                HttpEntity<String> entity = new HttpEntity<>(null, headers); // 请求体为 null

                // 使用 exchange 方法发送请求
                ResponseEntity<GreetingController.Greeting> getResponse =
                        restTemplate.exchange(
                                getUrl, // 请求的 URL
                                HttpMethod.GET, // 请求方法
                                entity, // 请求实体，包括头信息
                                GreetingController.Greeting.class // 响应体类型
                        );

                // 打印响应结果
                log.info("Response: {}", getResponse.getBody());
            } catch (Exception e) {
                // 捕获所有异常并记录日志
                log.error("An error occurred while making the request: {}", e.getMessage(), e);
            }
        };
    }


}

使用上述代码中的 RestTemplate 同步客户端根据来测试（不太推荐）
使用已经编写好的前端程序，用浏览器进行调试，例如 Chrome（但要有前端代码）
使用一些现成的接口调用软件，在本地进行测试，例如 Postman（比较不错）
使用命令行进行测试，例如 wget, telnet（更加直观但难上手）

重要

补充：使用 RestTemplate 的方式其实意味着 Spring Boot 也是可以开发一个前端的，不过这种前端是无界面的前端，更加适合在终端中执行。

3.2.5.原理深入

不知道您有没有注意到一些问题，我们的确定义了两个东西：

资源表示类
资源控制类

但是值得令人好奇的是，我们没有调用资源控制类的对象，仅仅是在内部使用了资源表示类的对象，但是浏览器却能调用资源控制类内部的方法，这其实和 Bean 机制有关。

在 Spring 框架中，Bean 是指由 Spring 容器管理的对象。Spring 使用 DI(依赖注入) 机制来创建和管理这些对象，确保对象之间的依赖关系得到正确处理。Spring 容器通过配置文件、注解或 Java 配置类来管理这些 Bean。

而实际上 Bean 就是一个普通的 Java 对象，但是它被 Spring 容器 创建、管理、注入 到其他对象中。

Spring 容器通过使用注解（如 @Component、@Service、@Repository）或 XML 配置文件来标识哪些类是 Bean，并将这些对象注册到 Spring 容器中。

不过更多的原理，我认为可以转移到 Spring 那里去理解，毕竟 Spring Boot 可以理解为基于 Spring 的封装。

在上述代码中：

资源控制类是由 Spring 容器自动管理的 Bean，Spring 会根据配置的 URL 映射来自动调用控制器类的方法
资源表示类（如 Greeting）用于封装返回给客户端的数据。GreetingController 类内部使用了 Greeting 类，但不需要显式地调用 GreetingController 实例
通过 Bean 管理和自动映射，Spring 会自动处理 HTTP 请求并执行相应的方法，开发者无需手动实例化和调用控制器类

3.2.6.常用注解

我相信您一定能明白注解对于 Spring Boot 的重要性，因此这里补充一些关于常见注解的详细讲解，您需要按需加入到您的应用中，并且值得注意的是，每一组相关的组件我都会用足够完整的代码供您测试。

@SpringBootApplication = @SpringBootConfiguration + @EnableAutoConfiguration + @ComponentScan 标识 Spring Boot 应用程序的配置类、启用 Spring Boot 的自动配置机制、启用组件扫描来自动管理实例
@RestController = @Controller + @ResponseBody：控制器
@GetMapping = @RequestMapping(method = RequestMethod.GET)：映射 Get 方法的接口
@PostMapping = @RequestMapping(method = RequestMethod.POST)：映射 Post 方法的接口
@RequestParam：获取路径中的查询参数
@RequestHeader：请求报头，从请求报头中获取字段值
@RequestBody：请求载荷，从请求载荷中获取字段值
@JsonIgnoreProperties：对资源描述类约束的控制

4.Spring Boot 深入学习

4.1.启动流程

Spring Boot 的启动流程可以总结为以下几个核心步骤（示例为 Spring Boot 2.7.6 版本）：

启动 main() 方法：应用从 main() 方法启动，并通过 SpringApplication.run() 引导应用启动。
创建 SpringApplication：应用会创建 SpringApplication 对象，推断应用类型、设置初始化器、设置启动监听器、确定主应用类。
准备环境：Spring Boot 在启动过程中准备应用环境，加载配置文件、系统环境变量以及命令行参数。
创建并刷新 ApplicationContext：创建应用上下文，加载配置类和自动配置类，注册 Bean 并执行依赖注入等初始化操作。
在刷新上下文时启动嵌入式 Web 服务器：对于 Web 应用，Spring Boot 会自动启动嵌入式 Web 容器（如 Tomcat），并注册相关的 Servlet 和 Filter。
重要
补充：Servlet 是 Java EE 规范的一部分，本质上是处理 HTTP 请求的一个类。
- 用于接收请求（如 GET、POST）
- 处理业务逻辑
- 响应数据客户（返回 HTML、JSON 等）
总结就是核心业务处理。
重要
补充：Filter 是一种“过滤器”，可以在请求到达 Servlet 之前或响应返回客户端之后做处理。常用于：
- 权限校验
- 日志记录
- 编码设置
- 跨域处理
总结就是拦截器/中间件。
重要
补充：一般 Spring 通过 @WebServlet / @WebFilter 注解 + @ServletComponentScan，不过在 Spring Boot 中如果使用 @RestController 则会自动配置，除非又特殊场景才会手动使用（例如日志处理）。
发布应用已启动事件：对应监听 stated 事件逻辑会被触发。
执行 CommandLineRunner 和 ApplicationRunner：在应用启动完成后，执行实现了 CommandLineRunner 和 ApplicationRunner 接口的初始化逻辑。
发布 ready 事件、应用启动完成：触发 ApplicationReadyEvent，应用进入运行状态，处理业务请求或任务。

版权所有

版权归属：limou3434

许可证：署名 4.0 国际 (CC-BY-4.0)

Spring Boot

1.Spring Boot 全面概述

2.Spring Boot 基本功能

3.Spring Boot 使用教程

3.1.快速使用

3.1.1.构建项目

3.1.2.目录结构

3.1.3.代码实践

3.2.搭建服务

3.2.1.编码目标

3.2.2.创建项目

3.2.3.简单使用

3.2.4.高自定义