org.springframework.core.io.support
Class PathMatchingResourcePatternResolver

java.lang.Object
  org.springframework.core.io.support.PathMatchingResourcePatternResolver

All Implemented Interfaces:

ResourceLoader, ResourcePatternResolver

Direct Known Subclasses:

ServletContextResourcePatternResolver

public class PathMatchingResourcePatternResolver

extends Object

implements ResourcePatternResolver

ResourcePatternResolver implementation that applies Ant-style path matching, using Spring's PathMatcher class.

Locations can either be suitable for ResourceLoader.getResource (URLs like "file:C:/context.xml", pseudo-URLs like "classpath:/context.xml", relative file paths like "/WEB-INF/context.xml"), or Ant-style patterns like "/WEB-INF/*-context.xml".

In the pattern case, the location has to be resolvable to java.io.File or to a "jar:" URL (leading to a java.net.JarURLConnection) to allow for searching though the specified directory tree. In particular, this is not guaranteed to work with a WAR file that is not expanded.

There is special support for retrieving multiple class path resources with the same name, via the "classpath*" prefix. For example, "classpath*:META-INF/beans.xml" will find all beans.xml files in the class path, be it in "classes" directories or in JAR files. This is particularly useful for auto-detecting config files of the same name at the same location within each jar file.

The "classpath*" prefix can also be combined with a PathMatcher pattern, for example "classpath*:META-INF/*-beans.xml". In this case, all matching resources in the class path will be found, even if multiple resources of the same name exist in different jar files. Note that "classpath*:" will only work with at least one root directory before the pattern starts.

Warning: Ant-style patterns with "classpath:" resources are not guaranteed to find matching resources if the root package to search is available in multiple class path locations. Preferably, use "classpath*:" with the same Ant-style pattern in such a case, which will search all class path locations that contain the root package.

If neither given a PathMatcher pattern nor a "classpath*:" location, this resolver will return a single resource via the underlying ResourceLoader.

Since:

1.0.2

Author:

Juergen Hoeller

See Also:

ResourcePatternResolver.CLASSPATH_URL_PREFIX, PathMatcher, ResourceLoader.getResource(java.lang.String)

Field Summary

protected Log

logger

Fields inherited from interface org.springframework.core.io.support.ResourcePatternResolver

CLASSPATH_URL_PREFIX

Constructor Summary

PathMatchingResourcePatternResolver()
Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.

PathMatchingResourcePatternResolver(ClassLoader classLoader)
Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.

PathMatchingResourcePatternResolver(ResourceLoader resourceLoader)
Create a new PathMatchingResourcePatternResolver.

PathMatchingResourcePatternResolver(ResourceLoader resourceLoader, ClassLoader classLoader)
Create a new PathMatchingResourcePatternResolver.

Method Summary

protected String	determineRootDir(String location) Determine the root directory for the given location.
protected List	doFindPathMatchingFileResources(Resource rootDirResource, String subPattern) Find all resources in the file system that match the given location pattern via the Ant-style PathMatcher utility.
protected List	doFindPathMatchingJarResources(Resource rootDirResource, String subPattern) Find all resources in jar files that match the given location pattern via the Ant-style PathMatcher utility.
protected void	doRetrieveMatchingFiles(String fullPattern, File dir, List result) Recursively retrieve files that match the given pattern, adding them to the given result list.
protected Resource[]	findAllClassPathResources(String location) Find all class location resources with the given location via the ClassLoader.
protected Resource[]	findPathMatchingResources(String locationPattern) Find all resources that match the given location pattern via the Ant-style PathMatcher utility.
ClassLoader	getClassLoader() Return the ClassLoader that this pattern resolver works with, or null if using the thread context class loader on actual access (applying to the thread that does the "getResources" call).
Resource	getResource(String location) Return a Resource handle for the specified resource.
ResourceLoader	getResourceLoader() Return the ResourceLoader that this pattern resolver works with.
Resource[]	getResources(String locationPattern) Resolve the given location pattern into Resource objects.
protected List	retrieveMatchingFiles(File rootDir, String pattern) Retrieve files that match the given path pattern, checking the given directory and its subdirectories.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final Log logger

Constructor Detail

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver()

Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.

ClassLoader access will happen via the thread context class loader on actual access (applying to the thread that does the "getResources" call)

See Also:

DefaultResourceLoader

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver(ClassLoader classLoader)

Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.

Parameters:

classLoader - the ClassLoader to load classpath resources with, or null for using the thread context class loader on actual access (applying to the thread that does the "getResources" call)

See Also:

DefaultResourceLoader

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver(ResourceLoader resourceLoader)

Create a new PathMatchingResourcePatternResolver.

ClassLoader access will happen via the thread context class loader on actual access (applying to the thread that does the "getResources" call)

Parameters:

resourceLoader - the ResourceLoader to load root directories and actual resources with

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver(ResourceLoader resourceLoader,
                                           ClassLoader classLoader)

Create a new PathMatchingResourcePatternResolver.

