org.springframework.web.accept

Class PathExtensionContentNegotiationStrategy

java.lang.Object

org.springframework.web.accept.MappingMediaTypeFileExtensionResolver

org.springframework.web.accept.AbstractMappingContentNegotiationStrategy

org.springframework.web.accept.PathExtensionContentNegotiationStrategy

All Implemented Interfaces:

ContentNegotiationStrategy, MediaTypeFileExtensionResolver

public class PathExtensionContentNegotiationStrategy
extends AbstractMappingContentNegotiationStrategy

A ContentNegotiationStrategy that uses the path extension of the URL to determine what media types are requested. The path extension is used as follows:

1. Look upin the map of media types provided to the constructor
2. Call to ServletContext.getMimeType(String)
3. Use the Java Activation framework

The presence of the Java Activation framework is detected and enabled automatically but the setUseJaf(boolean) property may be used to override that setting.

Since:

3.2

Author:

Rossen Stoyanchev

Constructor Summary

Constructors

Constructor and Description
PathExtensionContentNegotiationStrategy() Create an instance without any mappings to start with.
PathExtensionContentNegotiationStrategy(java.util.Map<java.lang.String,MediaType> mediaTypes) Create an instance with the given extension-to-MediaType lookup.

Method Summary

Methods

Modifier and Type	Method and Description
protected java.lang.String	getMediaTypeKey(NativeWebRequest webRequest) Sub-classes must extract the key to use to look up a media type.
protected void	handleMatch(java.lang.String extension, MediaType mediaType) Invoked when a matching media type is found in the lookup map.
protected MediaType	handleNoMatch(NativeWebRequest webRequest, java.lang.String extension) Invoked when no matching media type is found in the lookup map.
void	setUseJaf(boolean useJaf) Indicate whether to use the Java Activation Framework to map from file extensions to media types.

Methods inherited from class org.springframework.web.accept.AbstractMappingContentNegotiationStrategy

resolveMediaTypes

Methods inherited from class org.springframework.web.accept.MappingMediaTypeFileExtensionResolver

addMapping, getAllFileExtensions, lookupMediaType, resolveFileExtensions

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.web.accept.MediaTypeFileExtensionResolver

getAllFileExtensions, resolveFileExtensions

Constructor Detail

PathExtensionContentNegotiationStrategy

public PathExtensionContentNegotiationStrategy(java.util.Map<java.lang.String,MediaType> mediaTypes)

Create an instance with the given extension-to-MediaType lookup.

Throws:

java.lang.IllegalArgumentException - if a media type string cannot be parsed

PathExtensionContentNegotiationStrategy

public PathExtensionContentNegotiationStrategy()

Create an instance without any mappings to start with. Mappings may be added later on if any extensions are resolved through ServletContext.getMimeType(String) or through the Java Activation framework.

Method Detail

setUseJaf

public void setUseJaf(boolean useJaf)

Indicate whether to use the Java Activation Framework to map from file extensions to media types.

Default is true, i.e. the Java Activation Framework is used (if available).

getMediaTypeKey

protected java.lang.String getMediaTypeKey(NativeWebRequest webRequest)

Description copied from class: AbstractMappingContentNegotiationStrategy

Sub-classes must extract the key to use to look up a media type.

Specified by:

getMediaTypeKey in class AbstractMappingContentNegotiationStrategy

Returns:

the lookup key or null if the key cannot be derived

handleMatch

protected void handleMatch(java.lang.String extension,
               MediaType mediaType)

Description copied from class: AbstractMappingContentNegotiationStrategy

Invoked when a matching media type is found in the lookup map.

Overrides:

handleMatch in class AbstractMappingContentNegotiationStrategy

handleNoMatch

protected MediaType handleNoMatch(NativeWebRequest webRequest,
                      java.lang.String extension)

Description copied from class: AbstractMappingContentNegotiationStrategy

Invoked when no matching media type is found in the lookup map. Sub-classes can take further steps to determine the media type.

Overrides:

handleNoMatch in class AbstractMappingContentNegotiationStrategy