Class RestTestClientRestDocumentation

java.lang.Object

org.springframework.restdocs.resttestclient.RestTestClientRestDocumentation

public abstract class RestTestClientRestDocumentation
extends Object

Static factory methods for documenting RESTful APIs using Spring Framework's RestTestClient.

Since:

4.1.0

Author:

Andy Wilkinson

Method Summary

Modifier and Type	Method	Description
static <T extends ExchangeResult> Consumer<T>	document(String identifier, OperationRequestPreprocessor requestPreprocessor, OperationResponsePreprocessor responsePreprocessor, Snippet... snippets)	Documents the API call with the given identifier using the given snippets in addition to any default snippets.
static <T extends ExchangeResult> Consumer<T>	document(String identifier, OperationRequestPreprocessor requestPreprocessor, Snippet... snippets)	Documents the API call with the given identifier using the given snippets in addition to any default snippets.
static <T extends ExchangeResult> Consumer<T>	document(String identifier, OperationResponsePreprocessor responsePreprocessor, Snippet... snippets)	Documents the API call with the given identifier using the given snippets in addition to any default snippets.
static <T extends ExchangeResult> Consumer<T>	document(String identifier, Snippet... snippets)	Returns a Consumer that, when called, documents the API call with the given identifier using the given snippets in addition to any default snippets.
static RestTestClientRestDocumentationConfigurer	documentationConfiguration(RestDocumentationContextProvider contextProvider)	Provides access to a ClientHttpRequestInterceptor that can be used to configure a RestTestClient instance using the given contextProvider.

Methods inherited from class Object

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

Method Details

documentationConfiguration

public static RestTestClientRestDocumentationConfigurer documentationConfiguration(RestDocumentationContextProvider contextProvider)

Provides access to a ClientHttpRequestInterceptor that can be used to configure a RestTestClient instance using the given contextProvider.

Parameters:

contextProvider - the context provider

Returns:

the configurer

See Also:

• RestTestClient.Builder.requestInterceptor(ClientHttpRequestInterceptor)

document

public static <T extends ExchangeResult>
Consumer<T> document(String identifier,
 Snippet... snippets)

Returns a Consumer that, when called, documents the API call with the given identifier using the given snippets in addition to any default snippets.

Type Parameters:

T - the type of ExchangeResult that will be consumed

Parameters:

identifier - an identifier for the API call that is being documented

snippets - the snippets

Returns:

the Consumer that will document the API call represented by the ExchangeResult.

See Also:

• RestTestClient.BodySpec.consumeWith(Consumer)
• RestTestClient.BodyContentSpec.consumeWith(Consumer)

document

public static <T extends ExchangeResult>
Consumer<T> document(String identifier,
 OperationRequestPreprocessor requestPreprocessor,
 Snippet... snippets)

Documents the API call with the given identifier using the given snippets in addition to any default snippets. The given requestPreprocessor is applied to the request before it is documented.

Type Parameters:

T - the type of ExchangeResult that will be consumed

Parameters:

identifier - an identifier for the API call that is being documented

requestPreprocessor - the request preprocessor

snippets - the snippets

Returns:

the Consumer that will document the API call represented by the ExchangeResult.

document

public static <T extends ExchangeResult>
Consumer<T> document(String identifier,
 OperationResponsePreprocessor responsePreprocessor,
 Snippet... snippets)

Documents the API call with the given identifier using the given snippets in addition to any default snippets. The given responsePreprocessor is applied to the request before it is documented.

Type Parameters:

T - the type of ExchangeResult that will be consumed

Parameters:

identifier - an identifier for the API call that is being documented

responsePreprocessor - the response preprocessor

snippets - the snippets

Returns:

the Consumer that will document the API call represented by the ExchangeResult.

document

public static <T extends ExchangeResult>
Consumer<T> document(String identifier,
 OperationRequestPreprocessor requestPreprocessor,
 OperationResponsePreprocessor responsePreprocessor,
 Snippet... snippets)

Documents the API call with the given identifier using the given snippets in addition to any default snippets. The given requestPreprocessor and responsePreprocessor are applied to the request and response respectively before they are documented.

Type Parameters:

T - the type of ExchangeResult that will be consumed

Parameters:

identifier - an identifier for the API call that is being documented

requestPreprocessor - the request preprocessor

responsePreprocessor - the response preprocessor

snippets - the snippets

Returns:

the Consumer that will document the API call represented by the ExchangeResult.