目标

  1. 了解 单元测试的背景
  2. 了解如何 利用 springboot 实现接口的测试
  3. 了解如何 利用 mokito 做代码的 mock

一、About 单元测试

单元测试其实是一种廉价的技术,是由开发者创建运行测试代码,用于对程序模块(软件设计的最小单位)进行正确性检验的一种做法。

而所谓的最小单元,就是指应用的最小可测试部件。 在面向对象领域,最小单元对应于类的某个成员方法。

通常意义的单元测试会用于验证某场景、某条件下某方法的行为结果,举个例子:

我想验证

    Equals 方法,在两个对象类型不一致时应该返回 false

单元测试的初衷,是对各个相互独立,互不影响的基本单元基线测试,以此来保证核心代码的质量。

每一段单元测试代码,都一定会包含几个部分

  • Arrange

    用于初始化一些被测试方法需要的参数或依赖的对象。

  • Act方法

    用于调用被测方法进行测试。

  • Assert

    用于验证测试方法是否按期望执行或者结果是否符合期望值

See !并不是很复杂,可是大多数开发者并不喜欢做单元测试。

而且,有一个现象很有意思,水平越高的程序员,越不喜欢写测试代码,why?

“ 因为单元测试,主要是用来防低级程序员挖坑的啊 ”

这句话不是我说的,但却代表了相当一部分程序员的心声..

那么,单元测试到底要不要做,并不是本文要讨论的问题。

建议大家阅读下 《单元测试之道-Java版本》 (程序员修炼三部曲系列)这边书,看完后再做出自己的理解。

为了测试一座桥梁,不应该只在晴朗的天气,开一辆汽车从桥中间穿过,就认为已经完成了对桥梁的测试

二、About Junit

接下来,要说一说 Junit框架,这个是最流行的Java 单元测试框架。

Junit 创建者是 Kent Beck和Erich Gamma,自其出现以来,Junit 生态圈已经非常庞大。

大量的应用程序、开发框架都以 Junit 作为标准的的基础测试组件,这当然也包括 Spring系列的框架。

一个典型的Junit单元测试类:


class StandardTests { @BeforeClass
static void initAll() {
} @Before
void init() {
} @Test
void justTest() {
...
assertTrue(...)
} @After
void tearDown() {
} @AfterClass
static void tearDownAll() {
} }

说明

要点 说明
@BeforeClass 在当前类测试之前执行
@Before 在每个测试方法之前执行
@Test 声明测试方法
@After 在每个测试方法之后执行
@AfterClass 在当前类测试之后执行

上面的注解还是比较容易理解的,需要注意的只是 @BeforeClass 和 @Before,前者是一个静态方法,

会在整个测试用例类开始前执行,仅一次; 而后者则是在方法测试之前触发,可能会执行多次。

当前最新的版本是Junit 5 ,有兴趣的可以看看 https://junit.org/junit5 官网的介绍

为了更清晰的理解Junit 是怎么运作,下面展示一个源码片段:


public void runBare() throws Throwable {
Throwable exception = null;
setUp();
try {
runTest();
} catch (Throwable running) {
exception = running;
} finally {
try {
tearDown();
} catch (Throwable tearingDown) {
if (exception == null) exception = tearingDown;
}
}
if (exception != null) throw exception;
}

这是早期版本的TestCase类其中的一段实现,与我们所说的思路是基本一致的。

然而,基于注解的实现是由 Junit4提供的,在有兴趣的话可以深入看看源码。

关键词

TestCase、JUnit4TestAdapter、BlockJUnit4ClassRunner

三、SpringBoot-单元测试

SpringBoot 提供了 spring-boot-starter-test 用于实现单元测试。

项目依赖

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<version>${spring-boot.version}</version>
</dependency>

测试样例

@RunWith(SpringRunner.class)
@SpringBootTest(classes = DemoBoot.class)
public class RestApiTest { private MockMvc mockMvc; private ObjectMapper mapper = new ObjectMapper(); @Autowired
private WebApplicationContext context; @Autowired
private RestDataManager dataManager; private static final String CUSTOMER = "LiLei";
private Pet polly;
private Pet badboy; @Before
public void setupMockMvc() throws Exception {
mockMvc = MockMvcBuilders.webAppContextSetup(context).build();
initData();
} private void initData() {
// 清除原有宠物信息
dataManager.clearPets(CUSTOMER); // 添加新的宠物信息
polly = new Pet();
polly.setType("Bird");
polly.setName("Polly");
polly.setDescription("the rapid speaker"); dataManager.addPet(CUSTOMER, polly); badboy = new Pet();
badboy.setType("Dog");
badboy.setName("BadBoy");
polly.setDescription("the monster"); dataManager.addPet(CUSTOMER, badboy);
} @Test
public void testGet() throws Exception { mockMvc.perform(MockMvcRequestBuilders.get("/rest/pets/{customer}/{petId}",
CUSTOMER, polly.getPetId()))
.andExpect(MockMvcResultMatchers.status().isOk())
.andExpect(MockMvcResultMatchers.content()
.contentType(MediaType.APPLICATION_JSON_UTF8))
.andExpect(MockMvcResultMatchers.content()
.json(mapper.writeValueAsString(polly)))
.andDo(MockMvcResultHandlers.print()); }
}

