Spring Boot 3.0.3 Reference Guide

• 语言: 英语
• 格式: .pdf
• 来源: docs.spring.io

摘要

该文档是Spring Boot 3.0.3参考指南，涵盖文档概述、入门指南、升级说明及开发实践。核心内容包括：Spring Boot用于创建独立、生产级Spring应用，支持java -jar启动；系统要求Java 17及以上，支持Maven 3.5+和Gradle 7.x；提供嵌入式Servlet容器（如Tomcat 10.0）支持。文档强调依赖管理，每个版本提供经过筛选的依赖列表，用户无需指定版本。升级部分说明从1.x或新特性版本升级的方法，包括使用spring-boot-properties-migrator迁移属性。开发部分涵盖构建系统（推荐Maven或Gradle）、最佳实践（如代码结构、@Configuration、@EnableAutoConfiguration）以及通过SpringApplication创建非Web应用。文档还列出大量Starter依赖及其版本。

AI总结

Spring Boot 3.0.3 是一个用于创建独立、生产级 Spring 应用的框架，其核心理念是“开箱即用”，但允许在需求偏离默认值时灵活调整。它无需代码生成或 XML 配置，主要目标包括：提供快速的入门体验、内置大量项目通用功能（如嵌入式服务器、安全、监控等）。

**系统要求**：必须使用 Java 17 至 19，并搭配 Spring Framework 6.0.5 或以上版本。构建工具推荐 Maven 3.5+ 或 Gradle 7.5+。支持的嵌入式 Servlet 容器包括 Tomcat 10.0。

**入门与升级**：
- 新手应从“First Steps”和“Getting Started”章节开始，了解安装、基本概念和构建第一个应用。
- 从旧版本升级时，需查阅项目维基上的迁移指南和发布说明。升级到新功能版本时，可使用 `spring-boot-properties-migrator` 依赖来临时迁移属性，但迁移完成后需移除该依赖。

**开发实践**：
- **构建系统**：强烈推荐使用 Maven 或 Gradle。Spring Boot 提供了一份经过整理的依赖列表（Bill of Materials），在构建配置中通常无需指定这些依赖的版本，Spring Boot 会统一管理。
- **最佳实践**：包括代码结构、使用 `@Configuration` 和 `@EnableAutoConfiguration`、依赖注入等。
- **应用运行**：支持在 IDE 中运行、打包为可执行 JAR（通过 `java -jar` 启动），或使用 Maven/Gradle 插件运行。

**核心特性**：
- **SpringApplication**：负责启动应用，可配置为 Web 或非 Web 应用。对于非 Web 应用，需移除 Servlet 依赖或显式设置 `WebApplicationType.NONE`。
- **外部化配置**：支持从多种来源（如属性文件、环境变量）加载配置，并可使用 Profiles 区分不同环境。
- **属性扩展**：在构建时，可通过 Maven 的 `@..@` 占位符或 Gradle 的相应机制，自动将构建配置中的属性（如项目版本）注入到应用配置文件中。

**文档与帮助**：文档开源，可通过官方文档、Stack Overflow（标签 `spring-boot`）和 GitHub Issues 获取帮助。