org.tinygroup.springmvc.negotiation

Class ContentNegotiationManager

java.lang.Object

org.tinygroup.springmvc.negotiation.ContentNegotiationManager

All Implemented Interfaces:

ContentNegotiationStrategy, MediaTypeFileExtensionResolver

public class ContentNegotiationManager
extends Object
implements ContentNegotiationStrategy, MediaTypeFileExtensionResolver

内容协商相关配置管理器

Author:

renhui

Constructor Summary

Constructors

Constructor and Description
ContentNegotiationManager() Create a default instance with a HeaderContentNegotiationStrategy .
ContentNegotiationManager(Collection<ContentNegotiationStrategy> strategies) Create an instance with the given ContentNegotiationStrategy instances.
ContentNegotiationManager(ContentNegotiationStrategy... strategies) Create an instance with the given ContentNegotiationStrategy instances.

Method Summary

Modifier and Type	Method and Description
void	addFileExtensionResolvers(MediaTypeFileExtensionResolver... resolvers) Add MediaTypeFileExtensionResolver instances.
List<String>	getAllFileExtensions() Delegate to all configured MediaTypeFileExtensionResolver instances and aggregate the list of all known file extensions.
List<String>	resolveFileExtensions(org.springframework.http.MediaType mediaType) Delegate to all configured MediaTypeFileExtensionResolver instances and aggregate the list of all file extensions found.
List<org.springframework.http.MediaType>	resolveMediaTypes(org.springframework.web.context.request.NativeWebRequest webRequest) Delegate to all configured ContentNegotiationStrategy instances until one returns a non-empty list.

Methods inherited from class java.lang.Object

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

Constructor Detail

ContentNegotiationManager

public ContentNegotiationManager(ContentNegotiationStrategy... strategies)

Create an instance with the given ContentNegotiationStrategy instances.

Each instance is checked to see if it is also an implementation of MediaTypeFileExtensionResolver, and if so it is registered as such.

Parameters:

strategies - one more more ContentNegotiationStrategy instances

ContentNegotiationManager

public ContentNegotiationManager(Collection<ContentNegotiationStrategy> strategies)

Create an instance with the given ContentNegotiationStrategy instances.

Each instance is checked to see if it is also an implementation of MediaTypeFileExtensionResolver, and if so it is registered as such.

Parameters:

strategies - one more more ContentNegotiationStrategy instances

ContentNegotiationManager

public ContentNegotiationManager()

Create a default instance with a HeaderContentNegotiationStrategy .

Method Detail

addFileExtensionResolvers

public void addFileExtensionResolvers(MediaTypeFileExtensionResolver... resolvers)

Add MediaTypeFileExtensionResolver instances.

Note that some ContentNegotiationStrategy implementations also implement MediaTypeFileExtensionResolver and the class constructor accepting the former will also detect implementations of the latter. Therefore you only need to use this method to register additional instances.

Parameters:

resolvers - one or more resolvers

resolveMediaTypes

public List<org.springframework.http.MediaType> resolveMediaTypes(org.springframework.web.context.request.NativeWebRequest webRequest)
                                                           throws org.springframework.web.HttpMediaTypeNotAcceptableException

Delegate to all configured ContentNegotiationStrategy instances until one returns a non-empty list.

Specified by:

resolveMediaTypes in interface ContentNegotiationStrategy

Parameters:

webRequest - the current request

Returns:

the requested media types or an empty list, never null

Throws:

org.springframework.web.HttpMediaTypeNotAcceptableException - if the requested media types cannot be parsed

resolveFileExtensions

public List<String> resolveFileExtensions(org.springframework.http.MediaType mediaType)

Delegate to all configured MediaTypeFileExtensionResolver instances and aggregate the list of all file extensions found.

Specified by:

resolveFileExtensions in interface MediaTypeFileExtensionResolver

Parameters:

mediaType - the media type to resolve

Returns:

a list of extensions or an empty list (never null)

getAllFileExtensions

public List<String> getAllFileExtensions()

Delegate to all configured MediaTypeFileExtensionResolver instances and aggregate the list of all known file extensions.

Specified by:

getAllFileExtensions in interface MediaTypeFileExtensionResolver

Returns:

a list of extensions or an empty list (never null)