说明

SpringRunner继承于SpringJUnit4ClassRunner,这是Spring框架基于Junit实现的基础类。

如果还记得前面提到的 BlockJUnit4ClassRunner,应该不难猜到,Spring 的实现类集成了该类。

那么,SpringRunner 做了什么? 什么也没有,只是一个名称的修正而已(论命名的重要性)

@SpringBootTest的作用

其代码注释如下:

Annotation that can be specified on a test class that runs Spring Boot based tests.
Provides the following features over and above the regular Spring TestContext Framework: 1. Uses SpringBootContextLoader as the default ContextLoader when no specific @ContextConfiguration(loader=...) is defined.
2. Automatically searches for a @SpringBootConfiguration when nested @Configuration is not used, and no explicit classes are specified.
3. Allows custom Environment properties to be defined using the properties attribute.
4. Provides support for different webEnvironment modes, including the ability to start a fully running container listening on a defined or random port.
5. Registers a TestRestTemplate bean for use in web tests that are using a fully running container.

要点

  1. 默认会使用SpringBootContextLoader类用于上下文加载,

    这个类将会使用所配置的SpringBootApplication实体类作为入口,加载配置并初始化Spring上下文环境;

  2. 可以支持自定义的配置,通过 Environment 属性设置;

  3. 支持不同的 web 环境模式,可以是固定端口、随机端口、无端口几种模式。

关键词

SpringRunner、SpringBootTest、SpringBootContextLoader

四、Mock测试

Mock 测试的使用场景在于,被测试模块(方法)依赖于外部系统(web服务、中间件或是数据库)时。

我们需要提供一种快速验证本地实现逻辑的策略,那就是 Mock,也称为打桩。

如上图,A 模块依赖于 B 模块,在 B 模块不可达的时候,我们对 依赖接口进行了 Mock。

这样在执行测试时,不需要真实的 B 模块便可完成测试。

下面我们要用到的 Mock 组件叫 Mockito

springboot-starter-test 自带了对于 mockito 的依赖,下面看一段代码:


@Before
public void setupMockMvc() throws Exception { // 启用mock
MockitoAnnotations.initMocks(this); polly = new Pet();
polly.setType("Bird");
polly.setName("Polly");
polly.setDescription("the rapid speaker"); lilei = new Customer();
lilei.setName(CUSTOMER); // 设置mock接口
Mockito.when(dataManager.getPets(Mockito.isA(String.class))).thenReturn(Arrays.asList(polly));
Mockito.when(dataManager.getCustomer(Mockito.isA(String.class))).thenReturn(lilei); // 使用standaloneSetup,指定controller
// 由于不通过webappliationContext初始化,许多配置不会自动完成,此外bean的初始化方法也不会执行
mockMvc = MockMvcBuilders.standaloneSetup(controller)
.setMessageConverters(new MappingJackson2HttpMessageConverter()).build();
}

看到了吗,利用 Mockito 可以实现你想要的 Mock效果,如下:

Mockito.when( somemethod ).thenReturn( some thing to return);

然而,在进行 mock 方法时,需要使用 standaloneSetup 的模式,

否则 mockito 无法工作。

mockMvc = MockMvcBuilders.standaloneSetup(controller)..

关键词

Mockito、MockMvcBuilders

码云同步代码

五、最后

细心的读者会发现,前面讲了单元测试的对象,是指软件设计的最小单位(方法),可是为什么到了 SpringBoot 的部分时

却都是对于API(Controller层)的测试呢? 到底我们的单元测试应该针对内部实现的某个单元,比如 DAO/Service方法,还是针对接口(API Interface)?

笔者认为,这点并没有绝对的好坏之分,关键在于取舍。

单元测试是软件工程领域的概念,而软件项目是分很多种类型的,比如在早期的软件工程中,

就有不少的基于C/S架构的程序,这类程序的体积相对庞大,往往需要对大量模块级的方法进行单元测试;

现如今的微服务体系架构中,对于各个子系统来说,API(作为契约)是必须进行测试的。

对于某服务的单元测试,选择 Controller 还是 Service层,取决于你的成本效益考虑,

而目前来看,结合敏捷化的 TDD实践、 通过单元测试进行 API测试 已经是一种主流做法。

欢迎继续关注"美码师的补习系列-springboot篇" ,期待更多精彩内容-

