SpringBoot 之快速入门
SpringBoot 之快速入门
Spring Boot 简介
Spring Boot 可以让使用者非常方便的创建 Spring 应用。
Spring Boot 的目标是:
- 为所有 Spring 开发者提供更快且可广泛访问的入门体验。
- 开箱即用
- 提供一系列通用的非功能特性(例如嵌入式服务、安全、指标、健康检查和外部化配置)
- 完全不需要代码生成,也不需要 XML 配置。
Spring Boot 系统要求
Spring Boot 的构建工具要求:
Build Tool | Version |
---|---|
Maven | 3.5+ |
Gradle | 6.8.x, 6.9.x, and 7.x |
Spring Boot 支持的 Servlet 容器:
Name | Servlet Version |
---|---|
Tomcat 9.0 | 4.0 |
Jetty 9.4 | 3.1 |
Jetty 10.0 | 4.0 |
Undertow 2.0 | 4.0 |
部署第一个 Spring Boot 项目
本节介绍如何开发一个小的“Hello World!” web 应用示例,来展示 Spring Boot 的一些关键功能。我们使用 Maven 来构建这个项目,因为大多数 IDE 都支持它。
环境检查
Spring Boot 项目依赖于 Java 环境和 Mave,开始项目之前需要先检查一下环境。
本地是否已安装 Java:
1 | java -version |
本地是否已安装 Maven:
1 | $ mvn -v |
创建 pom
我们需要从创建 Maven pom.xml 文件开始。 pom.xml 是 Maven 用于构建项目的配置文件。
1 |
|
使用者可以通过运行 mvn package 来测试它
添加依赖
Spring Boot 提供了许多启动器(Starters)以应对不同的使用场景。使用者可将 jars 添加到类路径中。我们的示例程序在 POM 的 parent 使用 spring-boot-starter-parent。 spring-boot-starter-parent 是一个特殊的启动器,提供有用的 Maven 默认值。它还提供了一个依赖项的版本管理,可以让使用者使用时不必显示指定版本。
其他启动器(Starters)提供了各种针对不同使用场景的功能。比如,我们需要开发一个 Web 应用程序,就可以添加了一个 spring-boot-starter-web 依赖项。在此之前,我们可以通过运行以下命令来查看我们当前拥有的 maven 依赖:
1 | mvn dependency:tree |
mvn dependency:tree 命令打印项目依赖项的层级结构。可以看到 spring-boot-starter-parent 本身没有提供任何依赖。要添加必要的依赖,需要编辑 pom.xml 并在 <dependencies>
部分添加 spring-boot-starter-web 依赖项:
1 | <dependencies> |
编写代码
要运行应用程序,我们需要创建一个启动类。默认情况下,Maven 从 src/main/java
编译源代码,因此您需要创建该目录结构,然后添加一个名为 src/main/java/MyApplication.java
的文件以包含以下代码:
1 |
|
说明:
@RestController 注解告诉 Spring,这个类是用来处理 Rest 请求的。
@RequestMapping
注解提供了“路由”信息。它告诉 Spring 任何带有 /
路径的 HTTP 请求都应该映射到 home
方法。 @RestController
注解告诉 Spring 将结果字符串直接呈现给调用者。
@EnableAutoConfiguration
注解告诉 Spring Boot 根据你添加的 jar 依赖去自动装配 Spring。
自动配置旨在与“Starters”配合使用,但这两个概念并没有直接联系。您可以自由选择 starters 之外的 jar 依赖项。 Spring Boot 仍然尽力自动配置您的应用程序。
Spring Boot 的 main 方法通过调用 run 委托给 Spring Boot 的 SpringApplication
类。 SpringApplication
引导我们的应用程序,启动 Spring,进而启动自动配置的 Tomcat Web 服务器。我们需要将 MyApplication.class
作为参数传递给 run 方法,以告诉 SpringApplication
哪个是入口类。还传递 args 数组以公开任何命令行参数。
运行示例
此时,您的应用程序应该可以工作了。由于您使用了 spring-boot-starter-parent POM,因此您有一个有用的运行目标,可用于启动应用程序。从项目根目录键入 mvn spring-boot:run 以启动应用程序。您应该会看到类似于以下内容的输出:
1 | mvn spring-boot:run |
如果您打开 Web 浏览器访问 localhost:8080,您应该会看到以下输出:
1 | Hello World! |
要正常退出应用程序,请按 ctrl-c
。
创建可执行 jar
要创建一个可执行的 jar,我们需要将 spring-boot-maven-plugin 添加到我们的 pom.xml 中。为此,请在依赖项部分下方插入以下行:
1 | <build> |
保存 pom.xml 并从命令行运行 mvn package,如下所示:
1 | mvn package |
如果您查看 target 目录,应该会看到 myproject-0.0.1-SNAPSHOT.jar
。该文件的大小应约为 10 MB。如果想看里面,可以使用 jar tvf,如下:
1 | jar tvf target/myproject-0.0.1-SNAPSHOT.jar |
您还应该在目标目录中看到一个更小的名为 myproject-0.0.1-SNAPSHOT.jar.original
的文件。这是 Maven 在 Spring Boot 重新打包之前创建的原始 jar 文件。
要运行该应用程序,请使用 java -jar 命令,如下所示:
1 | $ java -jar target/myproject-0.0.1-SNAPSHOT.jar |
和以前一样,要退出应用程序,请按 ctrl-c
。
通过 SPRING INITIALIZR 创建 Spring Boot 项目
创建项目
通过 SPRING INITIALIZR
工具产生基础项目
- 访问:
http://start.spring.io/
- 选择构建工具
Maven Project
、Spring Boot 版本1.5.10
以及一些工程基本信息,可参考下图所示:
- 点击
Generate Project
下载项目压缩包 - 解压压缩包,包中已是一个完整的项目。
如果你使用 Intellij 作为 IDE,那么你可以直接使用 SPRING INITIALIZR,参考下图操作:
项目说明
重要文件
src/main/java
路径下的Chapter1Application
类 :程序入口src/main/resources
路径下的application.properties
:项目配置文件src/test/java
路径下的Chapter01ApplicationTests
:程序测试入口
pom.xml
pom 中指定 parent 为以下内容,表示此项目继承了 spring-boot-starter-parent
的 maven 配置(主要是指定了常用依赖、插件的版本)。
1 | <parent> |
此外,pom 中默认引入两个依赖包,和一个插件。
1 | <dependencies> |
spring-boot-starter-web
:核心模块,包括自动配置支持、日志和 YAML。spring-boot-starter-test
:测试模块,包括 JUnit、Hamcrest、Mockito。spring-boot-maven-plugin
:spring boot 插件, 提供了一系列 spring boot 相关的 maven 操作。spring-boot:build-info
,生成 Actuator 使用的构建信息文件 build-info.propertiesspring-boot:repackage
,默认 goal。在 mvn package 之后,再次打包可执行的 jar/war,同时保留 mvn package 生成的 jar/war 为.originspring-boot:run
,运行 Spring Boot 应用spring-boot:start
,在 mvn integration-test 阶段,进行 Spring Boot 应用生命周期的管理spring-boot:stop
,在 mvn integration-test 阶段,进行 Spring Boot 应用生命周期的管理
编写 REST 服务
- 创建
package
,名为io.github.zp.springboot.chapter1.web
(根据项目情况修改) - 创建
HelloController
类,内容如下:
1 |
|
- 启动主程序
XXXApplication
,打开浏览器访问http://localhost:8080/hello
,可以看到页面输出Hello World
编写单元测试用例
在 XXXApplicationTests
类中编写一个简单的单元测试来模拟 HTTP 请求,具体如下:
1 |
|
使用MockServletContext
来构建一个空的WebApplicationContext
,这样我们创建的HelloController
就可以在@Before
函数中创建并传递到MockMvcBuilders.standaloneSetup()
函数中。
- 注意引入下面内容,让
status
、content
、equalTo
函数可用
1 | import static org.hamcrest.Matchers.equalTo; |
至此已完成目标,通过 Maven 构建了一个空白 Spring Boot 项目,再通过引入 web 模块实现了一个简单的请求处理。