org.apache.camel.impl
Class DefaultPackageScanClassResolver

java.lang.Object
  org.apache.camel.impl.ServiceSupport
      org.apache.camel.impl.DefaultPackageScanClassResolver

All Implemented Interfaces:

Service, ShutdownableService, PackageScanClassResolver

Direct Known Subclasses:

WebSpherePackageScanClassResolver

public class DefaultPackageScanClassResolver
extends ServiceSupport
implements PackageScanClassResolver

Default implement of PackageScanClassResolver

Field Summary

protected org.slf4j.Logger

log

Constructor Summary

DefaultPackageScanClassResolver()

Method Summary

void	addClassLoader(java.lang.ClassLoader classLoader) Adds the class loader to the existing loaders
void	addFilter(PackageScanFilter filter) Add a filter that will be applied to all scan operations
protected void	addIfMatching(PackageScanFilter test, java.lang.String fqn, java.util.Set<java.lang.Class<?>> classes) Add the class designated by the fully qualified class name provided to the set of resolved classes if and only if it is approved by the Test supplied.
protected java.net.URL	customResourceLocator(java.net.URL url)
protected void	doStart()
protected void	doStop()
protected void	find(PackageScanFilter test, java.lang.String packageName, java.lang.ClassLoader loader, java.util.Set<java.lang.Class<?>> classes)
protected void	find(PackageScanFilter test, java.lang.String packageName, java.util.Set<java.lang.Class<?>> classes)
java.util.Set<java.lang.Class<?>>	findAnnotated(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.String... packageNames) Attempts to discover classes that are annotated with to the annotation.
java.util.Set<java.lang.Class<?>>	findAnnotated(java.util.Set<java.lang.Class<? extends java.lang.annotation.Annotation>> annotations, java.lang.String... packageNames) Attempts to discover classes that are annotated with to the annotation.
java.util.Set<java.lang.Class<?>>	findByFilter(PackageScanFilter filter, java.lang.String... packageNames) Attempts to discover classes filter by the provided filter
java.util.Set<java.lang.Class<?>>	findImplementations(java.lang.Class parent, java.lang.String... packageNames) Attempts to discover classes that are assignable to the type provided.
java.util.Set<java.lang.ClassLoader>	getClassLoaders() Gets the ClassLoader instances that should be used when scanning for classes.
protected java.util.Enumeration<java.net.URL>	getResources(java.lang.ClassLoader loader, java.lang.String packageName) Strategy to get the resources by the given classloader.
boolean	isAcceptableScheme(java.lang.String urlPath)
void	removeFilter(PackageScanFilter filter) Removes the filter
void	setAcceptableSchemes(java.lang.String schemes)
void	setClassLoaders(java.util.Set<java.lang.ClassLoader> classLoaders) Sets the ClassLoader instances that should be used when scanning for classes.

Methods inherited from class org.apache.camel.impl.ServiceSupport

addChildService, doResume, doShutdown, doSuspend, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isSuspended, isSuspending, removeChildService, resume, shutdown, start, start, stop, suspend

Methods inherited from class java.lang.Object

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

Field Detail

log

protected final transient org.slf4j.Logger log

Constructor Detail

DefaultPackageScanClassResolver

public DefaultPackageScanClassResolver()

Method Detail

addClassLoader

public void addClassLoader(java.lang.ClassLoader classLoader)

Description copied from interface: PackageScanClassResolver

Adds the class loader to the existing loaders

Specified by:

addClassLoader in interface PackageScanClassResolver

Parameters:

classLoader - the loader to add

addFilter

public void addFilter(PackageScanFilter filter)

Description copied from interface: PackageScanClassResolver

Add a filter that will be applied to all scan operations

Specified by:

addFilter in interface PackageScanClassResolver

Parameters:

filter - filter to filter desired classes in all scan operations

removeFilter

public void removeFilter(PackageScanFilter filter)

Description copied from interface: PackageScanClassResolver

Removes the filter

Specified by:

removeFilter in interface PackageScanClassResolver

Parameters:

filter - filter to filter desired classes in all scan operations

setAcceptableSchemes

public void setAcceptableSchemes(java.lang.String schemes)

isAcceptableScheme

public boolean isAcceptableScheme(java.lang.String urlPath)

getClassLoaders

public java.util.Set<java.lang.ClassLoader> getClassLoaders()

Description copied from interface: PackageScanClassResolver

Gets the ClassLoader instances that should be used when scanning for classes.

