Spring Boot中文参考手册：快速入门与高级指南

需积分: 9 154 浏览量更新于2024-07-09 收藏 6.08MB PDF 举报

"Spring Boot 中文文档参考手册中文版.pdf" Spring Boot 是一个用于简化 Spring 应用程序初始搭建以及开发过程的框架。它集成了大量常用的第三方库配置，如 JDBC、MongoDB、JPA、RabbitMQ、Quartz 等，允许开发者通过简单的注解配置来快速构建可运行的应用程序。Spring Boot 的核心特性包括自动配置、内嵌式 Web 服务器（如 Tomcat 或 Jetty）以及起步依赖。该文档由 PhillipWebb、Dave Syer 等多位 Spring 社区贡献者共同编写，版本号为 2.1.1.RELEASE，发布于2012年至2018年期间。文档内容涵盖了从获取帮助、初步接触 Spring Boot 到深入了解其功能，再到生产环境的部署与优化，以及一系列高级主题。文档的章节结构清晰，主要包括以下部分： 1. **关于文档**：这部分可能介绍了文档的目的、版权信息和使用许可条款。 2. **获得帮助**：提供了获取 Spring Boot 相关帮助的途径，可能包括社区论坛、邮件列表、问题跟踪器等。 3. **第一步**：引导读者快速上手，了解如何开始使用 Spring Boot。 4. **使用Spring Boot**：详细介绍如何在项目中引入和配置 Spring Boot。 5. **了解Spring Boot功能**：阐述 Spring Boot 提供的各种功能，如自动配置、健康检查、安全配置等。 6. **转向生产**：讨论了将 Spring Boot 应用部署到生产环境的策略，包括性能调优、监控和日志管理。 7. **高级主题**：深入探讨一些特定或复杂的使用场景，如自定义 Starter、Spring Boot CLI 的高级用法等。 8. **入门**：这部分提供 Spring Boot 的简介，包括系统要求和安装方法。例如，对于 Servlet 容器的要求（如 Tomcat 或 Jetty），以及针对 Java 开发者的 Maven 和 Gradle 安装说明。此外，还详细讲解了 Spring Boot CLI（命令行接口）的安装，涵盖手动安装、SDKMAN、Homebrew、MacPorts、Windows Scoop 等多种平台的安装方法。 9. **开发您的第一个SpringBoot应用程序**：指导开发者创建 POM 文件，添加 Classpath 依赖，以及编写使用 `@RestController` 和 `@RequestMapping` 注解的代码，从而快速构建一个简单的 RESTful API。文档中的内容丰富且详细，是学习和掌握 Spring Boot 的宝贵资料，适合初学者和有经验的开发者参考。通过阅读这份文档，读者可以深入理解 Spring Boot 的核心概念，学会如何构建、测试和部署基于 Spring Boot 的应用程序。

2020/8/23 Spring Boot 中文文档参考手册中文版

https://www.springcloud.cc/spring-boot.html 16/298

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

Spring Boot可以轻松创建可以运行的独立的，基于生产级Spring的应用程序。我们对Spring平台和第三方库进行了自以为是的观点，以便您可

以尽量少开始。大多数Spring Boot应用程序需要非常少的Spring配置。

您可以使用Spring Boot创建可以使用 java -jar 或更多传统战争部署启动的Java应用程序。我们还提供了一个运行“spring脚本”的命令行工

具。

我们的主要目标是：

为所有Spring开发提供从根本上更快且可广泛访问的入门体验。

开箱即用，但随着需求开始偏离默认值而迅速摆脱困境。

提供大型项目（例如嵌入式服务器，安全性，度量标准，运行状况检查和外部化配置）通用的一系列非功能性功能。

绝对没有代码生成，也不需要XML配置。

9.系统要求

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

Spring Boot 2.1.1.RELEASE需要Java 8并且与Java 11兼容（包括在内）。Spring框架5.1.3.RELEASE 或以上也是必需的。

为以下构建工具提供了显式构建支持：

构建工具版

Maven 3.3+

Gradle 4.4+

9.1 Servlet容器

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

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

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

Spring Boot可以与“经典”Java开发工具一起使用，也可以作为命令行工具安装。无论哪种方式，您都需要Java SDK v1.8或更高版本。在开始

之前，您应该使用以下命令检查当前的Java安装：

$ java -version

如果您不熟悉Java开发，或者想要试用Spring Boot，则可能需要先尝试Spring Boot CLI（命令行界面）。否则，请继续阅读“经典”安装说

明。

10.1 Java Developer的安装说明

2020/8/23 Spring Boot 中文文档参考手册中文版

https://www.springcloud.cc/spring-boot.html 17/298

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

您可以像使用任何标准Java库一样使用Spring Boot。为此，请在类路径中包含相应的 spring-boot-*.jar 文件。Spring Boot不需要任何特殊

