Spring MVC Integration Testing

Slides of my talk about the Spring MVC integration testing framework held at JUG Saxony Day 2014 in Dresden.

@springcentral

Transcript

1. Spring MVC Integration Testing ! ! ! ! ! ! Oliver Gierke
2. Oliver Gierke Engineer @ Pivotal Spring Data Project Lead ! ogierke@gopivotal.com www.olivergierke.de olivergierke
3. We want to build quality software!
4. Testable software is quality software!
5. Only testable software can be changed easily.
6. Testing should cause as little overhead as possible.
7. Unit testing
   VS.
   Integration testing
8. Side track:
   Spring MVC
9. Spring MVC Infrastructure HTTP / Servlet API Controller implementations Application services
10. @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 Controller
11. @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
12. Unit testable
    Mock dependencies
    Call methods
    Verify outcome
13. What about the web layer overall?
14. Left untested
    Servlet API setup
    Spring MVC setup
    Request mapping
    Custom extensions
15. Spring MVC HTTP / Servlet API Controller implementations Application services Extensions
16. The 2 runtimes approach
17. Test process
    Use embedded container
    Bootstrap before tests
    Execute tests
    Shutdown after tests
18. Application in embedded Jetty / Tomcat Test execution JVM JVM
19. Environment
    implications
    Separate process
    Port required in environment
    Build setup tweaks
20. Testing
    implications
    Data setup
    Transaction management
21. Works, but
    has its issues.
22. The integrated runtime approach
23. Test Context Framework
    Bootstraps ApplicationContexts
    Transaction management
    Context caching
    Extensible
24. @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration("classpath:application-context.xml") @Transactional public class SampleIntegrationTests { ! @Autowired private Dependency dependency; ! @Test public void myTest() { // Implement test here } } Sample test case
25. Test Context Framework ! ! ! ! ! ! ! ApplicationContext MockMVC ! ! !
26. Mock MVC
    Integrates with Test Framework
    API to build "requests"
    API to define result expectations
27. Setup
    Bootstrap from WebApplicationContext
    Register Servlet API artifacts
    Support for individual controllers
28. @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
29. Building requests
    Execute HTTP methods
    Define request parameters / payload
    HTTP headers
30. import static org.sfw.….MockMvcRequestBuilders.*; import static org.sfw.….MockMvcResultMatchers.*; ! public class SampleIntegrationTests { ! @Before 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
31. Define expectations
    Response status, header, body
    XPath / JSONPath
32. DEMO
33. Recap
34. In-container
    MVC testing
35. Benefits
    No infrastructure implications
    No build tweaks necessary
    Standard test transaction handling
    Context caching
36. Client side
    REST tests
37. 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
38. Questions?
39. Resources Reference documentation Spring RESTBucks