Spring Boot MockMvc测试：如何向REST接口传递JSON请求体

@PostMapping(value = "/addItemIntoCart", consumes = {"application/json"})
public ResponseEntity<String> addItemToCart(@RequestBody CartDto cartDto) {
   // 业务逻辑处理 cartDto
   return ResponseEntity.ok("Item added successfully");
}

<!-- Spring Boot Web Starter通常已包含Jackson -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 或单独引入Jackson -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>

// CartDto.java
public class CartDto {
    private String itemId;
    private int quantity;

    // 构造函数
    public CartDto() {}

    public CartDto(String itemId, int quantity) {
        this.itemId = itemId;
        this.quantity = quantity;
    }

    // Getter和Setter方法
    public String getItemId() {
        return itemId;
    }

    public void setItemId(String itemId) {
        this.itemId = itemId;
    }

    public int getQuantity() {
        return quantity;
    }

    public void setQuantity(int quantity) {
        this.quantity = quantity;
    }
}

CartDto cartDto = new CartDto("item123", 2);

import com.fasterxml.jackson.databind.ObjectMapper;
// ...

// 在测试类中注入ObjectMapper
@Autowired
private ObjectMapper objectMapper;

// ...

// 在测试方法中将对象转换为JSON字符串
String jsonRequest = objectMapper.writeValueAsString(cartDto);

import org.springframework.http.MediaType;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
// ...

mockMvc.perform(post("/user/addItemIntoCart") // 指定请求路径和HTTP方法
        .contentType(MediaType.APPLICATION_JSON) // 设置Content-Type头部为application/json
        .content(jsonRequest)) // 将JSON字符串作为请求体
        .andExpect(status().isOk()); // 期望HTTP状态码为200 OK

import com.fasterxml.jackson.databind.ObjectMapper;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.Mockito.when;

// 假设你的控制器类名为 CartController
@WebMvcTest(CartController.class)
public class CartControllerTest {

    @Autowired
    private MockMvc mockMvc; // 注入MockMvc实例

    @Autowired
    private ObjectMapper objectMapper; // 注入ObjectMapper，用于JSON序列化/反序列化

    // 如果你的控制器依赖于服务层，需要Mock该服务
    @MockBean
    private CartService cartService; // 假设CartController依赖于CartService

    // 可选：在每个测试方法执行前进行一些通用设置
    @BeforeEach
    void setUp() {
        // 例如，重置Mock对象的行为
        // Mockito.reset(cartService);
    }

    @Test
    void testAddItemIntoCart_Success() throws Exception {
        // 1. 创建待发送的CartDto对象
        CartDto cartDto = new CartDto("item123", 2);

        // 2. 将CartDto对象转换为JSON字符串
        String jsonRequest = objectMapper.writeValueAsString(cartDto);

        // 3. 模拟cartService的行为（如果控制器会调用服务）
        // 当cartService.addItemIntoCart被调用时，返回一个成功的ResponseEntity
        when(cartService.addItemIntoCart(any(CartDto.class)))
              .thenReturn(ResponseEntity.ok("Item added successfully"));

        // 4. 构建并执行MockMvc请求
        mockMvc.perform(post("/user/addItemIntoCart")
                .contentType(MediaType.APPLICATION_JSON) // 设置请求头Content-Type
                .content(jsonRequest)) // 设置请求体为JSON字符串
                .andExpect(status().isOk()); // 验证HTTP状态码是否为200 OK
    }

    @Test
    void testAddItemIntoCart_BadRequest() throws Exception {
        // 示例：测试无效输入（例如，如果quantity不能为负数，但DTO中未包含验证逻辑）
        // 这里仅作示例，实际应根据DTO的验证规则来构造无效JSON
        CartDto invalidCartDto = new CartDto("item456", -1); // 假设-1是无效数量
        String invalidJsonRequest = objectMapper.writeValueAsString(invalidCartDto);

        // 模拟服务层可能抛出异常或返回错误状态（如果控制器有处理）
        // 或者，如果控制器有@Valid注解，这里可能直接返回400 BAD_REQUEST
        when(cartService.addItemIntoCart(any(CartDto.class)))
              .thenReturn(ResponseEntity.badRequest().body("Invalid quantity"));

        mockMvc.perform(post("/user/addItemIntoCart")
                .contentType(MediaType.APPLICATION_JSON)
                .content(invalidJsonRequest))
                .andExpect(status().isBadRequest()); // 期望HTTP状态码为400 Bad Request
    }
}