工具集成，因此您可以使用任何IDE或文本编辑器。此外，Spring Boot应用程序没有什么特别之处，因此您可以像运行任何其他Java程序一样运

行和调试Spring引导应用程序。

虽然您

可

以

复制Spring Boot罐，但我们通常建议您使用支持依赖关系管理的构建工具（例如Maven或Gradle）。

10.1.1 Maven安装

Spring Boot与Apache Maven 3.3或更高版本兼容。如果您尚未安装Maven，则可以按照maven.apache.org上的说明进行操作。

在许多操作系统上，Maven可以与软件包管理器一起安装。如果您使用OSX Homebrew，请尝试 brew install maven 。

Ubuntu用户可以运行 sudo apt-get install maven 。使用Chocolatey的 Windows用户可以从提升（管理员）提示符运

行 choco install maven 。

Spring Boot依赖项使用 org.springframework.boot groupId 。通常，您的Maven POM文件继承自 spring-boot-starter-parent 项

目，并声明对一个或多个“Starters”的依赖关系。Spring Boot还提供了一个可选的 Maven插件来创建可执行jar。

以下清单显示了典型的 pom.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

<groupId>com.example</groupId>

<artifactId>myproject</artifactId>

<version>0.0.1-SNAPSHOT</version>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-parent</artifactId>

<version>2.1.1.RELEASE</version>

</parent>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

</dependencies>

<build>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-maven-plugin</artifactId>

</plugin>

</plugins>

</build>

</project>

spring-boot-starter-parent 是使用Spring Boot的好方法，但它可能并不适合所有时间。有时您可能需要从其他父POM继

承，或者您可能不喜欢我们的默认设置。在这些情况下，请参见第13.2.2节“使用不带父POM的Spring Boot”作为使

用 import 范围的替代解决方案。

10.1.2 Gradle安装

Spring Boot与Gradle 4.4及更高版本兼容。如果您尚未安装Gradle，则可以按照gradle.org上的说明进行操作。

2020/8/23 Spring Boot 中文文档参考手册中文版

https://www.springcloud.cc/spring-boot.html 18/298

可以使用 org.springframework.boot group 声明Spring Boot依赖项。通常，您的项目会声明对一个或多个“Starters”的依赖关系。

Spring Boot提供了一个有用的Gradle插件，可用于简化依赖声明和创建可执行jar。

Gradle Wrapper

当您需要构建项目时，Gradle Wrapper提供了一种“获取”Gradle的好方法。它是一个小脚本和库，您可以与代码一起提交以引导构建过

程。有关详细信息，请参阅docs.gradle.org/4.2.1/userguide/gradle_wrapper.html。

有关Spring Boot和Gradle 入门的更多详细信息，请参阅Gradle插件参考指南的“ 入门”部分。

10.2安装Spring Boot CLI

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

Spring Boot CLI（命令行界面）是一个命令行工具，可用于使用Spring快速原型。它允许您运行Groovy脚本，这意味着您拥有熟悉的类似Java

的语法，而没有太多的样板代码。

您不需要使用CLI来使用Spring Boot，但它绝对是实现Spring应用程序的最快方法。

10.2.1手动安装

您可以从Spring软件存储库下载Spring CLI分发版：

spring-boot-cli-2.1.1.RELEASE-bin.zip

spring-boot-cli-2.1.1.RELEASE-bin.tar.gz

还提供最先进的快照分发。

下载完成后，请按照解压缩的存档中的 INSTALL.txt说明进行操作。总之，在 .zip 文件的 bin/ 目录中有一个 spring 脚本（Windows

为 spring.bat ）。或者，您可以将 java -jar 与 .jar 文件一起使用（该脚本可帮助您确保正确设置类路径）。

10.2.2使用SDKMAN安装！

SDKMAN！（软件开发工具包管理器）可用于管理各种二进制SDK的多个版本，包括Groovy和Spring Boot CLI。获取SDKMAN！从

sdkman.io并使用以下命令安装Spring Boot：

$ sdk install springboot

$ spring --version

Spring Boot v2.1.1.RELEASE

如果您为CLI开发功能并希望轻松访问您构建的版本，请使用以下命令：

前面的说明安装了一个名为 dev 实例的 spring 本地实例。它指向您的目标构建位置，因此每次重建Spring Boot时， spring 都是最新的。

您可以通过运行以下命令来查看它：

$ sdk ls springboot

================================================================================

Available Springboot Versions

================================================================================

> + dev

* 2.1.1.RELEASE

================================================================================

+ - local version

* - installed

> - currently in use

================================================================================

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.1.1.RELEASE-bin/spring-2.1.1.RE

$ sdk default springboot dev

$ spring --version

Spring CLI v2.1.1.RELEASE

2020/8/23 Spring Boot 中文文档参考手册中文版

https://www.springcloud.cc/spring-boot.html 19/298

10.2.3 OSX Homebrew安装

如果您使用的是Mac并使用Homebrew，则可以使用以下命令安装Spring Boot CLI：

