入门

如果你正在开始使用Spring Boot，或一般的 "Spring"，请先阅读本节。它回答了 "什么？"、"如何？"和 "为什么？"这些基本问题。它包括对Spring Boot的介绍，以及安装说明。然后，我们将引导你构建你的第一个Spring Boot应用程序，在此过程中讨论一些核心原则。

Spring Boot编程思想(核心篇) SpringBoot开发教程正版书籍 JavaE ￥141.6 购买

1. 介绍Spring Boot

Spring Boot帮助你创建可以运行的独立的、基于Spring的生产级应用程序。我们对Spring平台和第三方库持一种观点，这样你就能以最少的麻烦开始工作。大多数Spring Boot应用程序只需要很少的Spring配置。

你可以使用Spring Boot来创建Java应用程序，可以通过使用java -jar或更传统的war部署来启动。我们还提供了一个运行 "spring scripts "的命令性工具。

我们的主要目标是：

- 为所有的Spring开发提供一个从根本上更快、更广泛的入门体验。

- 开箱即有意见，但当需求开始偏离默认值时，迅速脱身。

- 提供一系列大类项目常见的非功能特性（如嵌入式服务器、安全、度量、健康检查和外部化配置）。

- 绝对没有代码生成，也没有对XML配置的要求。

2. 系统要求

Spring Boot 3.0.0需要Java 17，并可兼容到Java 19。还需要Spring Framework 6.0.2或以上版本。

为以下构建工具提供明确的构建支持：

2.1. 小程序容器

Spring Boot支持以下嵌入式Servlet容器：

Name	Servlet Version
Tomcat 10.0	5.0
Jetty 11.0	5.1
Undertow 2.2(Jakarta EE 9 variant)	5.0

你也可以将Spring Boot应用部署到任何兼容Servlet 5.0+的容器中。

2.2. GraalVM原生图像

Spring Boot应用程序可以使用GralVM 22.3或以上版本转换为Native Image。

可以使用本地构建工具Gradle/Maven插件或GralVM提供的本地图像工具来创建图像。你也可以使用native-image Paketo buildpack来创建本地镜像。

支持以下版本：

Name	Version
CraalVm Communtity	22.3
Native Build Tools	0.9.18

3. 安装Spring Boot

Spring Boot可以与 "经典 "Java开发工具一起使用，也可以作为命令行工具安装。无论哪种方式，你都需要Java SDK v17或更高版本。在你开始之前，你应该使用以下命令检查你当前的Java安装。

如果你是Java开发的新手，或者你想尝试使用Spring Boot，你可能想先试试Spring Boot CLI（命令行界面）。否则，请继续阅读 "经典 "安装说明。

3.1. Java开发者的安装说明

你可以以与任何标准Java库相同的方式使用Spring Boot。要做到这一点，在你的classpath上包括适当的spring-boot-*.jar文件。Spring Boot不需要任何特殊的工具集成，所以你可以使用任何IDE或文本编辑器。

另外，Spring Boot应用程序没有什么特别之处，所以你可以像运行其他Java程序一样运行和调试Spring Boot应用程序。

虽然你可以复制Spring Boot jars，但我们一般建议你使用支持依赖性管理的构建工具（如Maven或Gradle）。

Maven安装

Spring Boot与Apache Maven 3.3或以上版本兼容。如果您还没有安装Maven的话，可以按照maven.apache.org上的说明进行。

TIPS：在许多操作系统上，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插件，用于创建可执行的jars。

关于开始使用Spring Boot和Maven的更多细节，可以在Maven插件参考指南的入门部分找到。

Gradle安装

Spring Boot与Gradle 7.x（7.5或更高版本）兼容。如果你还没有安装Gradle，你可以按照gradle.org上的说明进行安装。

可以通过使用org.springframework.boot组来声明Spring Boot的依赖性。一般来说，你的项目会声明对一个或多个 "启动器 "的依赖关系。Spring Boot提供了一个有用的Gradle插件，可以用来简化依赖性声明和创建可执行的jar。

Gradle封装器

当你需要构建一个项目时，Gradle Wrapper提供了一种 "获得 "Gradle的好方法。它是一个小脚本和库，你可以在你的代码旁边提交，以引导构建过程。

关于开始使用Spring Boot和Gradle的更多细节，可以在Gradle插件参考指南的入门部分找到。

3.2. 安装Spring Boot CLI

Spring Boot CLI（命令行界面）是一个命令行工具，你可以用它来快速建立Spring的原型。它可以让你运行Groovy脚本，这意味着你有一个熟悉的类似Java的语法，而没有那么多模板代码。

你不需要使用CLI来使用Spring Boot，但它是在没有IDE的情况下快速启动Spring应用程序的一种方法。

手动安装

