Spring Boot 进行 MockMvc 单元测试的实例

2024-01-14 14:44

本文主要是介绍Spring Boot 进行 MockMvc 单元测试的实例,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

在Spring Boot应用程序中,使用MockMvc进行单元测试是一种有效的方式,可以验证控制器的行为和API的正确性。在这篇博客中,我们将介绍如何使用MockMvc对用户控制器(UserController)进行测试,该控制器涉及用户信息的增删改查操作。

UserController测试类

package com.lfsun.mockmvc;import com.fasterxml.jackson.databind.ObjectMapper;
import com.lfsun.mockmvc.entity.User;
import com.lfsun.mockmvc.service.UserService;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.MediaType;
import org.springframework.test.context.junit4.SpringRunner;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;import java.util.Arrays;
import java.util.List;import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureMockMvc
public class UserControllerTest {@Autowiredprivate MockMvc mockMvc;@Autowiredprivate UserService userService;@Autowiredprivate ObjectMapper objectMapper;@Beforepublic void setUp() {// 在测试前初始化一些数据,或者使用Mockito进行一些mock设置}@Testpublic void getAllUsersTest() throws Exception {mockMvc.perform(MockMvcRequestBuilders.get("/user/getAllUsers")).andExpect(status().isOk()).andExpect(jsonPath("$").isArray()).andExpect(jsonPath("$.length()").value(userService.getAllUsers().size())).andDo(print());}@Testpublic void getUserByIdTest() throws Exception {Long userId = 1L;mockMvc.perform(MockMvcRequestBuilders.get("/user/getUserById/{userId}", userId)).andExpect(status().isOk()).andExpect(jsonPath("$.userId").value(userId)).andDo(print());}@Testpublic void addUserTest() throws Exception {User user = new User();user.setUsername("testUser");user.setEmail("test@lfsun.com");mockMvc.perform(MockMvcRequestBuilders.post("/user/addUser").contentType(MediaType.APPLICATION_JSON).content(objectMapper.writeValueAsString(user))).andExpect(status().isOk()).andExpect(jsonPath("$.username").value("testUser")).andExpect(jsonPath("$.email").value("test@lfsun.com")).andDo(print());}@Testpublic void updateUserTest() throws Exception {Long userId = 1L;User updatedUser = new User();updatedUser.setUserId(userId);updatedUser.setUsername("updatedUser");updatedUser.setEmail("updated@lfsun.com");mockMvc.perform(MockMvcRequestBuilders.put("/user/updateUser").contentType(MediaType.APPLICATION_JSON).content(objectMapper.writeValueAsString(updatedUser))).andExpect(status().isOk()).andExpect(jsonPath("$.userId").value(userId)).andExpect(jsonPath("$.username").value("updatedUser")).andExpect(jsonPath("$.email").value("updated@lfsun.com")).andDo(print());}@Testpublic void deleteUserTest() throws Exception {Long userId = 1L;mockMvc.perform(MockMvcRequestBuilders.delete("/user/deleteUser/{userId}", userId)).andExpect(status().isOk()).andDo(print());}
}

解释和注意事项

