Spring Boot 基础介绍与入门 – wiki基地

作者： /

拥抱高效开发：Spring Boot 基础介绍与极速入门指南

引言：告别繁琐，迎接简洁

在Java企业级应用开发的广阔天地中，Spring Framework无疑是长期以来占据主导地位的巨石。它以其强大的功能、灵活的设计和庞大的生态系统，成为了无数开发者构建复杂应用的基石。然而，传统的Spring开发，尤其是早期版本，往往伴随着大量的XML配置、繁琐的依赖管理以及复杂的部署流程，让初学者望而却步，也让经验丰富的开发者感到疲惫。

试想一下，你需要搭建一个简单的Web服务，却可能需要手动配置DispatcherServlet、ContextLoaderListener、Spring MVC的各种解析器和拦截器、数据源、事务管理器，以及大量的bean定义。仅仅是环境搭建和基础配置，就可能耗费数小时甚至数天。这无疑是开发效率的一大瓶颈。

正是在这样的背景下，Spring Boot应运而生。它不是要取代Spring Framework，而是要拥抱它，并在它的基础上构建一个简化配置、快速开发、开箱即用的应用框架。Spring Boot的核心思想是“约定大于配置”（Convention over Configuration），它通过一系列的默认配置和自动化机制，极大地减少了开发者的配置负担，让开发者能够更专注于业务逻辑的实现。

如果你曾经被繁琐的Spring配置所困扰，或者你是Java开发新手，希望能够快速上手企业级应用开发，那么Spring Boot将是你的绝佳选择。它让Spring开发变得前所未有的简单、快捷和愉快。

本文将带你深入了解Spring Boot的基础知识，探究它为何如此受欢迎，并手把手教你如何从零开始搭建一个Spring Boot应用，迈出你Spring Boot学习旅程的第一步。

第一部分：Spring Boot 是什么？为何选择它？

1.1 Spring Boot 的定义

Spring Boot是由Pivotal团队提供的全新框架，其设计目的是用来简化新Spring应用的初始搭建以及开发过程。简单来说，Spring Boot就是基于Spring Framework之上的一个框架，它通过提供一系列的预设配置和工具，帮助开发者快速地构建独立的、生产级别的基于Spring的应用。

这里的关键词是：
* 简化搭建和开发： 大幅减少初始配置和依赖管理。
* 独立的： 打包的应用可以独立运行，无需外部Web服务器。
* 生产级别的： 提供了许多生产环境中常用的功能，如监控、健康检查等。
* 基于Spring： 它不是一个全新的技术栈，而是深度整合并增强了现有的Spring生态系统。

1.2 Spring Boot 解决了哪些痛点？

在没有Spring Boot之前，传统的Spring应用开发面临以下挑战：

  • 繁重的配置： 需要大量的XML或Java Config来配置Spring容器、MVC、数据源、事务等。
  • 复杂的依赖管理： 项目中可能包含大量Spring相关的依赖以及第三方库的依赖，版本冲突问题频发，管理起来非常困难。
  • 独立的外部容器： 通常需要将应用打包成WAR文件，然后部署到Tomcat、Jetty等外部Web服务器中。这增加了部署的复杂性，也限制了应用的独立性。
  • 缺乏开箱即用的生产级特性： 监控、健康检查、外部化配置等生产环境必备的功能需要额外集成和配置。

Spring Boot 正是为了解决这些问题而诞生的。

1.3 Spring Boot 的核心优势 (Why Spring Boot?)

