Documentation Overview

This section provides a brief overview of Spring Boot reference documentation. It serves as a map for the rest of the document.

该部分提供了 Spring Boot 参考文档的简介，它作为接下来的文档的一个指引。

1. About the Documentation（关于本文档）

The Spring Boot reference guide is available as:

• Multi-page HTML

• Single page HTML

• PDF

The latest copy is available at docs.spring.io/spring-boot/docs/current/reference/.

Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.

2. Getting Help（获取帮助）

If you have trouble with Spring Boot, we would like to help.

• Try the How-to documents. They provide solutions to the most common questions.

• 最常见的问题的解决方案见 How-to documents。

• Learn the Spring basics. Spring Boot builds on many other Spring projects. Check the spring.io web-site for a wealth（众多） of reference documentation. If you are starting out with Spring, try one of the guides.

• 学完 Spring 基础之后，Spring Boot 构建在很多其它 Spring 项目上，可以查阅 spring.io 网站获取更多的参考文档，如果从 Spring 启动，可以参考 guides.

• Ask a question. We monitor stackoverflow.com for questions tagged with spring-boot.

• 如果有疑问可以在 stackoverflow.com 上提出，并打上 spring-boot 的标记。

• Report bugs with Spring Boot at github.com/spring-projects/spring-boot/issues.

• 可以通过 github.com/spring-projects/spring-boot/issues 报告有关 Spring Boot 的 Bug。

All of Spring Boot is open source, including the documentation. If you find problems with the docs or if you want to improve them, please get involved.

3. Upgrading from an Earlier Version（从早期版本升级）

Instructions for how to upgrade from earlier versions of Spring Boot are provided on the project wiki. Follow the links in the release notes section to find the version that you want to upgrade to.

在项目的 wiki 中提供了如何从 Spring Boot 早期版本升级的说明。可以在 release notes 部分选择想要升级的版本。

Upgrading instructions are always the first item in the release notes. If you are more than one release behind, please make sure that you also review the release notes of the versions that you jumped.

升级说明总是在发布文档的第一部分，如果你相比发布的版本落后不止一个版本，请同时阅读说要跳过的所有版本的说明文档。

You should always ensure that you are running a supported version of Spring Boot.

同时你要确认你运行的是 supported version 列表中所支持的版本。

补充：该部分为 supported version 部分的列表（截止 2020.12.13），最新的可以访问上述网址

Released Versions

The following releases are actively maintained:

Version	Released	OSS Support Until	Expected End of Life
2.4.x	November 2020	November 2021	August 2022
2.3.x	May 2020	May 2021	February 2022
2.2.x	October 2019	October 2020	July 2021

The following releases are end of life:

Version	Released	End of Life	Notes
2.1.x	October 2018	November 2020
2.3.x	March 2018	April 2019
1.5.x	January 2017	August 2019	Last in the 1.x line.

4. First Steps

If you are getting started with Spring Boot or 'Spring' in general, start with the following topics:

• From scratch: Overview | Requirements | Installation

• Tutorial: Part 1 | Part 2

• Running your example: Part 1 | Part 2

5. Working with Spring Boot

Ready to actually start using Spring Boot? We have you covered:

• Build systems: Maven | Gradle | Ant | Starters

• Best practices: Code Structure | @Configuration | @EnableAutoConfiguration | Beans and Dependency Injection

• Running your code: IDE | Packaged | Maven | Gradle

• Packaging your app: Production jars

• Spring Boot CLI: Using the CLI

6. Learning about Spring Boot Features（Spring Boot 特征）

Need more details about Spring Boot’s core features? The following content is for you:

• Core Features: SpringApplication | External Configuration | Profiles | Logging

• Web Applications: MVC | Embedded Containers

• Working with data: SQL | NO-SQL

• Messaging: Overview | JMS

• Testing: Overview | Boot Applications | Utils

• Extending: Auto-configuration | @Conditions

7. Moving to Production

When you are ready to push your Spring Boot application to production, we have some tricks that you might like:

• Management endpoints: Overview

• Connection options: HTTP | JMX

• Monitoring: Metrics | Auditing | HTTP Tracing | Process

8. Advanced Topics

Finally, we have a few topics for more advanced users:

• Spring Boot Applications Deployment: Cloud Deployment | OS Service

• Build tool plugins: Maven | Gradle

• Appendix: Application Properties | Configuration Metadata | Auto-configuration Classes | Test Auto-configuration Annotations | Executable Jars | Dependency Versions