Unravel › Java concepts › Testing

Learn these first

At a glance

1. 1mvc.perform(post("/orders").contentType(JSON).content(json)) builds a request; .andExpect(status().isCreated()) and .andExpect(jsonPath("$.id").value(1)) assert on the responseandDo(print()) shows the full exchange when a test fails.
2. 2Security: with(jwt()), with(csrf()) and @WithMockUser(roles = "ADMIN") set up an authenticated user without logging in
3. 3WebTestClient is the reactive counterpart: client.get().uri("/orders/1").exchange().expectStatus().isOk().expectBody().jsonPath("$.status").isEqualTo("NEW")
4. 4RestAssured.given().body(x).when().post("/orders").then().statusCode(201).body("id", notNullValue()) reads like a specification and is common for end-to-end API tests

• MockMvc runs the dispatcher servlet in-process, so it does not test the servlet container, real HTTP, TLS or serialization over the wire
• Assert on the contract, not the whole body string
• MockMvc creates mock servlet request and response objects and calls the DispatcherServlet directly, passing through the filter chain you configured

mvc.perform(post("/orders")        .contentType(MediaType.APPLICATION_JSON)        .content("{\"sku\":\"A-100\",\"quantity\":2}")        .with(jwt().authorities(new SimpleGrantedAuthority("SCOPE_orders.write"))))    .andExpect(status().isCreated())    .andExpect(header().exists("Location"))    .andExpect(jsonPath("$.quantity").value(2));

1. line 5 uses andExpect, the core of Testing HTTP endpoints (MockMvc, WebTestClient, REST Assured)
2. line 6 uses andExpect, the core of Testing HTTP endpoints (MockMvc, WebTestClient, REST Assured)
3. line 7 uses andExpect, the core of Testing HTTP endpoints (MockMvc, WebTestClient, REST Assured)

How Unravel recognises it

When you paste code, Unravel looks for these signs of testing http endpoints (mockmvc, webtestclient, rest assured). Spotting them yourself is a good habit when you read unfamiliar code:

• Types: MockMvc MockMvcRequestBuilders MockMvcResultMatchers MockHttpServletRequest MockHttpServletResponse WebTestClient RestAssured ResultActions MvcResult MockMvcBuilders RequestPostProcessor SecurityMockMvcRequestPostProcessors MockMultipartFile MockMvcTester and 1 more
• Method calls: andExpect() andReturn() andDo() jsonPath() expectStatus() expectBody()

Part of a learning path

• Testing enterprise code · previous: Spring Boot test slices and test configuration · next: Testcontainers (real databases and brokers in tests)

Related concepts