你可以从Spring软件仓库下载Spring CLI发行版：

下载后，按照解压后的档案中的INSTALL.txt说明进行操作。总之，在.zip文件的bin/目录下有一个spring脚本（Windows的spring.bat）。或者，你可以使用java -jar与.jar文件（该脚本帮助你确定classpath设置正确）。

用SDKMAN!

SDKMAN! (The Software Development Kit Manager)可用于管理各种二进制SDK的多个版本，包括Groovy和Spring Boot CLI。从sdkman.io获取SDKMAN！，并通过使用以下命令安装Spring Boot。

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

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

你可以通过运行以下命令看到它：

OSX Homebrew安装

如果你是在Mac上并使用Homebrew，你可以通过使用以下命令来安装Spring Boot CLI：

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

NOTE：如果你没有看到这个结果，你安装的brew可能已经过时了。在这种情况下，运行 brew update 并再试一次。

MacPorts安装

如果你是在Mac上并使用MacPorts，你可以通过使用以下命令来安装Spring Boot CLI：

命令行完成

Spring Boot CLI包括为BASH和zsh shells提供命令完成的脚本。你可以在任何shell中使用该脚本（也被命名为spring），或者把它放在你的个人或全系统的bash完成初始化中。

在Debian系统中，全系统的脚本在/shell- completion/bash中，当一个新的shell启动时，该目录中的所有脚本都会被执行。例如，如果你是通过使用SDKMAN！安装的，要手动运行脚本，使用以下命令：

NOTE：如果你通过使用Homebrew或MacPorts安装Spring Boot CLI，命令行完成脚本会自动注册到你的shell中。

Windows scoop的安装

如果你是在Windows上并使用Scoop，你可以使用以下命令来安装Spring Boot CLI：

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

NOTE：如果你没有看到应用程序清单，你安装的 scoop 可能已经过期。在这种情况下，请运行 scoop update 并再次尝试。

4. 开发你的第一个Spring Boot应用程序

本节介绍了如何开发一个小型的 "Hello World!"网络应用，以突出Spring Boot的一些关键特性。我们使用Maven来构建这个项目，因为大多数IDE都支持它。

TIPS：spring.io网站上有许多使用Spring Boot的 "入门 "指南。

