Spring Boot 1.2.1.RELEASE Reference Documentation

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

摘要

This document provides a reference guide for Spring Boot 1.2.1.RELEASE, detailing its features, configurations, and usage. It covers requirements such as Java 6 and Spring Framework 4.1.3 or above, supported embedded servlet containers (Tomcat, Jetty, Undertow), and dependency management. The document also explains how to initialize new projects using the `spring init` command and customize the environment or ApplicationContext before startup. Additionally, it addresses troubleshooting auto-configuration issues and provides insights into the framework's internal workings, including classes annotated with @Conditional and @ConfigurationProperties.

AI总结

# Spring Boot 1.2.1.RELEASE 参考文档总结

## 核心特性
- **无需代码生成**：Spring Boot 不需要 XML 配置，简化了开发流程。
- **内置配置**：支持外部化配置，便于管理应用属性。
- **健康检查与指标**：提供健康检查和运行时指标监控。
- **嵌入式 Servlet 容器**：支持 Tomcat、Jetty 和 Undertow 等容器。

## 系统要求
- **Java 版本**：最低要求 Java 6，推荐使用 Java 8。
- **Spring Framework 版本**：4.1.3 或更高版本。
- **构建工具**：支持 Maven (3.2+) 和 Gradle (1.12+)。

## 嵌入式 Servlet 容器
- **Tomcat 8**：支持 Servlet 3.1，要求 Java 7+。
- **Tomcat 7**：支持 Servlet 3.0，要求 Java 6+。
- **Jetty 9**：支持 Servlet 3.1，要求 Java 7+。
- **Jetty 8**：支持 Servlet 3.0，要求 Java 6+。
- **Undertow 1.1**：支持 Servlet 3.1，要求 Java 7+。

## 依赖管理
Spring Boot 提供了一系列 Starter 依赖，简化了项目配置：
- `spring-boot-starter-logging`：日志管理。
- `spring-boot-starter-mail`：邮件发送。
- `spring-boot-starter-security`：安全功能。
- `spring-boot-starter-web`：Web 开发。
- 其他功能模块如 Redis、MongoDB、WebSocket 等均有对应的 Starter 依赖。

## 项目初始化
- 使用 `spring init` 命令快速创建新项目。
- 支持多种项目类型（Maven、Gradle）和依赖组合（如 Web、Data JPA）。
- 示例：`$ spring init --dependencies=web,data-jpa my-project` 创建一个基于 Maven 的 Web 应用。

## 自动配置报告
- 通过 DEBUG 日志或 Actuator 的 `autoconfig` 端点查看自动配置报告。
- 用于排查自动配置问题，了解已启用和未启用的功能。

## 环境与 ApplicationContext 自定义
- Spring Boot 提供 Application Listeners 和 Application Context Initializers。
- 可通过多种方式注册自定义扩展：
- 使用 `addListeners` 和 `addInitializers` 方法。
- 设置 `context.initialize.classes` 或 `context.listener.classes`。
- 通过 META-INF/spring.factories 打包为共享库。

## 总结
Spring Boot 1.2.1 提供了丰富的功能模块和灵活的配置方式，适用于快速构建企业级应用。其核心特性包括无需 XML 配置、内置 Servlet 容器支持、依赖管理和自动配置功能，极大简化了开发流程。