org.springframework.web.reactive.resource

Class ResourceWebHandler

java.lang.Object

org.springframework.web.reactive.resource.ResourceWebHandler

All Implemented Interfaces:

InitializingBean, WebHandler

public class ResourceWebHandler
extends java.lang.Object
implements WebHandler, InitializingBean

HttpRequestHandler that serves static resources in an optimized way according to the guidelines of Page Speed, YSlow, etc.

The "locations" property takes a list of Spring Resource locations from which static resources are allowed to be served by this handler. Resources could be served from a classpath location, e.g. "classpath:/META-INF/public-web-resources/", allowing convenient packaging and serving of resources such as .js, .css, and others in jar files.

This request handler may also be configured with a resourcesResolver and resourceTransformer chains to support arbitrary resolution and transformation of resources being served. By default a PathResourceResolver simply finds resources based on the configured "locations". An application can configure additional resolvers and transformers such as the VersionResourceResolver which can resolve and prepare URLs for resources with a version in the URL.

This handler also properly evaluates the Last-Modified header (if present) so that a 304 status code will be returned as appropriate, avoiding unnecessary overhead for resources that are already cached by the client.

Since:

5.0

Author:

Rossen Stoyanchev, Brian Clozel

Field Summary

Fields

Modifier and Type	Field and Description
private CacheControl	cacheControl
private java.util.List<Resource>	locations
private java.util.List<java.lang.String>	locationValues
private static Log	logger
private ResourceResolverChain	resolverChain
private ResourceHttpMessageWriter	resourceHttpMessageWriter
private ResourceLoader	resourceLoader
private java.util.List<ResourceResolver>	resourceResolvers
private java.util.List<ResourceTransformer>	resourceTransformers
private static java.util.Set<HttpMethod>	SUPPORTED_METHODS
private ResourceTransformerChain	transformerChain

Constructor Summary

Constructors

Constructor and Description
ResourceWebHandler()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.
private java.lang.String	cleanDuplicateSlashes(java.lang.String path)
private java.lang.String	cleanLeadingSlash(java.lang.String path)
private java.lang.Object	formatLocations()
CacheControl	getCacheControl() Return the CacheControl instance to build the Cache-Control HTTP response header.
java.util.List<Resource>	getLocations() Return the List of Resource paths to use as sources for serving static resources.
java.util.List<java.lang.String>	getLocationValues() Return the configured location values.
protected <any>	getResource(ServerWebExchange exchange)
ResourceHttpMessageWriter	getResourceHttpMessageWriter() Return the configured resource message writer.
java.util.List<ResourceResolver>	getResourceResolvers() Return the list of configured resource resolvers.
java.util.List<ResourceTransformer>	getResourceTransformers() Return the list of configured resource transformers.
<any>	handle(ServerWebExchange exchange) Processes a resource request.
protected void	initAllowedLocations() Look for a PathResourceResolver among the configured resource resolvers and set its allowedLocations property (if empty) to match the locations configured on this class.
private boolean	isInvalidEncodedPath(java.lang.String path) Check whether the given path contains invalid escape sequences.
protected boolean	isInvalidPath(java.lang.String path) Identifies invalid resource paths.
protected java.lang.String	processPath(java.lang.String path) Process the given resource path.
private void	resolveResourceLocations()
void	setCacheControl(CacheControl cacheControl) Set the CacheControl instance to build the Cache-Control HTTP response header.
protected void	setHeaders(ServerWebExchange exchange, Resource resource, MediaType mediaType) Set headers on the response.
void	setLocations(java.util.List<Resource> locations) Set the List of Resource paths to use as sources for serving static resources.
void	setLocationValues(java.util.List<java.lang.String> locationValues) Accepts a list of String-based location values to be resolved into Resource locations.
void	setResourceHttpMessageWriter(ResourceHttpMessageWriter httpMessageWriter) Configure the ResourceHttpMessageWriter to use.
void	setResourceLoader(ResourceLoader resourceLoader) Provide the ResourceLoader to load location values with.
void	setResourceResolvers(java.util.List<ResourceResolver> resourceResolvers) Configure the list of ResourceResolvers to use.
void	setResourceTransformers(java.util.List<ResourceTransformer> resourceTransformers) Configure the list of ResourceTransformers to use.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

SUPPORTED_METHODS

private static final java.util.Set<HttpMethod> SUPPORTED_METHODS

logger

private static final Log logger

locationValues

private final java.util.List<java.lang.String> locationValues

locations

private final java.util.List<Resource> locations

resourceResolvers

private final java.util.List<ResourceResolver> resourceResolvers

resourceTransformers

private final java.util.List<ResourceTransformer> resourceTransformers

resolverChain

@Nullable
private ResourceResolverChain resolverChain

transformerChain

@Nullable
private ResourceTransformerChain transformerChain

cacheControl

@Nullable
private CacheControl cacheControl

resourceHttpMessageWriter

@Nullable
private ResourceHttpMessageWriter resourceHttpMessageWriter

resourceLoader

@Nullable
private ResourceLoader resourceLoader

Constructor Detail

ResourceWebHandler

public ResourceWebHandler()

Method Detail

setLocationValues

public void setLocationValues(java.util.List<java.lang.String> locationValues)

