Spring Boot 3.0.0-M4 Reference Guide

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

摘要

文档详细阐述了Spring Boot 3.0.0-M4的开发指南，涵盖了构建系统、依赖管理、升级指南、生产就绪功能等内容。文档推荐使用Maven或Gradle作为构建工具，并支持通过插件实现功能扩展。此外，文档还介绍了Spring Boot的核心模块和生产环境监控工具，如Actuator。文档适用于新手及有经验的开发者，提供了从项目构建到生产部署的全_flow指南。

AI总结

《Spring Boot 3.0.0-M4 参考指南》主要内容总结如下：

---

### 一、Spring Boot 简介
Spring Boot 旨在简化 Spring 应用的开发流程，通过提供开箱即用的功能和默认配置，帮助开发者快速创建独立的、生产级的 Spring 应用。其核心目标包括：
- 提供快速上手的开发体验
- 默认配置 opinionated 但灵活，可根据需求调整
- 提供常见的非功能性特性（如嵌入式服务器、安全性、指标收集、健康检查等）
- 无需代码生成和 XML 配置

---

### 二、系统要求
- **Java版本**：要求 Java 17，并兼容至 Java 18。
- **Spring Framework版本**：要求 Spring Framework 6.0.0-M5 或更高版本。
- **构建工具**：支持 Maven 3.5+ 和 Gradle 7.5 或更高版本。

---

### 三、构建系统
Spring Boot 强烈推荐使用支持依赖管理的构建工具：
1. **Dependency Management**
Spring Boot 提供了一个精选的依赖列表，用户无需手动指定版本，升级 Spring Boot 时依赖会自动一致升级。
- 可以通过 Maven 的 `spring-boot-dependencies` 或 Gradle 的 BOM 管理依赖。
- 第三方库和 Spring 模块均在精选列表中。

2. **Maven 和 Gradle 插件**
- **Maven**：使用 `spring-boot-maven-plugin` 支持打包可执行 JAR/WAR 和运行应用。
- **Gradle**：使用 `spring-boot-gradle-plugin` 支持依赖管理、打包和运行应用。
- **Ant**：通过 `spring-boot-antlib` 提供基本支持，但不推荐常用。

---

### 四、开发指南
1. **日志记录**
Spring Boot 默认定义了多个日志组，包括：
- `root`：默认日志级别
- `sql`：包括 Hibernate SQL 日志
- `web`：包括编解码器日志
支持的日志级别：`trace`、`debug`、`info`、`warn`、`error`、`fatal`、`off`。

2. **CLI 工具**
- 通过 SDKMAN 安装：`sdk install springboot`
- 通过 Homebrew 安装（macOS）：`brew install spring-boot`
- 支持运行 Groovy 脚本和 Spring Boot 应用。

---

### 五、生产就绪功能
Spring Boot 的生产就绪功能通过 `spring-boot-actuator` 模块提供，包括以下功能：
1. **功能启用**
- Maven 依赖：`spring-boot-starter-actuator`
- Gradle 依赖：`org.springframework.boot:spring-boot-starter-actuator`
2. **端点监控**
- 内置端点：如 `health` 提供应用健康状态，`metrics` 提供指标数据。
- 可通过 HTTP（默认路径 `/actuator/{endpoint}`）或 JMX 访问。
- 端点需同时启用（`enabled`）和暴露（`exposed`）才能生效。

---

### 六、升级指南
1. **升级erequisites**
- 升级前请阅读发布说明，特别是跳过版本时需注意中间版本的说明。
2. **从 1.x 升级**
- 参照迁移指南和新功能列表，详细说明如何从旧版本升级。
3. **特性版本升级**
- 部分属性可能更名或移除，可通过 `spring-boot-properties-migrator` 模块分析和迁移属性。
4. **CLI 升级**
- 使用包管理器更新（如 `brew upgrade spring-boot`），或手动更新并重新配置 PATH。

---

### 七、帮助和文档
- **获取帮助**
- 如有问题，可查阅“如何”文档、Spring 官方网站、Stack Overflow（标签 `spring-boot`）。
- Bug 报告和文档改进通过 GitHub 管理。
- **文档结构**
- 包括入门指南、开发指南、构建工具插件、生产就绪功能等内容。

---

以上是《Spring Boot 3.0.0-M4 参考指南》的核心内容和关键信息总结。