org.springframework.restdocs.payload

Class AbstractFieldsSnippet

java.lang.Object

org.springframework.restdocs.snippet.TemplatedSnippet

org.springframework.restdocs.payload.AbstractFieldsSnippet

All Implemented Interfaces:

Snippet

Direct Known Subclasses:

RequestFieldsSnippet, ResponseFieldsSnippet

public abstract class AbstractFieldsSnippet
extends TemplatedSnippet

Abstract TemplatedSnippet subclass that provides a base for snippets that document a RESTful resource's request or response fields.

Author:

Andreas Evers, Andy Wilkinson

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractFieldsSnippet(String type, List<FieldDescriptor> descriptors, Map<String,Object> attributes) Deprecated. since 1.1 in favor of AbstractFieldsSnippet(String, List, Map, boolean)
protected	AbstractFieldsSnippet(String type, List<FieldDescriptor> descriptors, Map<String,Object> attributes, boolean ignoreUndocumentedFields) Creates a new AbstractFieldsSnippet that will produce a snippet named <type>-fields.

Method Summary

Modifier and Type	Method and Description
protected Map<String,Object>	createModel(Operation operation) Create the model that should be used during template rendering to document the given operation.
protected Map<String,Object>	createModelForDescriptor(FieldDescriptor descriptor) Returns a model for the given descriptor.
protected abstract byte[]	getContent(Operation operation) Returns the content of the request or response extracted form the given operation.
protected abstract MediaType	getContentType(Operation operation) Returns the content type of the request or response extracted from the given operation.
protected List<FieldDescriptor>	getFieldDescriptors() Returns the list of FieldDescriptors that will be used to generate the documentation.

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

AbstractFieldsSnippet

@Deprecated
protected AbstractFieldsSnippet(String type,
                                            List<FieldDescriptor> descriptors,
                                            Map<String,Object> attributes)

Deprecated. since 1.1 in favor of AbstractFieldsSnippet(String, List, Map, boolean)

Creates a new AbstractFieldsSnippet that will produce a snippet named <type>-fields. The fields will be documented using the given descriptors and the given attributes will be included in the model during template rendering. Undocumented fields will trigger a failure.

Parameters:

type - the type of the fields

descriptors - the field descriptors

attributes - the additional attributes

AbstractFieldsSnippet

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

Creates a new AbstractFieldsSnippet that will produce a snippet named <type>-fields. The fields will be documented using the given descriptors and 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:

type - the type of the fields

descriptors - the field descriptors

attributes - the additional attributes

ignoreUndocumentedFields - whether undocumented fields should be ignored

Method Detail

createModel

protected Map<String,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.

Specified by:

createModel in class TemplatedSnippet

Parameters:

operation - The operation

Returns:

the model

getContentType

protected abstract MediaType getContentType(Operation operation)

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

Parameters:

operation - The operation

Returns:

The content type

getContent

protected abstract byte[] getContent(Operation operation)
                              throws IOException

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

Parameters:

operation - The operation

Returns:

The content

Throws:

IOException - if the content cannot be extracted

getFieldDescriptors

protected final List<FieldDescriptor> getFieldDescriptors()

Returns the list of FieldDescriptors that will be used to generate the documentation.

Returns:

the field descriptors

createModelForDescriptor

protected Map<String,Object> createModelForDescriptor(FieldDescriptor descriptor)

Returns a model for the given descriptor.

Parameters:

descriptor - the descriptor

Returns:

the model