Spring Boot Reference Guide 2.0.0.RELEASE

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

摘要

文档为Spring Boot 2.0.0.RELEASE参考指南，介绍了Spring Boot CLI的安装方式（手动下载或通过SDKMAN!），以及构建系统（推荐Maven或Gradle）和依赖管理机制（每个版本提供受支持的依赖列表，可自动管理版本）。文档还列出了常见的Spring Boot starter依赖及其版本号，并详细说明了application.properties和YAML文件的配置属性，包括日志、AOP、应用名称等核心属性，以及如何根据环境（如开发、生产）通过profile切换配置。

AI总结

Spring Boot 2.0.0.RELEASE 参考指南摘要

**Spring Boot CLI 安装**
- 可通过手动下载（zip/tar.gz）或使用 SDKMAN! 工具安装。
- 手动安装：解压后运行 bin/ 目录下的 spring 脚本（Windows 为 spring.bat），也可直接使用 java -jar 运行 .jar 文件。
- SDKMAN! 安装：执行 `sdk install springboot`，安装后可用 `spring --version` 验证版本为 v2.0.0.RELEASE。
- 支持为 CLI 开发功能时，通过 SDKMAN! 安装本地开发版本并设置为默认。

**构建系统**
- 推荐使用 Maven 或 Gradle 等支持依赖管理的构建系统。
- Spring Boot 每个版本提供一份受支持的依赖列表（即"材料清单"），用户无需在构建配置中指定这些依赖的版本，Spring Boot 会自动管理。
- 用户可以覆盖 Spring Boot 推荐的版本，但强烈建议不指定 Spring Framework 的版本。

**Maven 配置**
- Maven 用户可继承 `spring-boot-starter-parent` 项目，获得以下默认配置：
- Java 1.8 作为默认编译级别
- UTF-8 源码编码
- 依赖版本管理（继承自 `spring-boot-dependencies`）
- 资源过滤和插件配置
- 对 `application.properties` 和 `application.yml` 使用 `@..@` 占位符（可覆盖）

**YAML 多环境配置**
- YAML 文件支持多文档结构（用 `---` 分隔），每个文档可通过 `spring.profiles` 指定生效的 profile。
- 示例：默认端口 9000，development profile 下端口 9001，production profile 下端口 0。
- YAML 文档按顺序合并，后面的值覆盖前面的。
- 也可使用 `application-${profile}.properties` 文件实现类似功能。

**外部属性配置**
- Spring Boot 在运行时将 `application.properties`（或 .yml 文件等）中的外部属性绑定到应用。
- 所有支持的属性无法在一个位置完整列出，因为第三方 jar 可能贡献额外属性。
- 运行中的应用可通过 Actuator 的 `configprops` 端点查看所有可绑定的属性。
- 附录提供了常用 Spring Boot 属性的示例文件，但建议只选用需要的属性，而非全盘复制。

**文档中列出的主要 Starter 依赖（版本均为 2.0.0.RELEASE）**
- spring-boot-starter-web、webflux、websocket、web-services
- spring-boot-starter-data-jpa、data-mongodb、data-redis、data-cassandra 等
- spring-boot-starter-security、batch、cache、integration
- spring-boot-starter-activemq、amqp、aop
- spring-boot-starter-freemarker、groovy-templates、mustache、thymeleaf
- spring-boot-starter-test、logging、log4j2、json
- spring-boot-starter-jetty、jersey、jooq、quartz
- 以及 Spring Cloud Connectors、Spring Data 系列等第三方库