选择Spring Boot，你将获得以下显著优势：

  • 极大地简化配置： 通过自动配置（Auto-configuration）机制，Spring Boot能够根据你引入的依赖自动配置Spring的大部分功能。例如，如果你引入了Web相关的依赖，Spring Boot会自动配置DispatcherServlet；如果你引入了JPA和数据库依赖，它会自动配置EntityManagerFactory和DataSource。开发者只需少量甚至零配置即可启动一个功能完善的应用。
  • 简化依赖管理： Spring Boot提供了“Starter”依赖，这些Starter是一组预定义的、打包好的依赖集合。例如，spring-boot-starter-web 会引入Spring MVC、Tomcat等Web开发所需的所有依赖，并处理好版本兼容性。这极大地简化了项目的依赖管理。
  • 内置嵌入式服务器： Spring Boot应用可以内嵌Tomcat、Jetty或Undertow等Web服务器，可以直接打包成可执行的JAR文件运行，无需单独安装和配置外部Web服务器。这使得应用的部署和运行变得异常简单，一个JAR包即可搞定一切。
  • 提供了生产级别的特性： Spring Boot Actuator提供了丰富的生产监控和管理功能，如健康检查、性能指标、运行时信息、外部配置刷新等。这使得应用在生产环境中的运维变得更加便捷。
  • 无代码生成，无XML配置（可选）： 尽管你可以使用XML，但Spring Boot推崇使用Java Config和Annotation，甚至在很多情况下，你只需要依赖和很少的代码就能实现功能。
  • 广泛的生态系统支持： Spring Boot完美集成Spring Cloud、Spring Security、Spring Data等Spring生态中的其他项目，轻松构建微服务、安全应用、数据访问层等。
  • 快速应用开发： 综合以上优点，Spring Boot让开发者能够以前所未有的速度搭建和开发基于Spring的应用，将更多精力投入到核心业务逻辑的实现。

总而言之，Spring Boot让Spring开发从“繁琐的配置艺术”转变为“高效的业务实现”，是当前Java企业级应用开发的首选框架。

第二部分：Spring Boot 的核心特性解析

了解了Spring Boot是什么以及它的优势后，我们来深入看看它背后实现这些魔力的关键特性。

2.1 自动配置（Auto-configuration）

这是Spring Boot最核心也是最引人注目的特性之一。

概念： Spring Boot的自动配置尝试根据你添加到项目中的Jar依赖，自动推断并配置Spring应用程序的各个方面。例如，如果你的Classpath中有spring-webmvc Jar，并且没有手动配置任何Web相关的beans，Spring Boot会自动配置一个DispatcherServlet。如果Classpath中有spring-jdbc和H2数据库Jar，并且没有手动配置DataSource，Spring Boot会配置一个内嵌的H2数据库DataSource。

工作原理简述： Spring Boot通过扫描Classpath中的特定类和配置，结合条件注解（如@ConditionalOnClass, @ConditionalOnMissingBean等），来决定是否应用某个自动配置类。这些自动配置类预设了各种常用功能的配置bean。当满足条件时（比如某个类存在于Classpath中且没有用户自定义的相应bean），自动配置就会生效。

示例： 当你引入spring-boot-starter-web依赖后，Spring Boot会自动：
* 配置内嵌的Web服务器（默认为Tomcat）。
* 配置DispatcherServlet。
* 配置Spring MVC的核心组件，如ViewResolvers、HandlerMappings等。
* 配置JSON序列化/反序列化器（如Jackson）。

开发者无需手动编写XML或Java Config来完成这些基础配置。

2.2 Starter 依赖

Starter是Spring Boot提供的方便的依赖描述符集合。

概念： Starter本质上是一个Maven或Gradle的依赖，但它并不是一个单一的库，而是一个聚合依赖。当你引入一个Starter时，它会通过传递性依赖（transitive dependencies）的方式，将该功能所需的所有常见库都引入到你的项目中，并处理好版本兼容性。

目的：
* 简化依赖管理： 开发者无需手动添加大量细粒度的依赖，只需引入一个或几个Starter即可。
* 避免版本冲突： 同一个Starter内的所有依赖版本都是经过Spring Boot团队测试和协调的，减少了版本不兼容的风险。
* 约定俗成： Starter的命名通常表明了它提供的功能（如 spring-boot-starter-web 用于Web开发，spring-boot-starter-data-jpa 用于JPA数据访问）。