  1. MockMvc的注入: @Autowired 注解用于将MockMvc实例注入测试类中。
  2. 数据初始化: 使用 @Before 注解的 setUp 方法,可以在测试前进行一些数据初始化或使用Mockito进行一些mock设置。
  3. 测试方法: 每个测试方法使用MockMvc执行相应的HTTP请求,并使用断言验证控制器的响应是否符合预期。
  4. 数据序列化: ObjectMapper 负责将对象序列化为JSON,以便在POST和PUT请求中传递。

以下附上完整代码

controller:

package com.lfsun.mockmvc.controller;import com.lfsun.mockmvc.entity.User;
import com.lfsun.mockmvc.service.UserService;
import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.*;import java.util.List;/*** 用户 Controller** @author CL*/
@RestController
@RequestMapping(value = "/user")
@RequiredArgsConstructor
public class UserController {private final UserService userService;// 查询所有用户@GetMapping("/getAllUsers")public List<User> getAllUsers() {return userService.getAllUsers();}// 根据用户ID查询用户@GetMapping("/getUserById/{userId}")public User getUserById(@PathVariable Long userId) {return userService.getUserById(userId);}// 添加用户@PostMapping("/addUser")public User addUser(@RequestBody User user) {return userService.addUser(user);}// 更新用户信息@PutMapping("/updateUser")public User updateUser(@RequestBody User user) {return userService.updateUser(user);}// 根据用户ID删除用户@DeleteMapping("/deleteUser/{userId}")public void deleteUser(@PathVariable Long userId) {userService.deleteUser(userId);}
}

service、serviceimpl

package com.lfsun.mockmvc.service;import com.lfsun.mockmvc.entity.User;import java.util.List;/*** 用户 Service 接口*/
public interface UserService {// 查询所有用户List<User> getAllUsers();// 根据用户ID查询用户User getUserById(Long userId);// 添加用户User addUser(User user);// 更新用户信息User updateUser(User user);// 根据用户ID删除用户void deleteUser(Long userId);
}
package com.lfsun.mockmvc.service.impl;import com.lfsun.mockmvc.entity.User;
import com.lfsun.mockmvc.mapper.UserMapper;
import com.lfsun.mockmvc.service.UserService;
import lombok.AllArgsConstructor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;import java.util.List;/*** 用户 Service 实现类*/
@Service
@AllArgsConstructor  // Lombok 自动生成构造函数
public class UserServiceImpl implements UserService {private final UserMapper userMapper;@Overridepublic List<User> getAllUsers() {return userMapper.getAllUsers();}@Overridepublic User getUserById(Long userId) {return userMapper.getUserById(userId);}@Overridepublic User addUser(User user) {userMapper.addUser(user);return user;}@Overridepublic User updateUser(User user) {userMapper.updateUser(user);return user;}@Overridepublic void deleteUser(Long userId) {userMapper.deleteUser(userId);}
}

mapper

package com.lfsun.mockmvc.mapper;import com.lfsun.mockmvc.entity.User;
import org.apache.ibatis.annotations.*;import java.util.List;/*** 用户 Mapper 接口*/
@Mapper
public interface UserMapper {List<User> getAllUsers();User getUserById(Long userId);void addUser(User user);void updateUser(User user);void deleteUser(Long userId);
}

实体类:

package com.lfsun.mockmvc.entity;import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {private Long userId;private String username;private String email;}

xml

<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.lfsun.mockmvc.mapper.UserMapper"><resultMap id="BaseResultMap" type="com.lfsun.mockmvc.entity.User"><id column="user_id" property="userId" jdbcType="BIGINT"/><result column="username" property="username" jdbcType="VARCHAR"/><result column="email" property="email" jdbcType="VARCHAR"/></resultMap><!-- 查询所有用户 --><select id="getAllUsers" resultMap="BaseResultMap">SELECT *FROM user;</select><!-- 根据用户ID查询用户 --><select id="getUserById" resultMap="BaseResultMap" parameterType="java.lang.Long">SELECT *FROM userWHERE user_id = #{userId};</select><!-- 添加用户 --><insert id="addUser" parameterType="com.lfsun.mockmvc.entity.User">INSERT INTO user (username, email)VALUES (#{username}, #{email});</insert><!-- 更新用户信息 --><update id="updateUser" parameterType="com.lfsun.mockmvc.entity.User">UPDATE userSET username = #{username},email    = #{email}WHERE user_id = #{userId};</update><!-- 根据用户ID删除用户 --><delete id="deleteUser" parameterType="java.lang.Long">DELETEFROM userWHERE user_id = #{userId};</delete></mapper>

配置

spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://127.0.0.1:3306/mockmvc?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=trueusername: rootpassword: 123321mybatis:mapper-locations: classpath:/mapper/*.xml  # 指定 MyBatis mapper 文件的位置configuration:map-underscore-to-camel-case: true  # 配置驼峰命名规则

maven

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.7.14</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>com.lfsun</groupId><artifactId>lfsun-study-mockmvc</artifactId><version>0.0.1-SNAPSHOT</version><name>lfsun-study-mockmvc</name><description>lfsun-study-mockmvc</description><properties><java.version>17</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><scope>provided</scope></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><scope>test</scope></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.23</version><scope>compile</scope></dependency><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>1.3.2</version></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>

这篇关于Spring Boot 进行 MockMvc 单元测试的实例的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/605531

相关文章

Spring Boot 实现 IP 限流的原理、实践与利弊解析

《SpringBoot实现IP限流的原理、实践与利弊解析》在SpringBoot中实现IP限流是一种简单而有效的方式来保障系统的稳定性和可用性,本文给大家介绍SpringBoot实现IP限... 目录一、引言二、IP 限流原理2.1 令牌桶算法2.2 漏桶算法三、使用场景3.1 防止恶意攻击3.2 控制资源

Mac系统下卸载JAVA和JDK的步骤

《Mac系统下卸载JAVA和JDK的步骤》JDK是Java语言的软件开发工具包,它提供了开发和运行Java应用程序所需的工具、库和资源,:本文主要介绍Mac系统下卸载JAVA和JDK的相关资料,需... 目录1. 卸载系统自带的 Java 版本检查当前 Java 版本通过命令卸载系统 Java2. 卸载自定

springboot下载接口限速功能实现

《springboot下载接口限速功能实现》通过Redis统计并发数动态调整每个用户带宽,核心逻辑为每秒读取并发送限定数据量,防止单用户占用过多资源,确保整体下载均衡且高效,本文给大家介绍spring... 目录 一、整体目标 二、涉及的主要类/方法✅ 三、核心流程图解(简化) 四、关键代码详解1️⃣ 设置

Java Spring ApplicationEvent 代码示例解析

《JavaSpringApplicationEvent代码示例解析》本文解析了Spring事件机制,涵盖核心概念(发布-订阅/观察者模式)、代码实现(事件定义、发布、监听)及高级应用(异步处理、... 目录一、Spring 事件机制核心概念1. 事件驱动架构模型2. 核心组件二、代码示例解析1. 事件定义

SpringMVC高效获取JavaBean对象指南

《SpringMVC高效获取JavaBean对象指南》SpringMVC通过数据绑定自动将请求参数映射到JavaBean,支持表单、URL及JSON数据,需用@ModelAttribute、@Requ... 目录Spring MVC 获取 JavaBean 对象指南核心机制:数据绑定实现步骤1. 定义 Ja

javax.net.ssl.SSLHandshakeException:异常原因及解决方案

《javax.net.ssl.SSLHandshakeException:异常原因及解决方案》javax.net.ssl.SSLHandshakeException是一个SSL握手异常,通常在建立SS... 目录报错原因在程序中绕过服务器的安全验证注意点最后多说一句报错原因一般出现这种问题是因为目标服务器

Java实现删除文件中的指定内容

《Java实现删除文件中的指定内容》在日常开发中,经常需要对文本文件进行批量处理,其中,删除文件中指定内容是最常见的需求之一,下面我们就来看看如何使用java实现删除文件中的指定内容吧... 目录1. 项目背景详细介绍2. 项目需求详细介绍2.1 功能需求2.2 非功能需求3. 相关技术详细介绍3.1 Ja

springboot项目中整合高德地图的实践

《springboot项目中整合高德地图的实践》:本文主要介绍springboot项目中整合高德地图的实践,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一:高德开放平台的使用二:创建数据库(我是用的是mysql)三:Springboot所需的依赖(根据你的需求再

spring中的ImportSelector接口示例详解

《spring中的ImportSelector接口示例详解》Spring的ImportSelector接口用于动态选择配置类,实现条件化和模块化配置,关键方法selectImports根据注解信息返回... 目录一、核心作用二、关键方法三、扩展功能四、使用示例五、工作原理六、应用场景七、自定义实现Impor

SpringBoot3应用中集成和使用Spring Retry的实践记录

《SpringBoot3应用中集成和使用SpringRetry的实践记录》SpringRetry为SpringBoot3提供重试机制,支持注解和编程式两种方式,可配置重试策略与监听器,适用于临时性故... 目录1. 简介2. 环境准备3. 使用方式3.1 注解方式 基础使用自定义重试策略失败恢复机制注意事项