org.springframework.restdocs.request

Class PathParametersSnippet

java.lang.Object

org.springframework.restdocs.snippet.TemplatedSnippet

org.springframework.restdocs.request.AbstractParametersSnippet

org.springframework.restdocs.request.PathParametersSnippet

All Implemented Interfaces:

Snippet

public class PathParametersSnippet
extends AbstractParametersSnippet

A Snippet that documents the path parameters supported by a RESTful resource.

Author:

Andy Wilkinson

See Also:

RequestDocumentation.pathParameters(ParameterDescriptor...), RequestDocumentation.pathParameters(Map, ParameterDescriptor...)

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors) Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors.
protected	PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors, boolean ignoreUndocumentedParameters) Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors.
protected	PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors, java.util.Map<java.lang.String,java.lang.Object> attributes) Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors.
protected	PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors, java.util.Map<java.lang.String,java.lang.Object> attributes, boolean ignoreUndocumentedParameters) Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors.

Method Summary

Modifier and Type	Method and Description
PathParametersSnippet	and(java.util.List<ParameterDescriptor> additionalDescriptors) Returns a new PathParametersSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
PathParametersSnippet	and(ParameterDescriptor... additionalDescriptors) Returns a new PathParametersSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
protected java.util.Map<java.lang.String,java.lang.Object>	createModel(Operation operation) Create the model that should be used during template rendering to document the given operation.
protected java.util.Set<java.lang.String>	extractActualParameters(Operation operation) Extracts the names of the parameters that were present in the given operation.
protected void	verificationFailed(java.util.Set<java.lang.String> undocumentedParameters, java.util.Set<java.lang.String> missingParameters) Called when the documented parameters do not match the actual parameters.

Methods inherited from class org.springframework.restdocs.request.AbstractParametersSnippet

createModelForDescriptor, getFieldDescriptors, getParameterDescriptors

Methods inherited from class org.springframework.restdocs.snippet.TemplatedSnippet

document, getAttributes, getSnippetName

Methods inherited from class java.lang.Object

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

Constructor Detail

PathParametersSnippet

protected PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors)

Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors. Undocumented parameters will trigger a failure.

Parameters:

descriptors - the parameter descriptors

PathParametersSnippet

protected PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors,
                                boolean ignoreUndocumentedParameters)

Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors. If ignoreUndocumentedParameters is true, undocumented parameters will be ignored and will not trigger a failure.

Parameters:

descriptors - the parameter descriptors

ignoreUndocumentedParameters - whether undocumented parameters should be ignored

PathParametersSnippet

protected PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors,
                                java.util.Map<java.lang.String,java.lang.Object> attributes)

Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors. The given attributes will be included in the model during template rendering. Undocumented parameters will trigger a failure.

Parameters:

descriptors - the parameter descriptors

attributes - the additional attributes

PathParametersSnippet

protected PathParametersSnippet(java.util.List<ParameterDescriptor> descriptors,
                                java.util.Map<java.lang.String,java.lang.Object> attributes,
                                boolean ignoreUndocumentedParameters)

Creates a new PathParametersSnippet that will document the request's path parameters using the given descriptors. The given attributes will be included in the model during template rendering. If ignoreUndocumentedParameters is true, undocumented parameters will be ignored and will not trigger a failure.

Parameters:

descriptors - the parameter descriptors

attributes - the additional attributes

ignoreUndocumentedParameters - whether undocumented parameters should be ignored

Method Detail

createModel

protected java.util.Map<java.lang.String,java.lang.Object> createModel(Operation operation)

Description copied from class: TemplatedSnippet

Create the model that should be used during template rendering to document the given operation. Any additional attributes that were supplied when this TemplatedSnippet were created will be automatically added to the model prior to rendering.

Overrides:

createModel in class AbstractParametersSnippet

Parameters:

operation - the operation

Returns:

the model

extractActualParameters

protected java.util.Set<java.lang.String> extractActualParameters(Operation operation)

Description copied from class: AbstractParametersSnippet

Extracts the names of the parameters that were present in the given operation.

Specified by:

extractActualParameters in class AbstractParametersSnippet

Parameters:

operation - the operation

Returns:

the parameters

verificationFailed

protected void verificationFailed(java.util.Set<java.lang.String> undocumentedParameters,
                                  java.util.Set<java.lang.String> missingParameters)

Description copied from class: AbstractParametersSnippet

Called when the documented parameters do not match the actual parameters.

Specified by:

verificationFailed in class AbstractParametersSnippet

Parameters:

undocumentedParameters - the parameters that were found in the operation but were not documented

missingParameters - the parameters that were documented but were not found in the operation

and

public final PathParametersSnippet and(ParameterDescriptor... additionalDescriptors)

Returns a new PathParametersSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.

Parameters:

additionalDescriptors - the additional descriptors

Returns:

the new snippet

and

public final PathParametersSnippet and(java.util.List<ParameterDescriptor> additionalDescriptors)

Returns a new PathParametersSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.

Parameters:

additionalDescriptors - the additional descriptors

Returns:

the new snippet