常见 Starter 示例：
* spring-boot-starter-web：Web开发，包括Spring MVC、Tomcat等。
* spring-boot-starter-data-jpa：使用JPA/Hibernate进行数据持久化。
* spring-boot-starter-test：用于编写单元测试和集成测试。
* spring-boot-starter-security：用于Spring Security安全框架。
* spring-boot-starter-actuator：提供生产监控和管理功能。

使用Starter，你的项目依赖列表会变得异常简洁和清晰。

2.3 内置嵌入式服务器

这是实现“独立可运行应用”的关键特性。

概念： Spring Boot应用可以直接内嵌Tomcat、Jetty或Undertow等Servlet容器。这意味着你可以将整个应用（包括服务器）打包成一个可执行的JAR文件。

优势：
* 简化部署： 无需单独安装、配置和管理外部Web服务器。只需运行一个JAR文件即可启动应用。
* 提升开发效率： 开发过程中可以直接在IDE或命令行中运行应用，无需频繁打包和部署到外部服务器。
* 微服务友好： 独立运行的特性非常适合构建微服务架构，每个服务可以打包成一个独立的JAR。

默认情况下，spring-boot-starter-web 会引入Tomcat作为嵌入式服务器。你也可以通过配置轻松切换到Jetty或Undertow。

2.4 Spring Boot Actuator

Actuator是Spring Boot提供的用于监控和管理生产环境应用的利器。

概念： 引入 spring-boot-starter-actuator 依赖后，Spring Boot应用会自动暴露一系列HTTP或JMX端点（Endpoints），用于检查应用的状态、配置、度量等。

常用 Endpoints 示例：
* /health：显示应用的健康状态（例如，数据库连接是否正常）。
* /info：显示应用的自定义信息。
* /metrics：显示应用的度量信息（例如，内存使用、HTTP请求数、方法执行时间）。
* /env：显示Spring Environment的属性。
* /beans：显示Spring容器中的所有bean。
* /mappings：显示所有请求路径到Controller方法的映射。

这些Endpoints为应用的监控、诊断和管理提供了极大的便利，是构建生产级应用不可或缺的一部分。

2.5 外部化配置

Spring Boot提供了强大的机制来外部化你的应用配置。

概念： 应用的配置（如数据库连接信息、端口号、日志级别、自定义业务参数等）可以与代码分离，存储在外部文件中（如 .properties 或 .yml）、环境变量、命令行参数等位置。

优势：
* 环境隔离： 同一份代码可以在不同环境下（开发、测试、生产）使用不同的配置，无需修改代码或重新打包。
* 安全性： 敏感信息（如密码）可以存储在安全的环境变量或配置服务器中。
* 灵活性： 运行时可以通过修改外部配置来调整应用行为，无需重启应用（部分配置支持热加载）。

Spring Boot默认支持 application.properties 或 application.yml 文件作为主要的外部配置文件，并提供了优先级机制，允许配置信息覆盖。

2.6 Spring Boot CLI (Command Line Interface)

这是一个可选的工具，用于快速原型开发。

概念： CLI允许你使用Groovy脚本直接运行Spring应用程序，无需传统的Java项目结构。它利用了Spring Boot Starter和自动配置的优势，极大地简化了快速原型和实验的过程。

特点：
* 快速启动： 可以直接运行单个Groovy文件。
* 自动依赖： CLI会自动检测你的代码中使用了哪些Spring模块（如@RestController），然后自动下载并引入相应的Starter依赖。
* Groovy支持： 利用Groovy的简洁语法，可以编写更少的代码。

虽然对于大型、正式项目通常还是使用Maven或Gradle构建，但CLI是进行快速原型设计和学习Spring Boot特性的有趣且高效的工具。

第三部分：Spring Boot 入门实战：搭建第一个应用

理论知识讲了不少，现在让我们动手实践，搭建一个最简单的Spring Boot Web应用。

3.1 环境准备