补习系列(8)-springboot 单元测试之道的更多相关文章

  1. 补习系列(15)-springboot 分布式会话原理

    目录 一.背景 二.SpringBoot 分布式会话 三.样例程序 四.原理进阶 A. 序列化 B. 会话代理 C. 数据老化 小结 一.背景 在 补习系列(3)-springboot 几种scope ...

  2. 补习系列(14)-springboot redis 整合-数据读写

    目录 一.简介 二.SpringBoot Redis 读写 A. 引入 spring-data-redis B. 序列化 C. 读写样例 三.方法级缓存 四.连接池 小结 一.简介 在 补习系列(A3 ...

  3. 补习系列(19)-springboot JPA + PostGreSQL

    目录 SpringBoot 整合 PostGreSQL 一.PostGreSQL简介 二.关于 SpringDataJPA 三.整合 PostGreSQL A. 依赖包 B. 配置文件 C. 模型定义 ...

  4. 补习系列(18)-springboot H2 迷你数据库

    目录 关于 H2 一.H2 用作本地数据库 1. 引入依赖: 2. 配置文件 3. 样例数据 二.H2 用于单元测试 1. 依赖包 2. 测试配置 3. 测试代码 小结 关于 H2 H2 数据库是一个 ...

  5. 补习系列(16)-springboot mongodb 数据库应用技巧

    目录 一.关于 MongoDB 二.Spring-Data-Mongo 三.整合 MongoDB CRUD A. 引入框架 B. 数据库配置 C. 数据模型 D. 数据操作 E. 自定义操作 四.高级 ...

  6. 补习系列(1)-springboot项目基础搭建课

    目录 前言 一.基础结构 二.添加代码 三.应用配置 四.日志配置 五.打包部署 小结 前言 springboot 最近火的不行,目前几乎已经是 spring 家族最耀眼的项目了.抛开微服务.技术社区 ...

  7. 补习系列(17)-springboot mongodb 内嵌数据库

    目录 简介 一.使用 flapdoodle.embed.mongo A. 引入依赖 B. 准备测试类 C. 完善配置 D. 启动测试 细节 二.使用Fongo A. 引入框架 B. 准备测试类 C.业 ...

  8. 补习系列(13)-springboot redis 与发布订阅

    目录 一.订阅发布 常见应用 二.Redis 与订阅发布 三.SpringBoot 与订阅发布 A. 消息模型 B. 序列化 C. 发布消息 D. 接收消息 小结 一.订阅发布 订阅发布是一种常见的设 ...

  9. 补习系列(12)-springboot 与邮件发送

    目录 一.邮件协议 关于数据传输 二.SpringBoot 与邮件 A. 添加依赖 B. 配置文件 C. 发送文本邮件 D.发送附件 E. 发送Html邮件 三.CID与图片 参考文档 一.邮件协议 ...

随机推荐

  1. vue自定义键盘事件

    //自定义全局按键修饰符 Vue.config.keyCodes.f2 = 13;//enter为13此时F2==ENTER 调用;@keyup.f2='addData()'

  2. VB使用API进行RC4加密解密(MD5密钥)

    根据网络资料整改,来源未知,已调试通过. Option Explicit Private Declare Function CryptAcquireContext Lib "advapi32 ...

  3. springboot增删改查

    改https://blog.csdn.net/weixin_42338186/article/details/81561592 添加https://blog.csdn.net/weixin_42338 ...

  4. javascript 插入DOM节点

    1.使用appendChild,把一个子节点添加到父节点的最后一个子节点,.innerText插入的是内容 HTML <!-- HTML结构 --> <p id="js&q ...

  5. SpringCloud 在Feign上使用Hystrix(断路由)

    SpringCloud  在Feign上使用Hystrix(断路由) 第一步:由于Feign的起步依赖中已经引入了Hystrix的依赖,所以只需要开启Hystrix的功能,在properties文件中 ...

  6. iptables实现--kafka限制ip地址访问

    iptables -I INPUT -p tcp --dport 9092:9094 -j DROPiptables -I INPUT -s 10.144.137.32 -p tcp --dport ...

  7. Java作业十二(2017-11-13)

    /*继承与抽象类*/ package com.baidu.www; abstract class Person { private String name; private int age; publ ...

  8. Ansible配置免密登陆

    0x01:  把远程服务器的公钥来获取到本地 #ssh-keyscan ip1 ip2 ip3 ip4 >> /root/.ssh/known_hosts 完成后,/root/.ssh/k ...

  9. JMS(Java消息服务)与消息队列ActiveMQ基本使用(一)

    最近的项目中用到了mq,之前自己一直在码农一样的照葫芦画瓢.最近几天研究了下,把自己所有看下来的文档和了解总结一下. 一. 认识JMS 1.概述 对于JMS,百度百科,是这样介绍的:JMS即Java消 ...

  10. [Swift]LeetCode170.两数之和III - 数据结构设计 $ Two Sum III - Data structure design

    Design and implement a TwoSum class. It should support the following operations:add and find. add - ...