Spring Boot:快速入门教程
什么是 Spring Boot?
Spring Boot 是由 Pivotal 团队提供的全新框架,其设计目的是用来简化新 Spring 应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置。简而言之,Spring Boot 通过提供默认配置的方式整合了所有的框架,让我们可以更加简单、快速、方便地构建应用程序。
为什么要用 Spring Boot?
Spring Boot 包含以下几个特性:
- 默认提供了大部分框架的使用方式,方便进行快速集成
- Spring Boot 应用可以独立运行,符合微服务的开发理念
- Spring Boot 内置 WEB 容器,无需部署 WAR 包即可运行
- 提供了各种生产就绪型功能,如指标,健康检查和外部配置
- Spring Boot 通过网站提供了项目模板,方便项目的初始化
通过以上这些非常优秀的特性,Spring Boot 可以帮助我们非常简单、快速的构建起我们的项目,并能够非常方便进行后续开发、测试和部署。
第一个 Spring Boot 项目
多说无益,实践为上。接下来,我就来建立起我们的第一个 Spring Boot 项目。
生成项目模板
为方便我们初始化项目,Spring Boot 给我们提供一个项目模板生成网站。
1. 打开浏览器,访问:https://start.spring.io/
2. 根据页面提示,选择构建工具,开发语言,项目信息等。
3. 点击 Generate the project,生成项目模板,生成之后会将压缩包下载到本地。
4. 使用 IDE 导入项目,我这里使用 Eclipse,通过导入 Maven 项目的方式导入。
项目结构说明
如下图所示,Spring Boot 的项目结构比较简单,只包含三个文件夹。
- src/main/java 放置程序开发代码
- src/main/resources 放置配置文件
- src/test/java 放置测试程序代码
而在其下,包含以下主要文件。
- DemoApplication.java 应用的启动类,包含 MAIN 方法,是程序的入口
- application.properties 一个空的配置文件,后续可以配置数据源等信息
- DemoApplicationTests.java 一个简单的单元测试类
- pom.xml mave 的配置文件,这个应该不用多作介绍了吧
项目结构图
添加 WEB 模块
其实不用添加 WEB 模块,Spring Boot 已经可以启动了。但是为了方便查看,我们引入 WEB 模块,并添加一个 REST 接口进行测试。
1. 引入 Maven 依赖
在 pom.xml 中添加 web 依赖。
pom.xml
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
2. 编写 REST 接口
新建一个 com.louis.springboot.demo.controller 包,并创建一个 HelloController。
HelloController.java
package com.louis.springboot.demo.controller;import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class HelloController {@GetMapping(</span>"/hello"<span style="color: rgba(0, 0, 0, 1)">) </span><span style="color: rgba(0, 0, 255, 1)">public</span><span style="color: rgba(0, 0, 0, 1)"> String hello() { </span><span style="color: rgba(0, 0, 255, 1)">return</span> "Hello Spring Boot!"<span style="color: rgba(0, 0, 0, 1)">; } <br>
}
项目运行测试
1. 右键项目 -> Run as -> Maven install,开始执行 Maven 构建,第一次会下载 Maven 依赖,可能需要点时间,如果出现如下信息,就说明项目编译打包成功了。
2. 右键文件 DemoApplication.java -> Run as -> Java Application,开始启动应用,当出现如下信息的时候,就说明应用启动成功了,默认启动端口是 8080。
3. 打开浏览器,访问:http://localhost:8080/hello,返回“Hello Spring Boot!”说明我们添加的 REST 接口已经测试通过了。
代码单元测试
如果要编写单元测试也比较容易,打开的 src/test/ 下的 DemoApplicationTests.java 文件,我们编写一个测试 hello 接口的测试方法,对于 http 请求的测试,我们可以使用 mockmvc 来模拟,详情参见具体代码。
DemoApplicationTests.java
@RunWith(SpringRunner.class) @SpringBootTest public class DemoApplicationTests {</span><span style="color: rgba(0, 0, 255, 1)">private</span><span style="color: rgba(0, 0, 0, 1)"> MockMvc mvc; @Before </span><span style="color: rgba(0, 0, 255, 1)">public</span> <span style="color: rgba(0, 0, 255, 1)">void</span> setUp() <span style="color: rgba(0, 0, 255, 1)">throws</span><span style="color: rgba(0, 0, 0, 1)"> Exception { mvc </span>= MockMvcBuilders.standaloneSetup(<span style="color: rgba(0, 0, 255, 1)">new</span><span style="color: rgba(0, 0, 0, 1)"> HelloController()).build(); } @Test </span><span style="color: rgba(0, 0, 255, 1)">public</span> <span style="color: rgba(0, 0, 255, 1)">void</span> testHello() <span style="color: rgba(0, 0, 255, 1)">throws</span><span style="color: rgba(0, 0, 0, 1)"> Exception { mvc.perform(MockMvcRequestBuilders.get(</span>"/hello"<span style="color: rgba(0, 0, 0, 1)">).accept(MediaType.APPLICATION_JSON)) .andExpect(MockMvcResultMatchers.status().isOk()) .andDo(MockMvcResultHandlers.print()) .andReturn(); }
}
右键 DemoApplicationTests.java 文件 -> Run as -> Junit Test,运行测试代码,可以从单元测试视图看到单元测试案例运行成功。
开发环境调试
如果每次修改代码之后都需要重新启动 WEB 应用,还是有点麻烦的,Spring Boot 支持热启动,修改之后可以实时生效,开发的时候打开还是可以提供一些便利性的。
打开 POM 文件,在 dependencies 标签下添加 spring-boot-devtools 依赖,并修改 build 标签下的 spring-boot-maven-plugin 的 fork 属性为 true 即可。
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <optional>true</optional> </dependency> </dependencies><build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<fork>true</fork>
</configuration>
</plugin>
</plugins>
</build>
启动端口修改
Spring Boot 默认的启动端口是 8080,如果需要修改,需要修改配置文件。
打开 application.properties 文件,在其中添加如下内容,配置启动端口号。
application.properties
server.port=8000
重新启动应用,查看控制台启动信息,我们发现启动端口已经变成 8000 了。
Yaml 格式文件使目前比较流行的配置文件,我们可以使用 Yaml 格式配置来代替属性文件配置,将 application.properties 的文件名修改为 application.yml,并将文件内容替换为如下格式内容即可。
application.yml
server:
port: 8000
启动 Banner 定制
我们在应用启动的时候,可以看到控制台显示了 Spring 的 Banner 信息,我们可以通过定制这个功能,来放置我们自己的应用信息。
如果要定制自己的 Banner, 只需要在 resources 下放置一个 baner.txt 文件,输入自己的 banner 字符即可。
Banner 字符可以通过类似以下网站生成:
http://patorjk.com/software/taag
http://www.network-science.de/ascii/
生成后复制内容到 banner.txt 并编辑成想要的样式,完成后重启应用,效果如下。
胡言乱语
SpringBoot 就是行,整啥啥都灵。
配置很容易,运行超简单。
开发难度小,资源也不少。
前途无限好,入坑要趁早。
相关导航
Spring Boot:整合 Spring Data JPA
Spring Boot:整合 Spring Security
源码下载
码云:https://gitee.com/liuge1988/spring-boot-demo.git
作者:朝雨忆轻尘
出处:https://www.cnblogs.com/xifengxiaoma/
版权所有,欢迎转载,转载请注明原文作者及出处。