MockMvc for HTTP assertions in Spring Boot - Step-by-Step Execution

Concept Flow - MockMvc for HTTP assertions

Setup MockMvc with WebApplicationContext

↓

Build HTTP request (GET/POST/etc)

↓

Perform request with MockMvc

↓

Receive MockHttpServletResponse

↓

Assert status, headers, body content

↓

Test passes or fails based on assertions

MockMvc simulates HTTP requests to Spring controllers and lets you check the response without running a server.

Execution Sample

Spring Boot

mockMvc.perform(get("/hello"))
       .andExpect(status().isOk())
       .andExpect(content().string("Hello World"));

This code sends a GET request to /hello and checks if the response status is 200 OK and the body is 'Hello World'.

Execution Table

Step	Action	Request Details	Response Status	Response Body	Assertion Result
1	Build GET request	GET /hello	-	-	Request ready
2	Perform request	Send GET /hello	200	Hello World	Response received
3	Assert status	Expect 200 OK	200	Hello World	Pass
4	Assert content	Expect body 'Hello World'	200	Hello World	Pass
5	Test result	-	200	Hello World	Test passes

💡 All assertions passed, test completes successfully

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	Final
mockMvc	initialized	initialized	initialized	initialized	initialized	initialized
request	null	GET /hello	GET /hello	GET /hello	GET /hello	GET /hello
responseStatus	null	null	200	200	200	200
responseBody	null	null	Hello World	Hello World	Hello World	Hello World
assertions	none	none	none	status OK passed	content passed	all passed

Key Moments - 3 Insights

Why do we not need to start a real server to test HTTP requests?

MockMvc simulates HTTP requests inside the test environment, so no real server is needed. See execution_table step 2 where the request is performed but no actual network call happens.

What happens if the response status is not what we expect?

The assertion in execution_table step 3 would fail, causing the test to fail immediately, preventing further assertions.

Can we test POST requests with MockMvc the same way?

Yes, you build a POST request instead of GET in step 1 and perform it similarly. The flow remains the same.

Visual Quiz - 3 Questions

Look at the execution_table, what is the response status after performing the request?

A 500

B 404

C 200

D null

💡 Hint

Check the 'Response Status' column at step 2 in the execution_table.

At which step does the test confirm the response body content?

A Step 4

B Step 3

C Step 2

D Step 5

💡 Hint

Look at the 'Action' and 'Assertion Result' columns in execution_table for step 4.

If the response body was 'Hello Spring' instead of 'Hello World', what would happen at step 4?

A Assertion passes

B Assertion fails

C Test skips this step

D Response status changes

💡 Hint

Step 4 asserts the exact response body string; a mismatch causes failure.

Concept Snapshot

MockMvc lets you test Spring MVC controllers without a server.
Build a request (GET, POST, etc) with mockMvc.perform().
Check response status and content with andExpect().
Assertions fail test if response differs.
Fast, isolated HTTP testing inside your test code.

Full Transcript

MockMvc is a tool in Spring Boot that lets you simulate HTTP requests to your controllers without starting a real server. You create a request like GET or POST using mockMvc.perform(), then check the response status and body using assertions like andExpect(status().isOk()) and andExpect(content().string(...)). The execution flow starts by building the request, performing it, receiving a mock response, and then asserting expected results. If any assertion fails, the test fails immediately. This allows fast and reliable testing of your web layer in isolation.