org.springframework.cloud.aws.core.io.s3

Class PathMatchingSimpleStorageResourcePatternResolver

java.lang.Object

org.springframework.cloud.aws.core.io.s3.PathMatchingSimpleStorageResourcePatternResolver

All Implemented Interfaces:

org.springframework.core.io.ResourceLoader, org.springframework.core.io.support.ResourcePatternResolver

public class PathMatchingSimpleStorageResourcePatternResolver
extends Object
implements org.springframework.core.io.support.ResourcePatternResolver

A ResourcePatternResolver implementation which allows an ant-style path matching when loading S3 resources. Ant wildcards (*, ** and ?) are allowed in both, bucket name and object name.

WARNING: Be aware that when you are using wildcards in the bucket name it can take a very long time to parse all files. Moreover this implementation does not return truncated results. This means that when handling huge buckets it could lead to serious performance problems. For more information look at the findProgressivelyWithPartialMatch method.

Since:

1.0

Author:

Alain Sahli, Agim Emruli

Field Summary

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

CLASSPATH_ALL_URL_PREFIX

Fields inherited from interface org.springframework.core.io.ResourceLoader

CLASSPATH_URL_PREFIX

Constructor Summary

Constructors

Constructor and Description

PathMatchingSimpleStorageResourcePatternResolver(com.amazonaws.services.s3.AmazonS3 amazonS3, org.springframework.core.io.ResourceLoader simpleStorageResourceLoader, org.springframework.core.io.support.ResourcePatternResolver resourcePatternResolverDelegate) Construct a new instance of the PathMatchingSimpleStorageResourcePatternResolver with a SimpleStorageResourceLoader to load AmazonS3 instances, and also a delegate ResourcePatternResolver to resolve resource on default path (like file and classpath)

Method Summary

Modifier and Type	Method and Description
protected org.springframework.core.io.Resource[]	findPathMatchingResources(String locationPattern)
ClassLoader	getClassLoader()
org.springframework.core.io.Resource	getResource(String location)
org.springframework.core.io.Resource[]	getResources(String locationPattern)
void	setPathMatcher(org.springframework.util.PathMatcher pathMatcher) Set the PathMatcher implementation to use for this resource pattern resolver.

Methods inherited from class java.lang.Object

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

Constructor Detail

PathMatchingSimpleStorageResourcePatternResolver

public PathMatchingSimpleStorageResourcePatternResolver(com.amazonaws.services.s3.AmazonS3 amazonS3,
                                                        org.springframework.core.io.ResourceLoader simpleStorageResourceLoader,
                                                        org.springframework.core.io.support.ResourcePatternResolver resourcePatternResolverDelegate)

Construct a new instance of the PathMatchingSimpleStorageResourcePatternResolver with a SimpleStorageResourceLoader to load AmazonS3 instances, and also a delegate ResourcePatternResolver to resolve resource on default path (like file and classpath)

Parameters:

amazonS3 - - used to retrieve the directory listings

simpleStorageResourceLoader - - used to retrieve object from amazon s3

resourcePatternResolverDelegate - - delegate resolver used to resolve common path (file, classpath, servlet etc.)

Method Detail

setPathMatcher

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

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

Parameters:

pathMatcher - The pathMatches implementation used, must not be null

See Also:

AntPathMatcher

getResources

public org.springframework.core.io.Resource[] getResources(String locationPattern)
                                                    throws IOException

Specified by:

getResources in interface org.springframework.core.io.support.ResourcePatternResolver

Throws:

IOException

findPathMatchingResources

protected org.springframework.core.io.Resource[] findPathMatchingResources(String locationPattern)

getResource

public org.springframework.core.io.Resource getResource(String location)

Specified by:

getResource in interface org.springframework.core.io.ResourceLoader

getClassLoader

public ClassLoader getClassLoader()

Specified by:

getClassLoader in interface org.springframework.core.io.ResourceLoader