Spring MVC Integration Testing

Slide of my talk at JUG Ostfalen about Spring MVC integration testing

Transcript

1. Spring MVC Integration Testing Oliver Gierke
2. Oliver Gierke Spring Data Core/JPA/MongoDB JPA 2.1 Expert Group ogierke@vmware.com www.olivergierke.de olivergierke
3. We want to build quality software!
4. We want to build quality software!
5. Testable software is quality software!
6. Testable software is quality software!
7. Only testable software can be changed easily.
8. Only testable software can be changed easily.
9. Testing should cause as little overhead as possible.
10. Testing should cause as little overhead as possible.
11. Unit testing VS. Integration testing
12. Side track: Spring MVC
13. Spring MVC Infrastructure HTTP / Servlet API Controller implementations Application services
14. Spring MVC Infrastructure HTTP / Servlet API Controller implementations Application services
15. Spring MVC Infrastructure HTTP / Servlet API Controller implementations Application services
16. @Controller class PersonController { @RequestMapping(value = "/people", method = GET) HttpEntity<List<Person>> showPeople() { List<Person> result = people.findAll(); return new ResponseEntity<>(result, HttpStatus.OK); } @RequestMapping(value = "/people", method = POST) HttpEntity<Void> create(@RequestBody Person person) { Person result = people.create(person); HttpHeaders = new HttpHeaders(); headers.setLocation(…); return new ResponseEntity<>(headers, HttpStatus.CREATED); } } REST
17. @Controller class PersonController { @RequestMapping(value = "/people", method = GET) String showPeople(Model model) { model.put("people", people.findAll()); return "people"; } @RequestMapping(value = "/people", method = POST) String create(@ModelAttribute Person person, Model model) { Person result = people.create(person); // Add success or error message to model return "people"; } } View resolution
18. Unit testable Mock dependencies Call methods Verify outcome
19. What about the web layer overall?
20. Left untested Servlet API setup Spring MVC setup Request mapping Custom extensions
21. Spring MVC HTTP / Servlet API Controller implementations Application services Extensions
22. The 2 runtimes approach
23. Test process Use embedded container Bootstrap before tests Execute tests Shutdown after tests
24. Application in embedded Jetty / Tomcat Test execution JVM JVM
25. Application in embedded Jetty / Tomcat Test execution JVM JVM
26. Environment implications Separate process Port required in environment Build setup tweaks
27. Testing implications Data setup Transaction management
28. Works, but has its issues.
29. The integrated runtime approach
30. Test Context Framework Bootstraps ApplicationContexts Transaction management Context caching Extensible
31. @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration("classpath:application-context.xml") @Transactional public class SampleIntegrationTests { @Autowired Dependency dependency; @Test public void myTest() { // Implement test here } } Sample test case
32. Test Context Framework ApplicationContext
33. Test Context Framework ApplicationContext MockMVC
34. Mock MVC Integrates with Test Framework API to build "requests" API to define result expectations
35. @RunWith(SpringJUnit4ClassRunner.class) @WebAppConfiguration @ContextConfiguration("classpath:application-context.xml") public class SampleIntegrationTests { @Autowired WebApplicationContext context; MockMvc mvc; @Before public void setUp() { this.mvc = MockMvcBuilders. webAppContextSetup(this.context).build(); } } MVC testing
36. import static org.sfw.….MockMvcRequestBuilders.*; import static org.sfw.….MockMvcResultMatchers.*; public class SampleIntegrationTests { @Test public void setUp() { this.mvc.perform(get("/accounts/1") .accept(MediaType.APPLICATION_JSON)) .andExpect(status().isOk()) .andExpect(content().contentType("application/json")) .andExpect(jsonPath("$.name").value("Lee")); } } MVC testing
37. Setup Bootstrap from WebApplicationContext Register Servlet API artifacts Support for individual controllers
38. Building requests Execute HTTP methods Define request parameters / payload HTTP headers
39. Define expectations Response status, header, body XPath / JSONPath
40. DEMO
41. Recap
42. In-container MVC testing
43. Benefits No infrastructure implications No build tweaks necessary Standard test transaction handling Context caching
44. Client side REST tests
45. import static org.sfw.….MockRestResponseCreators.*; RestTemplate restTemplate = new RestTemplate(); MockRestServiceServer mockServer = MockRestServiceServer.createServer(restTemplate); mockServer.expect(requestTo("/greeting")) .andRespond(withSuccess("Hello world!", "text/plain")); // use RestTemplate mockServer.verify(); Mock REST server
46. Questions?
47. Resources Reference documentation Spring RESTBucks