This implementation will return a new unmodifiable set containing the classloaders. Use the PackageScanClassResolver.addClassLoader(ClassLoader) method if you want to add new classloaders to the class loaders list.

Specified by:

getClassLoaders in interface PackageScanClassResolver

Returns:

the class loaders to use

setClassLoaders

public void setClassLoaders(java.util.Set<java.lang.ClassLoader> classLoaders)

Description copied from interface: PackageScanClassResolver

Sets the ClassLoader instances that should be used when scanning for classes. If none is set then the context classloader will be used.

Specified by:

setClassLoaders in interface PackageScanClassResolver

Parameters:

classLoaders - loaders to use when scanning for classes

findAnnotated

public java.util.Set<java.lang.Class<?>> findAnnotated(java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                       java.lang.String... packageNames)

Description copied from interface: PackageScanClassResolver

Attempts to discover classes that are annotated with to the annotation.

Specified by:

findAnnotated in interface PackageScanClassResolver

Parameters:

annotation - the annotation that should be present on matching classes

packageNames - one or more package names to scan (including subpackages) for classes

Returns:

the classes found, returns an empty set if none found

findAnnotated

public java.util.Set<java.lang.Class<?>> findAnnotated(java.util.Set<java.lang.Class<? extends java.lang.annotation.Annotation>> annotations,
                                                       java.lang.String... packageNames)

Description copied from interface: PackageScanClassResolver

Attempts to discover classes that are annotated with to the annotation.

Specified by:

findAnnotated in interface PackageScanClassResolver

Parameters:

annotations - the annotations that should be present (any of them) on matching classes

packageNames - one or more package names to scan (including subpackages) for classes

Returns:

the classes found, returns an empty set if none found

findImplementations

public java.util.Set<java.lang.Class<?>> findImplementations(java.lang.Class parent,
                                                             java.lang.String... packageNames)

Description copied from interface: PackageScanClassResolver

Attempts to discover classes that are assignable to the type provided. In the case that an interface is provided this method will collect implementations. In the case of a non-interface class, subclasses will be collected.

Specified by:

findImplementations in interface PackageScanClassResolver

Parameters:

parent - the class of interface to find subclasses or implementations of

packageNames - one or more package names to scan (including subpackages) for classes

Returns:

the classes found, returns an empty set if none found

findByFilter

public java.util.Set<java.lang.Class<?>> findByFilter(PackageScanFilter filter,
                                                      java.lang.String... packageNames)

Description copied from interface: PackageScanClassResolver

Attempts to discover classes filter by the provided filter

Specified by:

findByFilter in interface PackageScanClassResolver

Parameters:

filter - filter to filter desired classes.

packageNames - one or more package names to scan (including subpackages) for classes

Returns:

the classes found, returns an empty set if none found

find

protected void find(PackageScanFilter test,
                    java.lang.String packageName,
                    java.util.Set<java.lang.Class<?>> classes)

find

protected void find(PackageScanFilter test,
                    java.lang.String packageName,
                    java.lang.ClassLoader loader,
                    java.util.Set<java.lang.Class<?>> classes)

customResourceLocator

protected java.net.URL customResourceLocator(java.net.URL url)
                                      throws java.io.IOException

Throws:

java.io.IOException

getResources

protected java.util.Enumeration<java.net.URL> getResources(java.lang.ClassLoader loader,
                                                           java.lang.String packageName)
                                                    throws java.io.IOException

Strategy to get the resources by the given classloader.

Notice that in WebSphere platforms there is a WebSpherePackageScanClassResolver to take care of WebSphere's oddity of resource loading.

Parameters:

loader - the classloader

packageName - the packagename for the package to load

Returns:

URL's for the given package

Throws:

java.io.IOException - is thrown by the classloader

addIfMatching

protected void addIfMatching(PackageScanFilter test,
                             java.lang.String fqn,
                             java.util.Set<java.lang.Class<?>> classes)

Add the class designated by the fully qualified class name provided to the set of resolved classes if and only if it is approved by the Test supplied.

Parameters:

test - the test used to determine if the class matches

fqn - the fully qualified name of a class

doStart

protected void doStart()
                throws java.lang.Exception

Specified by:

doStart in class ServiceSupport

Throws:

java.lang.Exception

doStop

protected void doStop()
               throws java.lang.Exception

Specified by:

doStop in class ServiceSupport

Throws:

java.lang.Exception