SpringBoot2中文参考手册中文文档_springbootapi文档

需积分: 50 1.7k 浏览量更新于2023-05-29 评论收藏 3.95MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源评论

资源推荐

Spring Boot Reference Guide 译译 : Spring Boot参考 指 南参 考 指 南
本帮助文档是 觉得烦死 整理--QQ:654638585
声明：
中文文档都是由软件翻译,翻译内容未检查校对,文档内容仅供参考。 
您可以任意转发，但请至保留作者&出处(http://bolg.fondme.cn)，请尊重作者劳动成果,谢谢！
Authors 译译 :作 者作 者
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
2.0.3.RELEASE
版权所有©2012-2018
本文件副本可供您自行使用并分发给其他人，前提是您不收取任何此类副本的费用，并进一步规定每份副本均包含此版权声明，无论是以印刷版还是电子版分发。
Part I. Spring Boot Documentation 译译 :第一部 分第一 部 分  。。 Spring Boot文档文档
本节简要介绍Spring Boot参考文档。 它作为文档其余部分的映射。
1. About the Documentation 译译 : 1.关于文 档关于 文 档
Spring Boot参考指南可用
HTML
PDF
EPUB
最新副本可在 docs.spring.io/spring-boot/docs/current/reference获得 。
本文件副本可供您自行使用并分发给其他人，前提是您不收取任何此类副本的费用，并进一步规定每份副本均包含此版权声明，无论是以印刷版还是电子版分发。
2. Getting Help 译译 : 2.获得帮 助获得 帮 助
如果您在Spring Boot遇到问题，我们希望能提供帮助。
Try the How-to documents. They provide solutions to the most common questions.
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.
Ask a question. We monitor stackoverflow.com for questions tagged with  spring-boot .
Report bugs with Spring Boot at github.com/spring-projects/spring-boot/issues.
所有的Spring Boot都是开源的，包括文档。 如果您发现文档有问题，或者您想改进它们，请致电get involved 。
3. First Steps 译译 : 3.第一步第 一 步
如果您正在开始使用Spring Boot或“Spring”，请从 the following topics开始：
From scratch: 概述 | Requirements | Installation
Tutorial: Part 1 | Part 2
Running your example: Part 1 | Part 2
4. Working with Spring Boot 译译 : 4.使用使用 Spring Boot
准备好真正开始使用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
5. Learning about Spring Boot Features 译译 : 5.了解了解 Spring Boot特性特性
需要更多关于Spring Boot的核心特性的细节？ 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: 概述 | JMS
Testing: 概述 | Boot Applications | Utils
Extending: Auto-configuration | @Conditions

6. Moving to Production 译译 : 6.转 向 生 产转 向 生 产
当您准备将Spring Boot应用程序推向生产时，我们有 some tricks ，您可能会喜欢：
Management endpoints: 概述 | Customization
Connection options: HTTP | JMX
Monitoring: Metrics | Auditing | Tracing | Process
7. Advanced Topics 译译 : 7.高级主 题高级 主 题
最后，我们有更多高级用户的几个主题：
Spring Boot Applications Deployment: Cloud Deployment | OS Service
Build tool plugins: Maven | Gradle
Appendix: Application Properties | Auto-configuration classes | Executable Jars
Part II. Getting Started 译译 :第 二 部 分 。第 二 部 分 。  入门入门
如果您正在开始使用Spring Boot或“Spring”，请阅读本节。 它回答了基本的“什么”，“怎么做”以及“为什么”这些问题。 它包括Spring Boot的介绍以及安装说明。 然后，我们
将引导您构建您的第一个Spring Boot应用程序，并讨论一些核心原则。
8. Introducing Spring Boot 译译 : 8.介绍介绍 Spring Boot
Spring Boot可以轻松创建可以运行的独立的，生产级的基于Spring的应用程序。 我们对Spring平台和第三方库采取自己的看法，以便您尽可能少用大惊小怪。 大多数
Spring Boot应用程序只需要很少的Spring配置。
您可以使用Spring Boot创建可通过使用 java -jar 或更多传统战争部署启动的Java应用程序。 我们还提供了一个运行“弹簧脚本”的命令行工具。
我们的主要目标是：
Provide a radically faster and widely accessible getting-started experience for all Spring development.
Be opinionated out of the box but get out of the way quickly as requirements start to diverge from the defaults.
Provide a range of non-functional features that are common to large classes of projects (such as embedded servers, security, metrics, health checks, and externalized
configuration).
Absolutely no code generation and no requirement for XML configuration.
9. System Requirements 译译 : 9.系统 要 求系 统 要 求
Spring Boot 2.0.3.RELEASE需要Java 8 or 9和Spring Framework 5.0.7.RELEASE或以上。 为Maven 3.2+和Gradle 4提供了明确的构建支持。
9.1 Servlet Containers 译译 : 9.1 Servlet容 器容 器
Spring Boot支持以下嵌入式servlet容器：
Name Servlet Version
Tomcat 8.5 3.1
码头9.4 3.1
Undertow 1.4 3.1
您也可以将Spring Boot应用程序部署到任何与Servlet 3.1+兼容的容器。
10. Installing Spring Boot 译译 : 10.安装安装 Spring Boot
Spring Boot可以用于“经典”Java开发工具或作为命令行工具安装。 无论哪种方式，你需要Java SDK v1.8或更高。 在开始之前，您应该使用以下命令检查当前的Java安装：
$ java -version
如果您对Java开发还不熟悉 ，或者想要试验Spring Boot，则可能需要先尝试Spring Boot CLI （命令行界面）。 否则，请阅读“经典”安装说明。
10.1 Installation Instructions for the Java Developer 译译 : 10.1 Java Developer的安 装 说 明的安装 说 明
您可以像使用任何标准Java库一样使用Spring Boot。 为此，请在您的类路径中包含相应的 spring-boot-*.jar 文件。 Spring Boot不需要任何特殊的工具集成，因此您可
以使用任何IDE或文本编辑器。 此外，Spring Boot应用程序没有什么特别之处，因此您可以像运行其他任何Java程序一样运行和调试Spring Boot应用程序。
虽然您 
可以
复制Spring Boot jar，但我们通常建议您使用支持依赖管理的构建工具（如Maven或Gradle）。
10.1.1 Maven Installation 译译 : 10.1.1 Maven安装安装
Spring Boot与Apache Maven 3.2或更高版本兼容。 如果您尚未安装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 plugin来创建可执行的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.0.3.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继承，或者您可能不喜欢我

们的默认设置。在这些情况下，请参阅Section 13.2.2, “Using Spring Boot without the Parent POM”了解使用 import 范围的替代解决方案。

10.1.2 Gradle Installation 译译 : 10.1.2 Gradle安装安装

Spring Boot与Gradle 4兼容。如果您尚未安装Gradle，则可以按照 gradle.org的说明操作。

Spring引导依赖可以通过使用 org.springframework.boot group 来声明。通常，您的项目将依赖关系声明为一个或多个“Starters” 。 Spring Boot提供了一个有用

的Gradle plugin ，可用于简化依赖声明和创建可执行的jar。

Gradle包装包装

当您需要构建项目时，Gradle Wrapper提供了一种“获取”Gradle的好方法。这是一个小脚本和库，与代码一起提交以引导构建过程。有关详细信息，请参

阅docs.gradle.org/4.2.1/userguide/gradle_wrapper.html 。

以下示例显示了一个典型的 build.gradle 文件：

plugins {

id 'org.springframework.boot' version '2.0.3.RELEASE'

id 'java'

}

jar {

baseName = 'myproject'

version = '0.0.1-SNAPSHOT'

}

repositories {

jcenter()

}

dependencies {

compile("org.springframework.boot:spring-boot-starter-web")

testCompile("org.springframework.boot:spring-boot-starter-test")

}

10.2 Installing the Spring Boot CLI 译译 : 10.2安装安装 Spring Boot CLI

Spring Boot CLI（命令行界面）是一个命令行工具，您可以使用它来快速使用Spring进行原型开发。它可以让你运行Groovy脚本，这意味着你有一个熟悉的类Java语法，

没有太多的样板代码。

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

10.2.1 Manual Installation 译译 : 10.2.1手动安装手动安装

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

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

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

切边 snapshot distributions也可用。

下载后，请按照解压缩归档中的INSTALL.txt说明操作。总之，在 .zip 文件的 bin/ 目录中有 spring 脚本（ spring.bat 于Windows的 .zip 。或者，您可以使

用 java -jar 和 .jar 文件（该脚本可帮助您确保类路径设置正确）。

10.2.2 Installation with SDKMAN! 译译 : 10.2.2使用使用 SDKMAN安装！安装！

SDKMAN！（软件开发工具包管理器）可用于管理各种二进制SDK的多个版本，包括Groovy和Spring Boot CLI。获取SDKMAN！从sdkman.io并通过使用以下命令安装

Spring Boot：

$ sdk install springboot

$ spring --version

Spring Boot v2.0.3.RELEASE

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

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

$ sdk default springboot dev

$ spring --version

Spring CLI v2.0.3.RELEASE

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

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

$ sdk ls springboot

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

Available Springboot Versions

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

> + dev

* 2.0.3.RELEASE

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

+ - local version

* - installed

> - currently in use

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

10.2.3 OSX Homebrew Installation 译译 : 10.2.3 OSX自制软件安装自制软件安装

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

$ brew tap pivotal/tap

$ brew install springboot

Homebrew安装 spring 至 /usr/local/bin 。

如果您没有看到该公式，那么您的brew的安装可能会过时。在这种情况下，请运行 brew update 试。

10.2.4 MacPorts Installation 译译 : 10.2.4 MacPorts安装安装

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

$ sudo port install spring-boot-cli

10.2.5 Command-line Completion 译译 : 10.2.5命令行完成命令行完成

Spring Boot CLI包含为BASH和zsh外壳提供命令完成的脚本。您可以在任何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 Installation 译译 : 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 update 试。

10.2.7 Quick-start Spring CLI Example 译译 : 10.2.7快速启动快速启动 Spring CLI示例示例

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

@RestController

class ThisWillActuallyRun {

@RequestMapping("/")

String home() {

"Hello World!"

}

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

$ spring run app.groovy

由于下载依赖项，应用程序的第一次运行速度很慢。后续运行速度更快。

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

Hello World!

10.3 Upgrading from an Earlier Version of Spring Boot 译译 : 10.3从较早版本的从较早版本的 Spring Boot升级升级

如果您正在从早期版本的Spring Boot进行升级，请检查提供详细升级说明的“migration guide” on the project wiki 。还请检查“release notes”以获取每个版本的“新的和值得注

意的”功能列表。

要升级现有的CLI安装，请使用相应的软件包管理器命令（例如， brew upgrade ），或者如果您手动安装了CLI，请按照 standard instructions ，记住更新您的 PATH 环

境变量以删除任何较旧的引用。

11. Developing Your First Spring Boot Application 译译 : 11.开发你的第一个开发你的第一个 Spring Boot应用程序应用程序

本节介绍如何开发一个简单的“Hello World！”Web应用程序，该应用程序强调了Spring Boot的一些主要功能。我们使用Maven来构建这个项目，因为大多数IDE都支持它。

该spring.io网站包含许多€œGettingStartedâ€ guides使用Spring的引导。如果您需要解决特定问题，请先在那里查看。

您可以通过转到start.spring.io并从依赖关系搜索器中选择“Web”起始器来缩短以下步骤。这样做会产生一个新的项目结构，以便您可以start coding right away

。查看Spring Initializr documentation了解更多详情。

在开始之前，请打开终端并运行以下命令以确保您已安装了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.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T16:41:47+00:00)

Maven home: /usr/local/Cellar/maven/3.3.9/libexec

Java version: 1.8.0_102, vendor: Oracle Corporation

此示例需要在其自己的文件夹中创建。后续说明假定您已经创建了合适的文件夹，并且它是您当前的目录。

11.1 Creating the POM 译译 : 11.1创建创建 POM

我们需要先创建一个Maven pom.xml 文件。 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.0.3.RELEASE</version>

</parent>

</project>

前面的列表应该给你一个工作版本。您可以通过运行 mvn package 来测试它（现在，您可以忽略“jar将为空 - 没有内容被标记为包含！”警告）。

此时，您可以将项目导入IDE（大多数现代Java IDE包含对Maven的内置支持）。为了简单起见，我们在本例中继续使用纯文本编辑器。

剩余188页未读，继续阅读

觉得烦死

粉丝: 192
资源: 30

会员权益专享

Spring Boot 2 中文参考手册中文文档

评论0

会员权益专享

最新资源

Spring Boot 2 中文 参考手册 中文文档

评论0

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

Spring Boot 2.0.0中文参考手册

spring boot 官方中文文档.pdf

java框架Spring Boot学习文档

spring boot 2 学习笔记

spring-framework 5 中文 参考手册 中文文档

Spring Cloud Finchley.RELEASE 中文 参考手册 中文文档

spring boot 学习资料

spring boot 中文回答

给我一个spring boot官方文档WebSocket部分的中文翻译

spring boot 学习路径

Spring Cloud Dalston 中文文档 参考手册 中文版 带书签

Spring boot集成swagger2生成接口文档的全过程

spring boot 2.0.1中文文档.pdf

spring boot项目教程

spring boot 的特点

spring boot2.0官网中文文档

用spring boot 写一个注册功能

前端开发简历模板-eb前端开发-3年-上海.docx

前端大厂最新面试题-yuanfudao.docx

会员权益专享

最新资源

Spring Boot 2 中文参考手册中文文档

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

spring-framework 5 中文参考手册中文文档

Spring Cloud Finchley.RELEASE 中文参考手册中文文档

Spring Cloud Dalston 中文文档参考手册中文版带书签