Spring Boot 2.2.14.BUILD-SNAPSHOT Reference Documentation

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

摘要

The document provides a comprehensive reference guide for Spring Boot 2.2.14.BUILD-SNAPSHOT. It covers the framework's core features, system requirements, installation instructions, and production-ready features such as monitoring and management via HTTP endpoints or JMX. The guide also details how to enable production-ready features using the spring-boot-actuator module, configure logging, and use build tools like Maven, Gradle, and Ant. Additionally, it provides information on upgrading from earlier versions and accessing community support through various channels.

AI总结

《Spring Boot 2.2.14.BUILD-SNAPSHOT 参考文档》摘要如下：

---

### 1. 文档概述
- **文档形式**：提供多页HTML、单页HTML和PDF三种格式，最新版本可在[docs.spring.io/spring-boot/docs/current/reference](https://docs.spring.io/spring-boot/docs/current/reference)获取。
- **版权信息**：允许免费分发和使用，但每份副本需包含版权声明。

---

### 2. 入门指南
- **Spring Boot 简介**：Spring Boot 是一个用于构建独立、可直接运行的生产级Spring应用程序的工具。它简化了配置，支持多种部署方式（如jar包或war包），并提供命令行工具。
- **核心目标**：
- 提供快速上手的Spring开发体验。
- 默认配置即用，但支持根据需求进行高度定制。
- 提供常见非功能性特性（如嵌入式服务器、安全性、指标收集、健康检查等）。
- 无需代码生成或XML配置。
- **系统要求**：
- Java 8 或更高版本（最高支持Java 15）。
- Spring Framework 5.2.12.RELEASE 或更高版本。
- 支持 Maven 3.3+、Gradle 5.x/6.x（4.10 亦支持，但处于弃用状态）。
- **嵌入式Servlet容器**：支持Tomcat 9.0（Servlet 4.0）。

---

### 3. 配置与构建工具
- **构建工具配置**：
- **Maven**：在`pom.xml`中添加依赖。
- **Gradle**：在`build.gradle`中添加依赖。
- **Ant**：使用`spring-boot-antlib`和`ivy.xml`进行依赖管理。
- **可执行Jar包**：通过Maven或Gradle插件生成。

---

### 4. 核心功能
- **外部配置**：支持多种配置源（如properties文件、YAML文件、环境变量等）。
- **概况 profiles**：
- 通过`spring.profiles.active`设置活动概况。
- 支持基于YAML文件的概况特定配置。
- **日志记录**：
- 默认使用Logback，支持Java Util Logging、Log4J2等。
- 日志格式示例：

    2023-10-01 12:34:56.789 INFO 12345--- [main] com.example.MyApp : Starting application

---

### 5. 生产就绪特性
- **Spring Boot Actuator**：通过`spring-boot-starter-actuator`依赖启用。
- **端点功能**：
- 提供监控和管理_endpoint_（如health、metrics等）。
- 每个端点可单独启用或禁用，并支持HTTP或JMX访问。

---

### 6. 工具与测试
- **Spring Boot CLI**：
- 支持Groovy脚本运行。
- 提供命令行自动补全，适用于BASH和zsh。
- 示例：`spring run hello.groovy`运行Groovy应用。
- **测试**：支持基于JUnit的测试框架。

---

### 7. 进阶主题
- **版本升级**：升级时需仔细阅读版本发布说明，确保依赖兼容性。
- **扩展**：支持自定义自动配置和条件注解。

---

以上为《Spring Boot 2.2.14.BUILD-SNAPSHOT 参考文档》的核心内容总结，涵盖了从入门到生产环境的关键信息。