org.springframework.web.servlet.config.annotation

Class ResourceHandlerRegistration

java.lang.Object

org.springframework.web.servlet.config.annotation.ResourceHandlerRegistration

public class ResourceHandlerRegistration
extends Object

Encapsulates information required to create a resource handlers.

Since:

3.1

Author:

Rossen Stoyanchev, Keith Donald

Constructor Summary

Constructors

Constructor and Description
ResourceHandlerRegistration(org.springframework.core.io.ResourceLoader resourceLoader, String... pathPatterns) Create a ResourceHandlerRegistration instance.

Method Summary

Modifier and Type	Method and Description
ResourceHandlerRegistration	addResourceLocations(String... resourceLocations) Add one or more resource locations from which to serve static content.
protected String[]	getPathPatterns() Returns the URL path patterns for the resource handler.
protected ResourceHttpRequestHandler	getRequestHandler() Returns a ResourceHttpRequestHandler instance.
protected List<ResourceResolver>	getResourceResolvers()
protected List<ResourceTransformer>	getResourceTransformers()
ResourceHandlerRegistration	setCachePeriod(Integer cachePeriod) Specify the cache period for the resources served by the resource handler, in seconds.
ResourceHandlerRegistration	setResourceResolvers(ResourceResolver... resourceResolvers) Configure the list of ResourceResolvers to use.
ResourceHandlerRegistration	setResourceTransformers(ResourceTransformer... transformers) Configure the list of ResourceTransformers to use.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceHandlerRegistration

public ResourceHandlerRegistration(org.springframework.core.io.ResourceLoader resourceLoader,
                                   String... pathPatterns)

Create a ResourceHandlerRegistration instance.

Parameters:

resourceLoader - a resource loader for turning a String location into a Resource

pathPatterns - one or more resource URL path patterns

Method Detail

addResourceLocations

public ResourceHandlerRegistration addResourceLocations(String... resourceLocations)

Add one or more resource locations from which to serve static content. Each location must point to a valid directory. Multiple locations may be specified as a comma-separated list, and the locations will be checked for a given resource in the order specified.

For example, {"/", "classpath:/META-INF/public-web-resources/"} allows resources to be served both from the web application root and from any JAR on the classpath that contains a /META-INF/public-web-resources/ directory, with resources in the web application root taking precedence.

Returns:

the same ResourceHandlerRegistration instance for chained method invocation

setResourceResolvers

public ResourceHandlerRegistration setResourceResolvers(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.

Since:

4.1

setResourceTransformers

public ResourceHandlerRegistration setResourceTransformers(ResourceTransformer... transformers)

Configure the list of ResourceTransformers to use.

By default no transformers are configured.

Since:

4.1

setCachePeriod

public ResourceHandlerRegistration setCachePeriod(Integer cachePeriod)

Specify the cache period for the resources served by the resource handler, in seconds. The default is to not send any cache headers but to rely on last-modified timestamps only. Set to 0 in order to send cache headers that prevent caching, or to a positive number of seconds to send cache headers with the given max-age value.

Parameters:

cachePeriod - the time to cache resources in seconds

Returns:

the same ResourceHandlerRegistration instance for chained method invocation

getPathPatterns

protected String[] getPathPatterns()

Returns the URL path patterns for the resource handler.

getResourceResolvers

protected List<ResourceResolver> getResourceResolvers()

getResourceTransformers

protected List<ResourceTransformer> getResourceTransformers()

getRequestHandler

protected ResourceHttpRequestHandler getRequestHandler()

Returns a ResourceHttpRequestHandler instance.