Accepts a list of String-based location values to be resolved into Resource locations.

Since:

5.1

getLocationValues

public java.util.List<java.lang.String> getLocationValues()

Return the configured location values.

Since:

5.1

setLocations

public void setLocations(@Nullable
                         java.util.List<Resource> locations)

Set the List of Resource paths to use as sources for serving static resources.

getLocations

public java.util.List<Resource> getLocations()

Return the List of Resource paths to use as sources for serving static resources.

Note that if locationValues are provided, instead of loaded Resource-based locations, this method will return empty until after initialization via afterPropertiesSet().

See Also:

setLocationValues(java.util.List<java.lang.String>), setLocations(java.util.List<org.springframework.core.io.Resource>)

setResourceResolvers

public void setResourceResolvers(@Nullable
                                 java.util.List<ResourceResolver> resourceResolvers)

Configure the list of ResourceResolvers to use.

By default PathResourceResolver is configured. If using this property, it is recommended to add PathResourceResolver as the last resolver.

getResourceResolvers

public java.util.List<ResourceResolver> getResourceResolvers()

Return the list of configured resource resolvers.

setResourceTransformers

public void setResourceTransformers(@Nullable
                                    java.util.List<ResourceTransformer> resourceTransformers)

Configure the list of ResourceTransformers to use.

By default no transformers are configured for use.

getResourceTransformers

public java.util.List<ResourceTransformer> getResourceTransformers()

Return the list of configured resource transformers.

setCacheControl

public void setCacheControl(@Nullable
                            CacheControl cacheControl)

Set the CacheControl instance to build the Cache-Control HTTP response header.

getCacheControl

@Nullable
public CacheControl getCacheControl()

Return the CacheControl instance to build the Cache-Control HTTP response header.

setResourceHttpMessageWriter

public void setResourceHttpMessageWriter(@Nullable
                                         ResourceHttpMessageWriter httpMessageWriter)

Configure the ResourceHttpMessageWriter to use.

By default a ResourceHttpMessageWriter will be configured.

getResourceHttpMessageWriter

@Nullable
public ResourceHttpMessageWriter getResourceHttpMessageWriter()

Return the configured resource message writer.

setResourceLoader

public void setResourceLoader(ResourceLoader resourceLoader)

Provide the ResourceLoader to load location values with.

Since:

5.1

afterPropertiesSet

public void afterPropertiesSet()
                        throws java.lang.Exception

Description copied from interface: InitializingBean

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

java.lang.Exception - in the event of misconfiguration (such as failure to set an essential property) or if initialization fails for any other reason

resolveResourceLocations

private void resolveResourceLocations()

initAllowedLocations

protected void initAllowedLocations()

Look for a PathResourceResolver among the configured resource resolvers and set its allowedLocations property (if empty) to match the locations configured on this class.

handle

public <any> handle(ServerWebExchange exchange)

Processes a resource request.

Checks for the existence of the requested resource in the configured list of locations. If the resource does not exist, a 404 response will be returned to the client. If the resource exists, the request will be checked for the presence of the Last-Modified header, and its value will be compared against the last-modified timestamp of the given resource, returning a 304 status code if the Last-Modified value is greater. If the resource is newer than the Last-Modified value, or the header is not present, the content resource of the resource will be written to the response with caching headers set to expire one year in the future.

Specified by:

handle in interface WebHandler

Parameters:

exchange - the current server exchange

Returns:

Mono<Void> to indicate when request handling is complete

getResource

protected <any> getResource(ServerWebExchange exchange)

processPath

protected java.lang.String processPath(java.lang.String path)

Process the given resource path.

The default implementation replaces:

• Backslash with forward slash.
• Duplicate occurrences of slash with a single slash.
• Any combination of leading slash and control characters (00-1F and 7F) with a single "/" or "". For example " / // foo/bar" becomes "/foo/bar".

Since:

3.2.12

cleanDuplicateSlashes

private java.lang.String cleanDuplicateSlashes(java.lang.String path)

cleanLeadingSlash

private java.lang.String cleanLeadingSlash(java.lang.String path)

isInvalidEncodedPath

private boolean isInvalidEncodedPath(java.lang.String path)

Check whether the given path contains invalid escape sequences.

Parameters:

path - the path to validate

Returns:

true if the path is invalid, false otherwise

isInvalidPath

protected boolean isInvalidPath(java.lang.String path)

Identifies invalid resource paths. By default rejects:

• Paths that contain "WEB-INF" or "META-INF"
• Paths that contain "../" after a call to StringUtils.cleanPath(java.lang.String).
• Paths that represent a valid URL or would represent one after the leading slash is removed.

Note: this method assumes that leading, duplicate '/' or control characters (e.g. white space) have been trimmed so that the path starts predictably with a single '/' or does not have one.

Parameters:

path - the path to validate

Returns:

true if the path is invalid, false otherwise

setHeaders

protected void setHeaders(ServerWebExchange exchange,
                          Resource resource,
                          @Nullable
                          MediaType mediaType)
                   throws java.io.IOException

Set headers on the response. Called for both GET and HEAD requests.

Parameters:

exchange - current exchange

resource - the identified resource (never null)

mediaType - the resource's media type (never null)

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

formatLocations

private java.lang.Object formatLocations()