Spring MVC Test Support
The goal of this project is to faciliate unit testing Spring MVC controllers on the server side and client code on the client side that depends on the RestTemplate.
This code will be included in the spring-test
module of the Spring Framework. Its present home here allows us to evolve it on a flexible release schedule and with community feedback potentially accommodating a wide range of scenarios.
Server-Side
Overview
Annotated-controllers depend on Spring MVC to handle many things such as mapping requests, performing data binding and validation, setting the response status, writing to the body of the response using the correct content type, and many more.
To test all that you may instantiate an in-memory Servlet container driving requests with JWebUnit or you may use a test tool such as JMeter or Selenium. These options are all valid. However they take longer to execute and can only perform black-box testing.
The aim of this project is to make it easy to test controllers by building on the familiar MockHttpServletRequest
and the MockHttpServletResponse
from the spring-test
module and without the need for a Servlet container. Whether you want to point to one controller or to test with your complete web application context setup, it should be easy to send a request and verify the results.
Examples
Test an @ResponseBody
method in a controller:
MockMvcBuilders.standaloneMvcSetup(new TestController()).build()
.perform(get("/form"))
.andExpect(response().status().isOk())
.andExpect(response().contentType("text/plain"))
.andExpect(response().responseBody("content"));
Test binding failure by pointing to Spring MVC XML-based context configuration:
MockMvcBuilders.xmlConfigMvcSetup("classpath:org/examples/servlet-context.xml").build()
.perform(get("/form"))
.andExpect(response().status().isOk())
.andExpect(model().modelAttributesWithErrors("formBean"))
.andExpect(view().viewName("form"));
Test serving a resource by pointing to Spring MVC Java-based application configuration:
MockMvcBuilders.annotationConfigMvcSetup(TestConfiguration.class).build()
.perform(get("/resources/Spring.js"))
.andExpect(response().contentType("application/octet-stream"))
.andExpect(response().responseBodyContains("Spring={};"));
For more examples see tests in the org.springframework.test.web.server package.
Limitations
Most rendering technologies should work as expected. For Tiles and JSP, while you can test with your existing configuration as is, no actual JSP-based rendering will take place. Instead you should verify the path the request was forwarded to (i.e. the path to the JSP page) or you can also verify the selected view name.
Maven
You can get it from the Spring Maven Snapshot repository: http://maven.springframework.org/snapshot
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test-mvc</artifactId>
<version>1.0.0.BUILD-SNAPSHOT</version>
</dependency
Contributions
If you see anything you'd like to change we encourage taking advantage of github's social coding features by making the change in a fork of this repository and sending a pull request.
To report an issue the Spring Framework forum or the Spring JIRA creating requests under the component "SpringTEST".
Before we accept a non-trivial patch or pull request we will need you to sign the [contributor's agreement] (https://support.springsource.com/spring_committer_signup). Signing the contributor's agreement does not grant anyone commit rights to the main repository, but it does mean that we can accept your contributions, and you will get an author credit if we do. Active contributors might be asked to join the core team, and given the ability to merge pull requests.
Acknowledgements
This project draws inspiration from similar server-side and client-side test support introduced in Spring Web Services 2.0.