Spring Boot实战之单元测试

最新推荐文章于 2025-06-21 18:47:33 发布

原创

最新推荐文章于 2025-06-21 18:47:33 发布 · 3.8w 阅读

24 ·

CC 4.0 BY-SA版权

文章标签：

#单元测试 #MockMvc #JUnit Test #Spring Boot #Json Path

本文介绍如何使用Spring测试框架中的MockMvc对象对RESTful API进行单元测试，包括测试环境搭建、常用工具函数介绍及示例代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Spring Boot实战之单元测试

本文介绍使用Spring测试框架提供的MockMvc对象，对Restful API进行单元测试

Spring测试框架提供MockMvc对象，可以在不需要客户端-服务端请求的情况下进行MVC测试，完全在服务端这边就可以执行Controller的请求，跟启动了测试服务器一样。
测试开始之前需要建立测试环境，setup方法被@Before修饰。通过MockMvcBuilders工具，使用WebApplicationContext对象作为参数，创建一个MockMvc对象。

MockMvc对象提供一组工具函数用来执行assert判断，都是针对web请求的判断。这组工具的使用方式是函数的链式调用，允许程序员将多个测试用例链接在一起，并进行多个判断。在这个例子中我们用到下面的一些工具函数：
perform(get(...))建立web请求。在我们的第三个用例中，通过MockMvcRequestBuilder执行GET请求。
andExpect(...)可以在perform(...)函数调用后多次调用，表示对多个条件的判断，这个函数的参数类型是ResultMatcher接口，在MockMvcResultMatchers这这个类中提供了很多返回ResultMatcher接口的工具函数。这个函数使得可以检测同一个web请求的多个方面，包括HTTP响应状态码（response status），响应的内容类型（content type），会话中存放的值，检验重定向、model或者header的内容等等。这里需要通过第三方库json-path检测JSON格式的响应数据：检查json数据包含正确的元素类型和对应的值，例如jsonPath("$.name").value("中文测试")用于检查在根目录下有一个名为name的节点，并且该节点对应的值是“testuser”。

本文对rest api的开发不做详细描述，如需了解可以参考 Spring Boot实战之Rest接口开发及数据库基本操作

1、修改pom.xml，添加依赖库json-path,用于检测JSON格式的响应数据

<dependency>
   	<groupId>com.jayway.jsonpath</groupId>
   	<artifactId>json-path</artifactId>
</dependency>

2、添加用户数据模型UserInfo.java

package com.xiaofangtech.sunt.bean;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.validation.constraints.Size;

@Entity
@Table(name="t_userinfo")
public class UserInfo {
	@Id  
    @GeneratedValue(strategy = GenerationType.AUTO)  
    private Long id;
	@Size(min=0, max=32)
	private String name;
	
	private Integer age;
	@Size(min=0, max=255)
	private String address;

	public Long getId() {
		return id;
	}

	public void setId(Long id) {
		this.id = id;
	}

	pu