在开始之前，请确保你的开发环境满足以下要求：

  1. Java Development Kit (JDK): Spring Boot 3.x 需要 Java 17 或更高版本。建议安装最新的LTS版本，如 Java 21 或 Java 17。
  2. 构建工具: Maven 或 Gradle。本文将以Maven为例，但Gradle同样流行且强大。
  3. 集成开发环境 (IDE): 推荐使用支持Spring开发的IDE，如IntelliJ IDEA Ultimate版 (对Spring Boot支持最好)、Eclipse (安装Spring Tools Suite插件) 或 VS Code (安装Java相关插件)。

请确保你的JDK和Maven/Gradle已经正确安装并配置了环境变量。你可以在命令行中输入 java -version, mvn -version, gradle -version 来验证。

3.2 使用 Spring Initializr 创建项目

Spring Initializr (start.spring.io) 是官方提供的、创建Spring Boot项目的最便捷方式。它是一个Web界面，你可以通过它选择项目的基本信息、构建工具、语言、Spring Boot版本以及所需的依赖，然后生成一个包含基本项目结构的压缩包。

步骤：

  1. 打开浏览器，访问 https://start.spring.io/。

  2. Project:

    • Project: 选择你的构建工具，这里选择 Maven Project。
    • Language: 选择 Java。
    • Spring Boot: 选择一个稳定的版本，通常选择最新没有带有 SNAPSHOT 或 M、RC 后缀的版本（例如，3.2.x 的最新稳定版）。

  3. Project Metadata:

    • Group: 输入你的组织或公司域名倒写，例如 com.example。
    • Artifact: 输入你的项目名称，例如 myfirstspringbootapp。
    • Name: 项目名称（通常与Artifact相同）。
    • Description: 简单的项目描述，例如 Demo project for Spring Boot。
    • Package name: 自动生成，基于 Group 和 Artifact。
    • Packaging: 选择 Jar (因为我们使用嵌入式服务器，打包成可执行JAR更方便)。
    • Java: 选择你安装的Java版本，例如 17 或 21。

  4. Dependencies: 点击 “Add Dependencies…” 按钮，搜索并添加所需的依赖。对于一个简单的Web应用，我们需要：

    • 搜索并选择 Spring Web：这个Starter包含了Spring MVC、Tomcat等构建Web应用所需的核心依赖。
    • 搜索并选择 Spring Boot DevTools (可选但推荐)：提供了热部署、自动重启等开发便利功能。
    • 搜索并选择 Lombok (可选但推荐)：一个Java库，通过注解自动生成getter/setter、构造函数等，减少 boilerplate 代码。

  5. Generate: 确认所有信息无误后，点击右侧的 “Generate” 按钮。网站会生成并下载一个名为 myfirstspringbootapp.zip 的压缩文件。

3.3 导入项目到 IDE

  1. 解压下载的 myfirstspringbootapp.zip 文件到你的工作目录。
  2. 打开你喜欢的IDE (如IntelliJ IDEA)。
  3. 选择 “Import Project” (或类似选项)。
  4. 导航到你解压后的项目文件夹，选择项目根目录下的 pom.xml 文件 (如果是Gradle项目，选择 build.gradle 文件)。
  5. IDE会自动识别这是一个Maven项目，并开始下载所需的依赖。这可能需要一些时间，取决于你的网络状况。

导入成功后，你的项目结构应该类似于这样 (Maven项目)：

myfirstspringbootapp/
├── .mvn/ (Maven Wrapper相关)
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/myfirstspringbootapp/
│ │ │ └── MyfirstspringbootappApplication.java (主应用类)
│ │ └── resources/
│ │ ├── application.properties (配置文件)
│ │ ├── static/ (静态资源，如HTML/CSS/JS)
│ │ └── templates/ (模板文件，如Thymeleaf/FreeMarker)
│ └── test/
│ ├── java/
│ │ └── com/example/myfirstspringbootapp/
│ │ └── MyfirstspringbootappApplicationTests.java (测试类)
│ └── resources/
├── .gitignore (Git忽略文件)
├── mvnw (Maven Wrapper脚本)
├── mvnw.cmd (Maven Wrapper Windows脚本)
└── pom.xml (Maven 项目配置文件)

