Class PackageNamesScanner

java.lang.Object

org.glassfish.jersey.server.internal.AbstractResourceFinderAdapter

org.glassfish.jersey.server.internal.scanning.PackageNamesScanner

All Implemented Interfaces:

AutoCloseable, Iterator<String>, ResourceFinder

public final class PackageNamesScanner
extends AbstractResourceFinderAdapter

A scanner that recursively scans URI-based resources present in a set of package names, and nested package names of that set. (Recursive scanning of nested packages can be disabled using a proper constructor.)

The URIs for a package name are obtained, by default, by invoking ClassLoader.getResources(java.lang.String) with the parameter that is the package name with "." replaced by "/".

Each URI is then scanned using a registered UriSchemeResourceFinderFactory that supports the URI scheme.

The following are registered by default. The FileSchemeResourceFinderFactory for "file" URI schemes. The JarZipSchemeResourceFinderFactory for "jar" or "zip" URI schemes to jar resources. The VfsSchemeResourceFinderFactory for the JBoss-based "vfsfile" and "vfszip" URI schemes.

Further schemes may be registered by registering an implementation of UriSchemeResourceFinderFactory in the META-INF/services file whose name is the the fully qualified class name of UriSchemeResourceFinderFactory.

If a URI scheme is not supported a ResourceFinderException will be thrown and package scanning deployment will fail.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PackageNamesScanner.ResourcesProvider	Find resources with a given name and class loader.

Field Summary

Fields

Modifier and Type	Field	Description
private final ClassLoader	classloader
private CompositeResourceFinder	compositeResourceFinder
private final Map<String, UriSchemeResourceFinderFactory>	finderFactories
private final String[]	packages
private final boolean	recursive

Constructor Summary

Constructors

Constructor	Description
PackageNamesScanner(ClassLoader classLoader, String[] packages, boolean recursive)	Scan a set of packages using the provided ClassLoader.
PackageNamesScanner(String[] packages, boolean recursive)	Scan a set of packages using a context ClassLoader.

Method Summary

Modifier and Type	Method	Description
private void	add(UriSchemeResourceFinderFactory uriSchemeResourceFinderFactory)
private void	addResourceFinder(URI u)
void	close()	Default implementation of #close() which does nothing.
boolean	hasNext()
private void	init()
String	next()
InputStream	open()	Open current resource.
void	reset()	Reset the ResourceFinder instance.
static void	setResourcesProvider(PackageNamesScanner.ResourcesProvider provider)	Set the PackageNamesScanner.ResourcesProvider implementation to find resources.
private String	toExternalForm(URL u)
private URI	toURI(URL url)

Methods inherited from class AbstractResourceFinderAdapter

remove

Methods inherited from class Object

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

Methods inherited from interface Iterator

forEachRemaining

Field Details

recursive

private final boolean recursive

packages

private final String[] packages

classloader

private final ClassLoader classloader

finderFactories

private final Map<String, UriSchemeResourceFinderFactory> finderFactories

compositeResourceFinder

private CompositeResourceFinder compositeResourceFinder

Constructor Details

PackageNamesScanner

public PackageNamesScanner(String[] packages,
 boolean recursive)

Scan a set of packages using a context ClassLoader. The recursive flag determines whether the packages will be scanned recursively together with their nested packages (true) or if only the specified packages shall be scanned (false).

Parameters:

packages - an array of package names.

recursive - if (true the packages will be scanned recursively together with any nested packages, if false only the explicitly listed packages will be scanned.

PackageNamesScanner

public PackageNamesScanner(ClassLoader classLoader,
 String[] packages,
 boolean recursive)

Scan a set of packages using the provided ClassLoader. The recursive flag determines whether the packages will be scanned recursively together with their nested packages (true) or if only the specified packages shall be scanned (false).

Parameters:

classLoader - the ClassLoader to load classes from.

packages - an array of package names.

recursive - if (true the packages will be scanned recursively together with any nested packages, if false only the explicitly listed packages will be scanned.

Method Details

add

private void add(UriSchemeResourceFinderFactory uriSchemeResourceFinderFactory)

hasNext

public boolean hasNext()

next

public String next()

open

public InputStream open()

Description copied from interface: ResourceFinder

Open current resource.

Returns:

input stream from which current resource can be loaded.

close

public void close()

Description copied from class: AbstractResourceFinderAdapter

Default implementation of #close() which does nothing.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface ResourceFinder

Overrides:

close in class AbstractResourceFinderAdapter

reset

public void reset()

Description copied from interface: ResourceFinder

Reset the ResourceFinder instance.

Upon calling this method the implementing class MUST reset its internal state to the initial state.

init

private void init()

setResourcesProvider

public static void setResourcesProvider(PackageNamesScanner.ResourcesProvider provider)
                                 throws SecurityException

Set the PackageNamesScanner.ResourcesProvider implementation to find resources.

This method should be invoked before any package scanning is performed otherwise the functionality method will be utilized.

Parameters:

provider - the resources provider.

Throws:

SecurityException - if the resources provider cannot be set.

addResourceFinder

private void addResourceFinder(URI u)

toURI

private URI toURI(URL url)
           throws URISyntaxException

Throws:

URISyntaxException

toExternalForm

private String toExternalForm(URL u)