SpringBoot官方文档 v2.1.5 release

  • Part I. Spring Boot 参考指南
  • 1. 关于文档
  • 2. 获得帮助
  • 3. 第一步
  • 4. 使用Spring Boot 进行工作
  • 5. 学习Spring Boot的特性
  • 6. 移动至生产环境
  • 7. 高级内容
  • Part II. 开始
  • 8. 介绍Spring Boot
  • 9. 系统要求
  • 9.1 Servlet容器
  • 10. 安装Spring Boot
  • 10.1 Java开发者的安装说明
  • 10.2 安装Spring Boot CLI
  • 10.3 从Spring Boot旧版本中升级
  • 11. 开发你的第一个Spring Boot应用
  • 11.1
  • 11.2
  • 11.3 编写代码
  • 11.4 运行样例
  • 11.5 创建可执行Jar包
  • Part IX. "怎样做"向导



作者: Phillip Webb , Dave Syer , Josh Long , Stéphane Nicoll , Rob Winch , Andy Wilkinson , Marcel Overdijk ,


Christian Dupuis , Sébastien Deleuze , Michael Simons , Vedran Pavi# , Jay Bryant , Madhura Bhave

翻译：HiramCHEN

Copyright © 2012-2018
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

Part I. Spring Boot 参考指南

1. 关于文档

Spring Boot参考指南可以以以下三种方式获取： • HTML • PDF • EPUB

最新副本可以从docs.spring.io/spring-boot/docs/current/reference中获取。 该文档副本可用于个人用途或者分享给他人，但是不得用于任何盈利性用途，且每一个副本都要包含该版权说明。 注意，不管是打印版本还是电子版本。

2. 获得帮助

If you have trouble with Spring Boot, we would like to help. 如果你遇到Spring Boot的问题，我们很愿意提供帮助。 • 看一下“怎么做”文档。他们提供了大多数问题的解决方案。 • 学习Spring基础。Spring Boot是构建在其他Spring项目之上的。到spring.io网站查找参考文档。如果你是以Spring开始的，尝试一下里面的一个向导。 • 提问。我们会监听stackoverflow.com上带有标签 spring-boot的问题。 • 在github.com/spring-projects/spring-boot/issues上提交Spring Boot的Bug。

注： 所有Spring Boot都是开源的，包括相关文档。如果你发现文档哪里有问题，或者想要改善一下文档，请参与进来。

3. 第一步

如果您开始使用Spring Boot或“Spring”，请从以下主题开始：
• 从头开始：概述 | 要求 | 安装 • 教程：第1部分 | 第2部分
• 运行示例：第1部分 | 第2部分

4. 使用Spring Boot 进行工作

5. 学习Spring Boot的特性

6. 移动至生产环境

7. 高级内容



Part II. 开始



8. 介绍Spring Boot

Spring Boot可以轻松地创建独立的、生产级的可运行Spring的应用程序。我们对Spring平台和第三方库有独特的观点，这样你就可以

以最少的困扰开始。大多数Spring Boot应用程序只需要很少的Spring配置。

可以使用Spring Boot创建Java应用程序，通过使用Java -jar或其他传统的war的部署方式。我们还提供了一个运行“Spring脚本”的命令行工具。

我们的主要目标是：
• 为所有的Spring开发者提供一个极快且涉及面广的入门体验。
• 专注于开箱即用，但当需求变更时也能快速解决问题。
• 提供一系列大型项目常见的非功能特性（例如嵌入式服务器、安全性、度量、运行状况检查和外部化配置）。
• 完全没有代码生成，也不需要XML配置。



9. 系统要求

Spring Boot 2.1.5.REALEASE 要求Java 8且兼容到Java 11(包括11)。需要Spring Framework 5.1.7.REALEASE或者更高的版本。

显式构建支持由下列构建工具提供

构建工具

版本

Maven

3.3+

Gradle

4.4+

9.1 Servlet容器

Spring Boot支持下列内置servlet容器

名字

Servlet版本

Tomcat 9.0

4.0

Jetty 9.4

3.1

Undertow 2.0

4.0

你也可以将Spring Boot应用程序部署到任意兼容Servlet 3.1+的容器中。



10. 安装Spring Boot

Spring Boot可在“经典”的Java开发工具中使用或者安装为命令行工具。
无论哪种方式，都需要Java SDK V1.8或更高版本。在开始之前，应该检查当前的Java安装，使用下面命令：

$ java -version

如果你是首次进行Java开发或者你想体验一下Spring Boot，你可以先尝试使用Spring Boot CLI(命令行界面)。否则，请阅读“经典”安装说明。

10.1 Java开发者的安装说明



10.2 安装Spring Boot CLI

10.3 从Spring Boot旧版本中升级



11. 开发你的第一个Spring Boot应用

该节中介绍了怎么样开发一个“Hello World”网络应用程序，突出了一些Spring Boot的关键特性。我们使用Maven来构建应用，因为大多数的IDE都支持它。

(提示：
spring.io网站包含了很多使用Spring Boot的“开始”向导。如果你想解决某个特定的问题，可以先去找找看。

你可以简化步骤，到start.spring.io上从依赖选择器中选择“Web” starter。这样做可以生成一个新的项目结构让你马上开始编代码，查阅Spring intializr文档获得更多内容。)

在开始之前，请打开一个终端，运行下面命令，确保你安装了有效的Java和Maven版本

$ java -version
java version "1.8.0_102"
Java(TM) SE Runtime Environment (build 1.8.0_102-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode)
$ mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-17T14:33:14-04:00)
Maven home: /usr/local/Cellar/maven/3.3.9/libexec
Java version: 1.8.0_102, vendor: Oracle Corporation

(注：
该样例需要在你自己的文件夹中创建。后续的说明假设你已经创建了合适的文件夹并且你处于当前目录下。
)

11.1

11.2



11.3 编写代码



11.4 运行样例



11.5 创建可执行Jar包



Part IX. "怎样做"向导