info.magnolia.cms.util
Class ClasspathResourcesUtil

java.lang.Object
  info.magnolia.cms.util.ClasspathResourcesUtil

public class ClasspathResourcesUtil
extends Object

Util to find resources in the classpath (WEB-INF/lib and WEB-INF/classes).

Version:

$Revision$ ($Author$)

Author:

Philipp Bracher, Fabrizio Giustina

Nested Class Summary

static interface	ClasspathResourcesUtil.Filter Filter for filtering the resources.
static class	ClasspathResourcesUtil.PatternFilter A filter using a regex pattern.

Constructor Summary

ClasspathResourcesUtil()

Method Summary

protected static void	collectFromClasspathString(Collection<String> resources, String classpath, ClasspathResourcesUtil.Filter filter)
protected static void	collectFromFileSystem(ClasspathResourcesUtil.Filter filter, Collection<String> resources)
protected static void	collectFromURLs(Collection<String> resources, URL[] urls, ClasspathResourcesUtil.Filter filter)
static String[]	findResources(ClasspathResourcesUtil.Filter filter) Return a collection containing the resource names which passed the filter.
static String[]	findResources(String regex) Return a collection containing the resource names which match the regular expression.
static URL	getResource(String name) Get the resource using the current class loader.
static InputStream	getStream(String name)
static InputStream	getStream(String name, boolean cache) Checks last modified and returns the new content if changed and the cache flag is not set to true.
static File	sanitizeToFile(URL url)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClasspathResourcesUtil

public ClasspathResourcesUtil()

Method Detail

findResources

public static String[] findResources(String regex)

Return a collection containing the resource names which match the regular expression.

Returns:

string array of found resources TODO : (lazy) cache ?

findResources

public static String[] findResources(ClasspathResourcesUtil.Filter filter)

Return a collection containing the resource names which passed the filter.

Parameters:

filter -

Returns:

string array of found resources TODO : (lazy) cache ?

collectFromURLs

protected static void collectFromURLs(Collection<String> resources,
                                      URL[] urls,
                                      ClasspathResourcesUtil.Filter filter)

collectFromClasspathString

protected static void collectFromClasspathString(Collection<String> resources,
                                                 String classpath,
                                                 ClasspathResourcesUtil.Filter filter)

collectFromFileSystem

protected static void collectFromFileSystem(ClasspathResourcesUtil.Filter filter,
                                            Collection<String> resources)

sanitizeToFile

public static File sanitizeToFile(URL url)

getStream

public static InputStream getStream(String name)
                             throws IOException

Throws:

IOException

getStream

public static InputStream getStream(String name,
                                    boolean cache)
                             throws IOException

Checks last modified and returns the new content if changed and the cache flag is not set to true.

Parameters:

name -

Returns:

the input stream

Throws:

IOException

getResource

public static URL getResource(String name)

Get the resource using the current class loader. The leading / is removed as the call to class.getResource() would do.

Parameters:

name -

Returns:

the resource