Spring Boot Reference Guide 1.5.12.RELEASE

• 语言: 中文（简体）
• 格式: .pdf
• 来源: docs.spring.io

摘要

文档为Spring Boot 1.5.12.RELEASE参考指南，系统要求Java 7及以上和Spring Framework 4.3.16.RELEASE，推荐Java 8。支持内嵌Servlet容器如Tomcat 8/7、Jetty 9.3/9.2/8、Undertow 1.3，可部署至Servlet 3.0+容器。推荐使用Maven或Gradle构建系统，依赖管理由Spring Boot自动处理，无需指定版本。支持FreeMarker、Groovy、Thymeleaf、Mustache等模板引擎，模板自动从src/main/resources/templates加载。提供默认错误处理映射/error，返回JSON或HTML格式。支持自定义Favicon和ConfigurableWebBindingInitializer。

AI总结

Spring Boot 1.5.12.RELEASE 是一款简化 Spring 应用开发的框架，核心特点是无需代码生成和 XML 配置，并提供指标、健康检查、外部化配置等功能。

**系统要求**
- 默认需要 Java 7 和 Spring Framework 4.3.16.RELEASE 及以上版本，Java 6 需额外配置，官方推荐使用 Java 8。
- 内嵌支持 Tomcat 8/7、Jetty 9.3/9.2/8、Undertow 1.3 等 Servlet 容器，也支持部署到任何 Servlet 3.0+ 容器。

**构建系统**
- 推荐使用 Maven（3.2+）或 Gradle（2.9+ 或 3.x）进行依赖管理。
- Spring Boot 提供了一份经过整理的依赖列表（Bills of Materials），用户无需为受支持的依赖指定版本，升级 Spring Boot 时这些依赖会同步升级。但用户仍可手动覆盖版本。

**Maven 配置**
- 通过继承 `spring-boot-starter-parent` 项目，可获得默认配置，包括 Java 1.6 编译级别、UTF-8 编码、依赖管理、资源过滤等。
- 由于默认配置文件使用 Spring 风格占位符（`${..}`），Maven 过滤已改为使用 `@..@` 占位符。

**Web 与模板引擎**
- Spring MVC 支持 Thymeleaf、FreeMarker、Groovy、Mustache 等模板引擎，模板文件默认从 `src/main/resources/templates` 自动加载。
- 注意：应避免使用 JSP，因为其在嵌入式 Servlet 容器中存在已知限制。若 IDE 类路径顺序导致模板找不到，可配置模板前缀为 `classpath*:/templates/`。

**错误处理**
- Spring Boot 默认提供 `/error` 映射，为机器客户端返回 JSON 格式的错误详情，为浏览器客户端返回 HTML 格式的“白标”错误视图。
- 可通过实现 `ErrorController` 或添加 `ErrorAttributes` Bean 来自定义错误处理。

**自定义 Favicon**
- 在静态内容位置或类路径根目录下放置 `favicon.ico` 文件，应用会自动将其作为网站图标。

**ConfigurableWebBindingInitializer**
- 若用户自定义了 `ConfigurableWebBindingInitializer` Bean，Spring Boot 会自动配置 Spring MVC 使用它。