org.frameworkset.util.io

类 PathMatchingResourcePatternResolver

java.lang.Object

org.frameworkset.util.io.PathMatchingResourcePatternResolver

所有已实现的接口:

ResourceLoader, ResourcePatternResolver

public class PathMatchingResourcePatternResolver
extends java.lang.Object
implements ResourcePatternResolver

Title: PathMatchingResourcePatternResolver.java

Description:

bboss workgroup

Copyright (c) 2007

字段概要

从接口继承的字段 org.frameworkset.util.io.ResourcePatternResolver

CLASSPATH_ALL_URL_PREFIX

从接口继承的字段 org.frameworkset.util.io.ResourceLoader

CLASSPATH_URL_PREFIX

构造器概要

构造器

构造器和说明
PathMatchingResourcePatternResolver() Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.
PathMatchingResourcePatternResolver(java.lang.ClassLoader classLoader) Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.
PathMatchingResourcePatternResolver(ResourceLoader resourceLoader) Create a new PathMatchingResourcePatternResolver.

方法概要

限定符和类型	方法和说明
protected org.frameworkset.util.io.Resource	convertClassLoaderURL(java.net.URL url) Convert the given URL as returned from the ClassLoader into a Resource object.
protected java.lang.String	determineRootDir(java.lang.String location) Determine the root directory for the given location.
protected java.util.Set	doFindMatchingFileSystemResources(java.io.File rootDir, java.lang.String subPattern) Find all resources in the file system that match the given location pattern via the Ant-style PathMatcher.
protected java.util.Set	doFindPathMatchingFileResources(org.frameworkset.util.io.Resource rootDirResource, java.lang.String subPattern) Find all resources in the file system that match the given location pattern via the Ant-style PathMatcher.
protected java.util.Set	doFindPathMatchingJarResources(org.frameworkset.util.io.Resource rootDirResource, java.lang.String subPattern) Find all resources in jar files that match the given location pattern via the Ant-style PathMatcher.
protected void	doRetrieveMatchingFiles(java.lang.String fullPattern, java.io.File dir, java.util.Set result) Recursively retrieve files that match the given pattern, adding them to the given result list.
protected org.frameworkset.util.io.Resource[]	findAllClassPathResources(java.lang.String location) Find all class location resources with the given location via the ClassLoader.
protected org.frameworkset.util.io.Resource[]	findPathMatchingResources(java.lang.String locationPattern) Find all resources that match the given location pattern via the Ant-style PathMatcher.
java.lang.ClassLoader	getClassLoader() Return the ClassLoader that this pattern resolver works with (never null).
protected java.util.jar.JarFile	getJarFile(java.lang.String jarFileUrl) Resolve the given jar file URL into a JarFile object.
org.frameworkset.util.PathMatcher	getPathMatcher() Return the PathMatcher that this resource pattern resolver uses.
org.frameworkset.util.io.Resource	getResource(java.lang.String location) Return a Resource handle for the specified resource.
ResourceLoader	getResourceLoader() Return the ResourceLoader that this pattern resolver works with.
org.frameworkset.util.io.Resource[]	getResources(java.lang.String locationPattern) Resolve the given location pattern into Resource objects.
protected boolean	isJarResource(org.frameworkset.util.io.Resource resource) Return whether the given resource handle indicates a jar resource that the doFindPathMatchingJarResources method can handle.
protected org.frameworkset.util.io.Resource	resolveRootDirResource(org.frameworkset.util.io.Resource original) Resolve the specified resource for path matching.
protected java.util.Set	retrieveMatchingFiles(java.io.File rootDir, java.lang.String pattern) Retrieve files that match the given path pattern, checking the given directory and its subdirectories.
void	setPathMatcher(org.frameworkset.util.PathMatcher pathMatcher) Set the PathMatcher implementation to use for this resource pattern resolver.

从类继承的方法 java.lang.Object

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

构造器详细资料

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver()

Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.

ClassLoader access will happen via the thread context class loader.

另请参阅:

DefaultResourceLoader

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver(java.lang.ClassLoader classLoader)

Create a new PathMatchingResourcePatternResolver with a DefaultResourceLoader.

参数:

classLoader - the ClassLoader to load classpath resources with, or null for using the thread context class loader

另请参阅:

DefaultResourceLoader

PathMatchingResourcePatternResolver

public PathMatchingResourcePatternResolver(ResourceLoader resourceLoader)

Create a new PathMatchingResourcePatternResolver.

ClassLoader access will happen via the thread context class loader.

参数:

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

方法详细资料

getResourceLoader

public ResourceLoader getResourceLoader()

Return the ResourceLoader that this pattern resolver works with.

getClassLoader

public java.lang.ClassLoader getClassLoader()

Return the ClassLoader that this pattern resolver works with (never null).

指定者:

getClassLoader 在接口中 ResourceLoader

返回:

the ClassLoader (never null)

setPathMatcher

public void setPathMatcher(org.frameworkset.util.PathMatcher pathMatcher)

Set the PathMatcher implementation to use for this resource pattern resolver. Default is AntPathMatcher.

另请参阅:

org.frameworkset.web.util.AntPathMatcher

getPathMatcher

public org.frameworkset.util.PathMatcher getPathMatcher()

Return the PathMatcher that this resource pattern resolver uses.

getResource

public org.frameworkset.util.io.Resource getResource(java.lang.String location)

从接口复制的说明: ResourceLoader

Return a Resource handle for the specified resource. The handle should always be a reusable resource descriptor, allowing for multiple InputStreamSource.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.exists() to check for existence.