Parameters:

resourceLoader - the ResourceLoader to load root directories and actual resources with

classLoader - the ClassLoader to load classpath resources with, or null for using the thread context class loader on actual access (applying to the thread that does the "getResources" call)

Method Detail

getResourceLoader

public ResourceLoader getResourceLoader()

Return the ResourceLoader that this pattern resolver works with.

getClassLoader

public ClassLoader getClassLoader()

Return the ClassLoader that this pattern resolver works with, or null if using the thread context class loader on actual access (applying to the thread that does the "getResources" call).

getResource

public Resource getResource(String location)

Description copied from interface: ResourceLoader

Return a Resource handle for the specified resource. The handle should always be a reusable resource descriptor, allowing for multiple getInputStream calls.

• Must support fully qualified URLs, e.g. "file:C:/test.dat".
• Must support classpath pseudo-URLs, e.g. "classpath:test.dat".
• Should support relative file paths, e.g. "WEB-INF/test.dat". (This will be implementation-specific, typically provided by an ApplicationContext implementation.)

Note that a Resource handle does not imply an existing resource; you need to invoke Resource's "exists" to check for existence.

Specified by:

getResource in interface ResourceLoader

Parameters:

location - the resource location

Returns:

a corresponding Resource handle

See Also:

ResourceLoader.CLASSPATH_URL_PREFIX, Resource.exists(), InputStreamSource.getInputStream()

getResources

public Resource[] getResources(String locationPattern)
                        throws IOException

Description copied from interface: ResourcePatternResolver

Resolve the given location pattern into Resource objects.

Specified by:

getResources in interface ResourcePatternResolver

Parameters:

locationPattern - the location pattern to resolve

Returns:

the corresponding Resource objects

Throws:

IOException - in case of I/O errors

findAllClassPathResources

protected Resource[] findAllClassPathResources(String location)
                                        throws IOException

Find all class location resources with the given location via the ClassLoader.

Parameters:

location - the absolute path within the classpath

Returns:

the result as Resource array

Throws:

IOException - in case of I/O errors

See Also:

ClassLoader.getResources(java.lang.String)

findPathMatchingResources

protected Resource[] findPathMatchingResources(String locationPattern)
                                        throws IOException

Find all resources that match the given location pattern via the Ant-style PathMatcher utility. Supports resources in jar files and in the file system.

Parameters:

locationPattern - the location pattern to match

Returns:

the result as Resource array

Throws:

IOException - in case of I/O errors

See Also:

doFindPathMatchingJarResources(org.springframework.core.io.Resource, java.lang.String), doFindPathMatchingFileResources(org.springframework.core.io.Resource, java.lang.String), PathMatcher

determineRootDir

protected String determineRootDir(String location)

Determine the root directory for the given location.

Used for determining the starting point for file matching, resolving the root directory location to a java.io.File and passing it into retrieveMatchingFiles, with the remainder of the location as pattern.

Will return "/WEB-INF" for the pattern "/WEB-INF/*.xml", for example.

Parameters:

location - the location to checkn

Returns:

the part of the location that denotes the root directory

See Also:

retrieveMatchingFiles(java.io.File, java.lang.String)

doFindPathMatchingJarResources

protected List doFindPathMatchingJarResources(Resource rootDirResource,
                                              String subPattern)
                                       throws IOException

Find all resources in jar files that match the given location pattern via the Ant-style PathMatcher utility.

Parameters:

rootDirResource - the root directory as Resource

subPattern - the sub pattern to match (below the root directory)

Returns:

the List of matching Resource instances

Throws:

IOException - in case of I/O errors

See Also:

JarURLConnection, PathMatcher

doFindPathMatchingFileResources

protected List doFindPathMatchingFileResources(Resource rootDirResource,
                                               String subPattern)
                                        throws IOException

Find all resources in the file system that match the given location pattern via the Ant-style PathMatcher utility.

Parameters:

rootDirResource - the root directory as Resource

subPattern - the sub pattern to match (below the root directory)

Returns:

the List of matching Resource instances

Throws:

IOException - in case of I/O errors

See Also:

retrieveMatchingFiles(java.io.File, java.lang.String), PathMatcher

retrieveMatchingFiles

protected List retrieveMatchingFiles(File rootDir,
                                     String pattern)
                              throws IOException

Retrieve files that match the given path pattern, checking the given directory and its subdirectories.

Parameters:

rootDir - the directory to start from

pattern - the pattern to match against, relative to the root directory

Returns:

the List of matching File instances

Throws:

IOException - if directory contents could not be retrieved

doRetrieveMatchingFiles

protected void doRetrieveMatchingFiles(String fullPattern,
                                       File dir,
                                       List result)
                                throws IOException

Recursively retrieve files that match the given pattern, adding them to the given result list.

Parameters:

fullPattern - the pattern to match against, with preprended root directory path

dir - the current directory

result - the list of matching files to add to

Throws:

IOException - if directory contents could not be retrieved