org.springframework.restdocs.hypermedia

Class LinksSnippet

java.lang.Object

org.springframework.restdocs.snippet.TemplatedSnippet

org.springframework.restdocs.hypermedia.LinksSnippet

All Implemented Interfaces:

Snippet

public class LinksSnippet
extends TemplatedSnippet

A Snippet that documents a RESTful resource's links.

Author:

Andy Wilkinson

See Also:

HypermediaDocumentation.links(LinkDescriptor...), HypermediaDocumentation.links(LinkExtractor, LinkDescriptor...), HypermediaDocumentation.links(Map, LinkDescriptor...), HypermediaDocumentation.links(LinkExtractor, Map, LinkDescriptor...)

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LinksSnippet(LinkExtractor linkExtractor, List<LinkDescriptor> descriptors) Creates a new LinksSnippet that will extract links using the given linkExtractor and document them using the given descriptors.
protected	LinksSnippet(LinkExtractor linkExtractor, List<LinkDescriptor> descriptors, Map<String,Object> attributes) Creates a new LinksSnippet that will extract links using the given linkExtractor and document them using the given descriptors.

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(LinkDescriptor descriptor) Returns a model for the given descriptor.
protected Map<String,LinkDescriptor>	getDescriptorsByRel() Returns a Map of LinkDescriptors keyed by their rels.

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

LinksSnippet

protected LinksSnippet(LinkExtractor linkExtractor,
                       List<LinkDescriptor> descriptors)

Creates a new LinksSnippet that will extract links using the given linkExtractor and document them using the given descriptors.

Parameters:

linkExtractor - the link extractor

descriptors - the link descriptors

LinksSnippet

protected LinksSnippet(LinkExtractor linkExtractor,
                       List<LinkDescriptor> descriptors,
                       Map<String,Object> attributes)

Creates a new LinksSnippet that will extract links using the given linkExtractor and document them using the given descriptors. The given attributes will be included in the model during template rendering.

Parameters:

linkExtractor - the link extractor

descriptors - the link descriptors

attributes - the additional attributes

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

getDescriptorsByRel

protected final Map<String,LinkDescriptor> getDescriptorsByRel()

Returns a Map of LinkDescriptors keyed by their rels.

Returns:

the link descriptors

createModelForDescriptor

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

Returns a model for the given descriptor.

Parameters:

descriptor - the descriptor

Returns:

the model