org.springframework.restdocs.headers

Class RequestHeadersSnippet

java.lang.Object

org.springframework.restdocs.snippet.TemplatedSnippet

org.springframework.restdocs.headers.AbstractHeadersSnippet

org.springframework.restdocs.headers.RequestHeadersSnippet

All Implemented Interfaces:

Snippet

public class RequestHeadersSnippet
extends AbstractHeadersSnippet

A Snippet that documents the headers in a request.

Author:

Andreas Evers, Andy Wilkinson

See Also:

HeaderDocumentation.requestHeaders(HeaderDescriptor...), HeaderDocumentation.requestHeaders(Map, HeaderDescriptor...)

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RequestHeadersSnippet(java.util.List<HeaderDescriptor> descriptors) Creates a new RequestHeadersSnippet that will document the headers in the request using the given descriptors.
protected	RequestHeadersSnippet(java.util.List<HeaderDescriptor> descriptors, java.util.Map<java.lang.String,java.lang.Object> attributes) Creates a new RequestHeadersSnippet that will document the headers in the request using the given descriptors.

Method Summary

Modifier and Type	Method and Description
RequestHeadersSnippet	and(HeaderDescriptor... additionalDescriptors) Returns a new RequestHeadersSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
RequestHeadersSnippet	and(java.util.List<HeaderDescriptor> additionalDescriptors) Returns a new RequestHeadersSnippet configured with this snippet's attributes and its descriptors combined with the given additionalDescriptors.
protected java.util.Set<java.lang.String>	extractActualHeaders(Operation operation) Extracts the names of the headers from the request or response of the given operation.

Methods inherited from class org.springframework.restdocs.headers.AbstractHeadersSnippet

createModel, createModelForDescriptor, findMissingHeaders, getHeaderDescriptors

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

RequestHeadersSnippet

protected RequestHeadersSnippet(java.util.List<HeaderDescriptor> descriptors)

Creates a new RequestHeadersSnippet that will document the headers in the request using the given descriptors.

Parameters:

descriptors - the descriptors

RequestHeadersSnippet

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

Creates a new RequestHeadersSnippet that will document the headers in the request using the given descriptors. The given attributes will be included in the model during template rendering.

Parameters:

descriptors - the descriptors

attributes - the additional attributes

Method Detail

extractActualHeaders

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

Description copied from class: AbstractHeadersSnippet

Extracts the names of the headers from the request or response of the given operation.

Specified by:

extractActualHeaders in class AbstractHeadersSnippet

Parameters:

operation - the operation

Returns:

the header names

and

public final RequestHeadersSnippet and(HeaderDescriptor... additionalDescriptors)

Returns a new RequestHeadersSnippet 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 RequestHeadersSnippet and(java.util.List<HeaderDescriptor> additionalDescriptors)

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

Parameters:

additionalDescriptors - the additional descriptors

Returns:

the new snippet