如果你需要解决一个特定的问题，请先在[那里]( https://spring.io/guides)查看。

你可以通过进入start.spring.io并从依赖项搜索器中选择 "Web "启动起来缩短下面的步骤。这样做会生成一个新的项目结构，这样你就可以马上开始编码了。

查看start.spring.io用户指南以了解更多细节。

在我们开始之前，请打开终端并运行以下命令，以确保你安装了有效的Java和Maven版本：

NOTE：这个样本需要在它自己的目录中创建。后面的说明假定你已经创建了一个合适的目录，并且它是你的当前目录。

4.1. 创建POM

我们需要先创建一个Maven pom.xml文件。pom.xml是用于构建项目的配方。打开你喜欢的文本编辑器，添加以下内容：

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

NOTE：这时，你可以把项目导入IDE（大多数现代Java IDE都包含对Maven的内置支持）。为简单起见，我们在本例中继续使用纯文本编辑器来编写本例。

4.2. 添加classpath依赖项

Spring Boot提供了一些 "启动器"，可以让你在classpath中添加jars。我们用于冒烟测试的应用程序在POM的父部分使用spring-boot-starter-parent。spring-boot-starter-parent是一个特殊的启动器，提供有用的Maven默认值。它还提供了一个依赖管理部分，这样你就可以省略 "blessed"依赖的版本标签。

其他 "启动器 "提供了开发特定类型的应用程序时可能需要的依赖项。由于我们正在开发一个Web应用程序，我们添加一个spring-boot-starter-web依赖项。在此之前，我们可以通过运行下面的命令来看看我们目前拥有什么。

mvn dependency:tree命令打印出项目依赖关系的树状图。

你可以看到spring-boot-starter-parent本身没有提供任何依赖关系。要添加必要的依赖，请编辑你的pom.xml，并在父部分下面添加spring-boot-starter-web依赖。

如果你再次运行mvn dependency:tree，你会看到现在有一些额外的依赖，包括Tomcat网络服务器和Spring Boot本身。

4.3. 编写代码

为了完成我们的应用程序，我们需要创建一个单独的Java文件。

由于默认包的问题

在此之前需要先修改一下pom文件：

默认情况下，Maven从src/main/java编译源文件，所以你需要创建该目录结构，同时必须要在这个目录下创建包路径：top/zyoo/app，然后添加一个名为src/main/java/ top/zyoo/app/MyApplication.java的文件，包含以下代码：

虽然这里的代码不多，但有相当多的事情要做。我们在接下来的几节中逐步介绍重要的部分。

@RestController和@RequestMapping注解

我们的MyApplication类的第一个注释是@RestController。这被认为是一个刻板的注解。它为阅读代码的人和Spring提供了提示，说明这个类扮演了一个特定的角色。在本例中，我们的类是一个Web @Controller，所以Spring在处理时考虑了它。

传入的Web请求时考虑它。

@RequestMapping注解提供了 "路由 "信息。它告诉Spring，任何带有/路径的HTTP请求都应该被映射到主页方法。@RestController注解告诉Spring将结果字符串直接渲染给调用者。

TIP：@RestController和@RequestMapping注解是Spring MVC的注解（它们不是Spring Boot特有的）。

请参阅Spring参考文献中的MVC部分文档中的MVC部分了解更多细节。

@SpringBootApplication注释

第二个级别的注解是@SpringBootApplication。这个注解被称为元注解，它结合了@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan。

其中，我们在这里最感兴趣的注解是@EnableAutoConfiguration。@EnableAutoConfiguration告诉Spring Boot根据你添加的jar依赖项 "猜测 "你想如何配置Spring。

由于spring-boot-starter-web添加了Tomcat和Spring MVC，自动配置会假定你正在开发一个Web应用，并相应地设置Spring。

启动器和自动配置

自动配置被设计成与 "启动器 "一起工作，但这两个概念并不直接联系在一起。你可以自由地在 "启动器 "之外挑选jar依赖项。Spring Boot仍然会尽力自动配置你的应用程序。

"main"方法

我们应用程序的最后部分是main方法。这是一个标准的方法，遵循应用程序入口点的Java惯例。我们的main方法通过调用run委托给Spring Boot的SpringApplication类。

SpringApplication引导我们的应用程序，启动Spring，而Spring又会启动自动配置的Tomcat网络服务器。我们需要将MyApplication.class作为参数传给run方法，以告诉SpringApplication哪个是主要的Spring组件。

args数组也被传入，以显示任何命令行参数。

4.4. 运行该实例

到此为止，你的应用程序应该可以运行。由于你使用了spring-boot-starter-parent POM，你有一个有用的运行目标，你可以用它来启动应用程序。

在项目根目录下输入mvn spring-boot:run来启动应用程序。你应该看到类似以下的输出：

如果你打开一个网页浏览器到localhost:8080，你应该看到以下输出：

要优雅地退出应用程序，按ctrl-c。

4.5. 创建一个可执行的jar文件

我们通过创建一个完全独立的可执行jar文件来结束我们的例子，我们可以在生产中运行。可执行的jar文件（有时被称为 "胖jar"）是包含你的编译类以及所有你的代码需要运行的jar依赖的档案。

可执行的jar和Java

Java没有提供一个标准的方法来加载嵌套的jar文件（jar文件本身包含在jar中）。如果你想发布一个自包含的应用程序，这可能是个问题。

为了解决这个问题，许多开发者使用 "uber "jar。uber jar将所有应用程序依赖的所有类打包成一个单一的存档。这种方法的问题是，很难看到哪些库在你的应用程序中。如果在多个jar中使用相同的文件名（但内容不同），也会产生问题。

Spring Boot采取了一种不同的方法，让你直接嵌套jars。

为了创建一个可执行的jar，我们需要在pom.xml中添加spring-boot-maven-plugin。要做到这一点，请在依赖关系部分下面插入以下几行：

spring-boot-starter-parent POM包括配置来绑定重新打包的目标。如果你不使用父POM，你需要自己声明这个自己的配置。详情见插件文档。

保存你的pom.xml并从命令行运行mvn package，如下所示：

如果你查看目标目录，你应该看到myproject-0.0.1-SNAPSHOT.jar。这个文件的大小应该在10MB左右。如果你想偷看里面，你可以使用jar tvf，如下所示：

你还应该在目标目录中看到一个更小的文件，名为myproject-0.0.1-SNAPSHOT.jar.original。这是Maven在被Spring Boot重新打包之前创建的原始jar文件。

要运行该应用程序，请使用java -jar命令，如下所示：

和以前一样，要退出应用程序，按ctrl-c。

5. 下一步阅读内容

希望本节提供了一些Spring Boot的基础知识，让你开始编写自己的应用程序。如果你是一个以任务为导向的开发者，你可能想跳到spring.io，跟随一些入门指南，解决 "我如何用Spring做这个？"的具体问题。我们也有针对Spring Boot的 "如何操作 "参考文档。

否则，下一个合乎逻辑的步骤是阅读《使用Spring Boot开发》。如果你真的没有耐心，你也可以跳到前面去读Spring Boot的功能。

Spring Boot编程思想(核心篇) SpringBoot开发教程正版书籍 JavaE ￥141.6 购买