指定者:

getResource 在接口中 ResourceLoader

参数:

location - the resource location

返回:

a corresponding Resource handle

另请参阅:

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

getResources

public org.frameworkset.util.io.Resource[] getResources(java.lang.String locationPattern)
                                                 throws java.io.IOException

从接口复制的说明: ResourcePatternResolver

Resolve the given location pattern into Resource objects.

Overlapping resource entries that point to the same physical resource should be avoided, as far as possible. The result should have set semantics.

指定者:

getResources 在接口中 ResourcePatternResolver

参数:

locationPattern - the location pattern to resolve

返回:

the corresponding Resource objects

抛出:

java.io.IOException - in case of I/O errors

findAllClassPathResources

protected org.frameworkset.util.io.Resource[] findAllClassPathResources(java.lang.String location)
                                                                 throws java.io.IOException

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

参数:

location - the absolute path within the classpath

返回:

the result as Resource array

抛出:

java.io.IOException - in case of I/O errors

另请参阅:

ClassLoader.getResources(java.lang.String), convertClassLoaderURL(java.net.URL)

convertClassLoaderURL

protected org.frameworkset.util.io.Resource convertClassLoaderURL(java.net.URL url)

Convert the given URL as returned from the ClassLoader into a Resource object.

The default implementation simply creates a UrlResource instance.

参数:

url - a URL as returned from the ClassLoader

返回:

the corresponding Resource object

另请参阅:

ClassLoader.getResources(java.lang.String), Resource

findPathMatchingResources

protected org.frameworkset.util.io.Resource[] findPathMatchingResources(java.lang.String locationPattern)
                                                                 throws java.io.IOException

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

参数:

locationPattern - the location pattern to match

返回:

the result as Resource array

抛出:

java.io.IOException - in case of I/O errors

另请参阅:

doFindPathMatchingJarResources(org.frameworkset.util.io.Resource, java.lang.String), doFindPathMatchingFileResources(org.frameworkset.util.io.Resource, java.lang.String), PathMatcher

determineRootDir

protected java.lang.String determineRootDir(java.lang.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.

参数:

location - the location to check

返回:

the part of the location that denotes the root directory

另请参阅:

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

resolveRootDirResource

protected org.frameworkset.util.io.Resource resolveRootDirResource(org.frameworkset.util.io.Resource original)
                                                            throws java.io.IOException

Resolve the specified resource for path matching.

The default implementation detects an Equinox OSGi "bundleresource:" / "bundleentry:" URL and resolves it into a standard jar file URL that can be traversed using 's standard jar file traversal algorithm.

参数:

original - the resource to resolfe

返回:

the resolved resource (may be identical to the passed-in resource)

抛出:

java.io.IOException - in case of resolution failure

isJarResource

protected boolean isJarResource(org.frameworkset.util.io.Resource resource)
                         throws java.io.IOException

Return whether the given resource handle indicates a jar resource that the doFindPathMatchingJarResources method can handle.

The default implementation checks against the URL protocols "jar", "zip" and "wsjar" (the latter are used by BEA WebLogic Server and IBM WebSphere, respectively, but can be treated like jar files).

参数:

resource - the resource handle to check (usually the root directory to start path matching from)

抛出:

java.io.IOException

另请参阅:

doFindPathMatchingJarResources(org.frameworkset.util.io.Resource, java.lang.String), ResourceUtils.isJarURL(java.net.URL)

doFindPathMatchingJarResources

protected java.util.Set doFindPathMatchingJarResources(org.frameworkset.util.io.Resource rootDirResource,
                                                       java.lang.String subPattern)
                                                throws java.io.IOException

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

参数:

rootDirResource - the root directory as Resource

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

返回:

the Set of matching Resource instances

抛出:

java.io.IOException - in case of I/O errors

另请参阅:

JarURLConnection, PathMatcher

getJarFile

protected java.util.jar.JarFile getJarFile(java.lang.String jarFileUrl)
                                    throws java.io.IOException

Resolve the given jar file URL into a JarFile object.

抛出:

java.io.IOException

doFindPathMatchingFileResources

protected java.util.Set doFindPathMatchingFileResources(org.frameworkset.util.io.Resource rootDirResource,
                                                        java.lang.String subPattern)
                                                 throws java.io.IOException

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

参数:

rootDirResource - the root directory as Resource

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

返回:

the Set of matching Resource instances

抛出:

java.io.IOException - in case of I/O errors

另请参阅:

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

doFindMatchingFileSystemResources

protected java.util.Set doFindMatchingFileSystemResources(java.io.File rootDir,
                                                          java.lang.String subPattern)
                                                   throws java.io.IOException

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

参数:

rootDir - the root directory in the file system

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

返回:

the Set of matching Resource instances

抛出:

java.io.IOException - in case of I/O errors

另请参阅:

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

retrieveMatchingFiles

protected java.util.Set retrieveMatchingFiles(java.io.File rootDir,
                                              java.lang.String pattern)
                                       throws java.io.IOException

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

参数:

rootDir - the directory to start from

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

返回:

the Set of matching File instances

抛出:

java.io.IOException - if directory contents could not be retrieved

doRetrieveMatchingFiles

protected void doRetrieveMatchingFiles(java.lang.String fullPattern,
                                       java.io.File dir,
                                       java.util.Set result)
                                throws java.io.IOException

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

参数:

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

dir - the current directory

result - the Set of matching File instances to add to

抛出:

java.io.IOException - if directory contents could not be retrieved