org.springframework.restdocs.payload

Class ResponseFieldsSnippet

java.lang.Object

org.springframework.restdocs.snippet.TemplatedSnippet

org.springframework.restdocs.payload.AbstractFieldsSnippet

org.springframework.restdocs.payload.ResponseFieldsSnippet

All Implemented Interfaces:

Snippet

public class ResponseFieldsSnippet
extends AbstractFieldsSnippet

A Snippet that documents the fields in a response.

Author:

Andy Wilkinson

See Also:

PayloadDocumentation.responseFields(FieldDescriptor...), PayloadDocumentation.responseFields(Map, FieldDescriptor...)

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ResponseFieldsSnippet(List<FieldDescriptor> descriptors) Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors.
protected	ResponseFieldsSnippet(List<FieldDescriptor> descriptors, boolean ignoreUndocumentedFields) Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors.
protected	ResponseFieldsSnippet(List<FieldDescriptor> descriptors, Map<String,Object> attributes) Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors.
protected	ResponseFieldsSnippet(List<FieldDescriptor> descriptors, Map<String,Object> attributes, boolean ignoreUndocumentedFields) Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors.

Method Summary

Modifier and Type	Method and Description
ResponseFieldsSnippet	and(FieldDescriptor... additionalDescriptors) Returns a new ResponseFieldsSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
ResponseFieldsSnippet	and(List<FieldDescriptor> additionalDescriptors) Returns a new ResponseFieldsSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
ResponseFieldsSnippet	andWithPrefix(String pathPrefix, FieldDescriptor... additionalDescriptors) Returns a new ResponseFieldsSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
ResponseFieldsSnippet	andWithPrefix(String pathPrefix, List<FieldDescriptor> additionalDescriptors) Returns a new ResponseFieldsSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
protected byte[]	getContent(Operation operation) Returns the content of the request or response extracted form the given operation.
protected MediaType	getContentType(Operation operation) Returns the content type of the request or response extracted from the given operation.

Methods inherited from class org.springframework.restdocs.payload.AbstractFieldsSnippet

createModel, createModelForDescriptor, getFieldDescriptors

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

ResponseFieldsSnippet

protected ResponseFieldsSnippet(List<FieldDescriptor> descriptors)

Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors. Undocumented fields will trigger a failure.

Parameters:

descriptors - the descriptors

ResponseFieldsSnippet

protected ResponseFieldsSnippet(List<FieldDescriptor> descriptors,
                                boolean ignoreUndocumentedFields)

Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors. If ignoreUndocumentedFields is true, undocumented fields will be ignored and will not trigger a failure.

Parameters:

descriptors - the descriptors

ignoreUndocumentedFields - whether undocumented fields should be ignored

ResponseFieldsSnippet

protected ResponseFieldsSnippet(List<FieldDescriptor> descriptors,
                                Map<String,Object> attributes)

Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors. The given attributes will be included in the model during template rendering. Undocumented fields will trigger a failure.

Parameters:

descriptors - the descriptors

attributes - the additional attributes

ResponseFieldsSnippet

protected ResponseFieldsSnippet(List<FieldDescriptor> descriptors,
                                Map<String,Object> attributes,
                                boolean ignoreUndocumentedFields)

Creates a new ResponseFieldsSnippet that will document the fields in the response using the given descriptors. The given attributes will be included in the model during template rendering. If ignoreUndocumentedFields is true, undocumented fields will be ignored and will not trigger a failure.

Parameters:

descriptors - the descriptors

attributes - the additional attributes

ignoreUndocumentedFields - whether undocumented fields should be ignored

Method Detail

getContentType

protected MediaType getContentType(Operation operation)

Description copied from class: AbstractFieldsSnippet

Returns the content type of the request or response extracted from the given operation.

Specified by:

getContentType in class AbstractFieldsSnippet

Parameters:

operation - The operation

Returns:

The content type

getContent

protected byte[] getContent(Operation operation)
                     throws IOException

Description copied from class: AbstractFieldsSnippet

Returns the content of the request or response extracted form the given operation.

Specified by:

getContent in class AbstractFieldsSnippet

Parameters:

operation - The operation

Returns:

The content

Throws:

IOException - if the content cannot be extracted

and

public final ResponseFieldsSnippet and(FieldDescriptor... additionalDescriptors)

Returns a new ResponseFieldsSnippet 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 ResponseFieldsSnippet and(List<FieldDescriptor> additionalDescriptors)

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

Parameters:

additionalDescriptors - the additional descriptors

Returns:

the new snippet

andWithPrefix

public final ResponseFieldsSnippet andWithPrefix(String pathPrefix,
                                                 FieldDescriptor... additionalDescriptors)

Returns a new ResponseFieldsSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors. The given pathPrefix is applied to the path of each additional descriptor.

Parameters:

pathPrefix - the prefix to apply to the additional descriptors

additionalDescriptors - the additional descriptors

Returns:

the new snippet

andWithPrefix

public final ResponseFieldsSnippet andWithPrefix(String pathPrefix,
                                                 List<FieldDescriptor> additionalDescriptors)

Returns a new ResponseFieldsSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors. The given pathPrefix is applied to the path of each additional descriptor.

Parameters:

pathPrefix - the prefix to apply to the additional descriptors

additionalDescriptors - the additional descriptors

Returns:

the new snippet