其中，MyfirstspringbootappApplication.java 是Spring Boot应用的主入口类，application.properties 用于存放外部配置。

3.4 编写第一个 Web 接口 (REST Controller)

现在，我们在项目中创建一个简单的REST接口。

  1. 在 src/main/java/com/example/myfirstspringbootapp/ 包下，创建一个新的Java类，命名为 HelloController.java。

  2. 添加以下代码：

    “`java
    package com.example.myfirstspringbootapp;

    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    import org.springframework.web.bind.annotation.RestController;

    @RestController // 1. 标识这是一个RESTful Web服务的控制器
    public class HelloController {

    @GetMapping("/hello") // 2. 将HTTP GET请求映射到/hello路径
public String sayHello(@RequestParam(value = "name", defaultValue = "World") String name) {
    // 3. 处理请求并返回一个字符串作为响应体
    return String.format("Hello, %s!", name);
}

    }
    “`

    代码解释：
    * @RestController: 这是Spring MVC提供的一个便捷注解，它是 @Controller 和 @ResponseBody 的结合。@Controller 标识这是一个Spring MVC的控制器组件，而 @ResponseBody 意味着该类的所有方法返回的值都应该直接作为HTTP响应体发送，而不是视图名称。对于构建RESTful API来说，@RestController 是首选。
    * @GetMapping("/hello"): 这是Spring Web提供的一个HTTP方法映射注解，专门用于处理HTTP GET请求。它将 /hello 这个URL路径映射到 sayHello 方法。等效于 @RequestMapping(method = RequestMethod.GET, value = "/hello")。
    * public String sayHello(...): 这是一个标准的Java方法。它的返回值 (String) 会被直接写入HTTP响应体。
    * @RequestParam(value = "name", defaultValue = "World") String name: 这个注解表示方法参数 name 来自于请求的查询参数（Query Parameter）。例如，访问 /hello?name=Spring。value="name" 指定参数名为 “name”，defaultValue="World" 指定如果请求中没有 name 参数，则使用默认值 “World”。

3.5 运行 Spring Boot 应用

Spring Boot应用的主入口是 MyfirstspringbootappApplication.java 类中的 main 方法。

“`java
package com.example.myfirstspringbootapp;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication // 1. Spring Boot 应用启动注解
public class MyfirstspringbootappApplication {

public static void main(String[] args) {
    SpringApplication.run(MyfirstspringbootappApplication.class, args); // 2. 启动 Spring 应用
}

}
“`

代码解释：
* @SpringBootApplication: 这是Spring Boot的主注解，它是一个复合注解，包含了：
* @Configuration: 标识该类是一个配置类，可以定义Spring beans。
* @EnableAutoConfiguration: 启用Spring Boot的自动配置机制。这是Spring Boot魔法发生的地方！
* @ComponentScan: 扫描当前包及其子包下的组件（如 @Component, @Service, @Repository, @Controller 等），并将它们注册为Spring beans。
* SpringApplication.run(...): 这是启动Spring Boot应用的静态方法。它会创建一个Spring应用上下文，执行自动配置，启动嵌入式Web服务器等。传入主应用类 (MyfirstspringbootappApplication.class) 作为参数。

运行方式：

  1. 在 IDE 中运行： 大部分IDE会在主应用类旁边提供一个运行按钮（通常是绿色的小箭头）。直接点击运行 MyfirstspringbootappApplication 类的 main 方法即可。
  2. 使用 Maven 命令： 打开终端或命令行，导航到项目根目录（包含 pom.xml 的目录），执行以下命令：
    bash
    mvn spring-boot:run
  3. 打包后运行： 先使用 Maven 将应用打包成可执行JAR：
    bash
    mvn clean package
    打包成功后，会在 target 目录下生成一个 myfirstspringbootapp-x.x.x.jar 文件（其中 x.x.x 是你的版本号）。然后使用Java命令运行它：
    bash
    java -jar target/myfirstspringbootapp-x.x.x.jar