$ brew tap pivotal/tap

$ brew install springboot

Homebrew将 spring 安装到 /usr/local/bin 。

如果您没有看到公式，那么您的brew安装可能已过时。在这种情况下，运行 brew update 并再试一次。

10.2.4 MacPorts安装

如果您使用的是Mac并使用MacPorts，则可以使用以下命令安装Spring Boot CLI：

$ sudo port install spring-boot-cli

10.2.5命令行完成

Spring Boot CLI包括为BASH和 zsh shell 提供命令完成的脚本。您可以在任何shell中 source 脚本（也称为 spring ）或将其放入您的个人或

系统范围的bash完成初始化中。在Debian系统上，系统范围的脚本位于 /shell-completion/bash ，并且当新shell启动时，该目录中的所有

脚本都将执行。例如，要使用SDKMAN！安装，请手动运行脚本，请使用以下命令：

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring

$ spring <HIT TAB HERE>

grab help jar run test version

如果使用Homebrew或MacPorts安装Spring Boot CLI，则命令行完成脚本将自动注册到shell。

10.2.6 Windows Scoop安装

如果您使用的是Windows并使用Scoop，则可以使用以下命令安装Spring Boot CLI：

> scoop bucket add extras

> scoop install springboot

Scoop安装 spring 到 ~/scoop/apps/springboot/current/bin 。

如果您没有看到应用清单，则您的scoop安装可能已过时。在这种情况下，请运行 scoop update 并重试。

10.2.7快速启动Spring CLI示例

您可以使用以下Web应用程序来测试您的安装。首先，创建一个名为 app.groovy 的文件，如下所示：

@RestController

class ThisWillActuallyRun {

@RequestMapping("/")

String home() {

"Hello World!"

}

然后从shell运行它，如下所示：

$ spring run app.groovy

随着依赖项的下载，应用程序的第一次运行速度很慢。后续运行要快得多。

2020/8/23 Spring Boot 中文文档参考手册中文版

https://www.springcloud.cc/spring-boot.html 20/298

在您喜欢的网络浏览器中打开 localhost:8080 。您应该看到以下输出：

Hello World!

10.3从早期版本的Spring Boot升级

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

如果要从早期版本的Spring Boot升级，请查看项目Wiki上的“迁移指南”，其中提供了详细的升级说明。另请查看 “发行说明”，了解每个

版本的“新的和值得注意的”功能列表。

升级到新功能版本时，某些属性可能已重命名或删除。Spring Boot提供了一种在启动时分析应用程序环境和打印诊断的方法，还可以在运行时

临时迁移属性。要启用该功能，请将以下依赖项添加到项目中：

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-properties-migrator</artifactId>

<scope>runtime</scope>

</dependency>

添加到环境后期的属性（例如使用 @PropertySource 时）将不会被考虑在内。

完成迁移后，请确保从项目的依赖项中删除此模块。

要升级现有CLI安装，请使用相应的软件包管理器命令（例如， brew upgrade ），或者，如果手动安装CLI，请按照标准说明操作，记住更

新 PATH 环境变量以删除任何旧版本引用。

11.开发您的第一个Spring Boot应用程序

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

本节介绍如何开发一个简单的“Hello World！”Web应用程序，该应用程序突出了Spring Boot的一些主要功能。我们使用Maven来构建这个

项目，因为大多数IDE都支持它。

该spring.io网站包含了许多“入门” 指导在使用Spring Boot。如果您需要解决特定问题，请先检查一下。

您可以通过转到start.spring.io并从依赖关系搜索器中选择“Web”启动器来快捷执行以下步骤。这样做会生成一个新的项目结

构，以便您可以立即开始编码。查看Spring Initializr文档以获取更多详细信息。

在开始之前，打开终端并运行以下命令以确保您安装了有效版本的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创建POM

90%高可用的千亿级微服务架构之道深入学习一线大厂必备微服务架构技术。VIP 教程限时免费领取。 ⇐ 立即查看

剩余297页未读，继续阅读

Dylan、

粉丝: 6229
资源: 177

Spring Boot中文参考手册：快速入门与高级指南

SpringBoot官方文档(中文)

Spring Boot 中文文档 参考手册.pdf

spring boot 官方中文文档.pdf

Java Spring boot 系列目录

spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.websocket.servlet.TomcatWebSocketServletAutoConfiguration

org.springframework.boot.web.reactive.error.ErrorWebExceptionHandler和org.springframework.web.server.WebExceptionHandler处理顺序

错误： 'org.springframework.boot.context.properties.source.ConfigurationPropertySource org.springframework.boot.context.properties.source.ConfigurationPropertySource.from(org.springframework.core.env.PropertySource)'

Current Spring Boot Application is about to shutdown..

Spring boot开发文档

基于Spring Boot旅游网站参考文献

最新资源

Spring Boot 中文文档参考手册.pdf