org.springframework.restdocs.mockmvc

Class RestDocumentationResultHandler

java.lang.Object

org.springframework.restdocs.mockmvc.RestDocumentationResultHandler

All Implemented Interfaces:

org.springframework.test.web.servlet.ResultHandler

public class RestDocumentationResultHandler
extends java.lang.Object
implements org.springframework.test.web.servlet.ResultHandler

A Spring MVC Test ResultHandler for documenting RESTful APIs.

Author:

Andy Wilkinson, Andreas Evers

See Also:

MockMvcRestDocumentation.document(String, Snippet...)

Method Summary

Modifier and Type	Method and Description
RestDocumentationResultHandler	document(Snippet... snippets) Creates a new RestDocumentationResultHandler to be passed into ResultActions.andDo(ResultHandler) that will produce documentation using the given snippets.
protected RestDocumentationGenerator<org.springframework.mock.web.MockHttpServletRequest,org.springframework.mock.web.MockHttpServletResponse>	getDelegate() Returns the RestDocumentationGenerator that is used as a delegate.
void	handle(org.springframework.test.web.servlet.MvcResult result)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

handle

public void handle(org.springframework.test.web.servlet.MvcResult result)
            throws java.lang.Exception

Specified by:

handle in interface org.springframework.test.web.servlet.ResultHandler

Throws:

java.lang.Exception

document

public RestDocumentationResultHandler document(Snippet... snippets)

Creates a new RestDocumentationResultHandler to be passed into ResultActions.andDo(ResultHandler) that will produce documentation using the given snippets. For example:

 this.mockMvc.perform(MockMvcRequestBuilders.get("/search"))
     .andExpect(status().isOk())
     .andDo(this.documentationHandler.document(responseFields(
          fieldWithPath("page").description("The requested Page")
     ));
 

Parameters:

snippets - the snippets

Returns:

the new result handler

getDelegate

protected final RestDocumentationGenerator<org.springframework.mock.web.MockHttpServletRequest,org.springframework.mock.web.MockHttpServletResponse> getDelegate()

Returns the RestDocumentationGenerator that is used as a delegate.

Returns:

the delegate