无论哪种方式，当应用成功启动后，你会在控制台看到Spring Boot的Banner日志，以及类似 Started MyfirstspringbootappApplication in X.XXX seconds 的信息，并且会看到内嵌的Tomcat服务器启动在默认端口 8080 上。

3.6 测试 Web 接口

应用启动后，打开你的浏览器或使用工具（如 cURL, Postman, Insomnia）访问我们创建的接口。

  • 访问默认路径： 打开浏览器，输入 http://localhost:8080/hello。你应该会看到页面显示 Hello, World!。
  • 带参数访问： 打开浏览器，输入 http://localhost:8080/hello?name=Spring。你应该会看到页面显示 Hello, Spring!。

恭喜你！你已经成功搭建并运行了你的第一个Spring Boot Web应用，并创建了一个简单的REST接口。

3.7 修改默认端口 (可选)

默认情况下，Spring Boot内嵌的Tomcat运行在8080端口。你可以通过修改 src/main/resources/application.properties 文件来改变端口。

打开 application.properties，添加一行：

properties
server.port=8081

保存文件，然后重新启动应用。你会发现Tomcat现在监听在8081端口。你可以访问 http://localhost:8081/hello 来测试。

如果你喜欢YAML格式，也可以将文件名改为 application.yml，并使用YAML语法：

yaml
server:
port: 8081
Spring Boot会优先加载 application.yml 如果它存在的话。

3.8 关于 DevTools (可选)

如果你在创建项目时添加了 spring-boot-starter-devtools 依赖，你现在就可以体验到它带来的便利。在应用运行时，修改 HelloController.java 文件中的代码（例如，修改返回字符串），保存文件。Spring Boot DevTools会检测到文件的变化，并自动重启应用（或在某些情况下只热加载修改的部分），而无需你手动停止和重新运行。这在开发过程中非常节省时间。

第四部分：进一步探索 Spring Boot

成功入门后，Spring Boot的世界还有很多值得你去探索：

  • 数据访问： 如何使用Spring Data JPA/JDBC与数据库交互？Spring Boot提供了相应的Starter和自动配置。
  • 模板引擎： 如何使用Thymeleaf、FreeMarker等模板引擎构建动态Web页面？Spring Boot为它们提供了自动配置。
  • 安全性： 如何使用Spring Security保护你的应用？Spring Boot提供了 spring-boot-starter-security。
  • 测试： 如何编写针对Spring Boot应用的单元测试和集成测试？Spring Boot Test模块提供了强大的支持。
  • 微服务： 如何结合Spring Cloud构建分布式系统和微服务？Spring Boot是构建微服务的基石。
  • 配置深入： 如何使用 @Value 读取属性，如何使用 @ConfigurationProperties 绑定复杂配置？
  • 日志： 如何配置Spring Boot的日志系统（Logback, Log4j2）？

Spring Boot的官方文档是学习这些高级特性的最佳资源。同时，Spring官方网站 (https://spring.io/) 提供了大量的教程和指南。

结论

Spring Boot 彻底改变了Java企业级应用的开发方式。它通过自动配置、Starter依赖和内嵌式服务器等核心特性，极大地简化了Spring应用的搭建和开发过程，让开发者能够以前所未有的效率构建独立、生产级别的Java应用。

从繁琐的配置中解放出来，将更多精力投入到业务逻辑的实现，这是Spring Boot带给我们的最大价值。本文只是带你迈出了Spring Boot学习的第一步，一个简单的Web应用。但这已经足以让你感受到Spring Boot的魅力和强大。

随着你对Spring Boot的深入了解和实践，你将能够轻松构建复杂的Web应用、RESTful API、微服务等。记住，“约定大于配置”是它的核心理念，拥抱它，你将在Java开发的道路上事半功倍。

现在，是时候开始你的Spring Boot探索之旅了！祝你学习愉快，编码顺畅！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部