org.apache.logging.log4j.core.config.plugins.util

Class ResolverUtil

java.lang.Object

org.apache.logging.log4j.core.config.plugins.util.ResolverUtil

public class ResolverUtil
extends Object

Modified from log4j 2.0.2 ResolverUtil to add support for the bundle: protocol which is used by felix.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ResolverUtil.Test A simple interface that specifies how to test classes to determine if they are to be included in the results produced by the ResolverUtil.

Constructor Summary

Constructors

Constructor and Description
ResolverUtil()

Method Summary

Modifier and Type	Method and Description
protected void	addIfMatching(ResolverUtil.Test test, String fqn) 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.
void	find(ResolverUtil.Test test, String... packageNames) Attempts to discover classes that pass the test.
void	findInPackage(ResolverUtil.Test test, String packageName) Scans for classes starting at the package provided and descending into subpackages.
Set<Class<?>>	getClasses() Provides access to the classes discovered so far.
ClassLoader	getClassLoader() Returns the classloader that will be used for scanning for classes.
Set<URI>	getResources() Returns the matching resources.
void	setClassLoader(ClassLoader classloader) Sets an explicit ClassLoader that should be used when scanning for classes.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResolverUtil

public ResolverUtil()

Method Detail

getClasses

public Set<Class<?>> getClasses()

Provides access to the classes discovered so far. If no calls have been made to any of the find() methods, this set will be empty.

Returns:

the set of classes that have been discovered.

getResources

public Set<URI> getResources()

Returns the matching resources.

Returns:

A Set of URIs that match the criteria.

getClassLoader

public ClassLoader getClassLoader()

Returns the classloader that will be used for scanning for classes. If no explicit ClassLoader has been set by the calling, the context class loader will be used.

Returns:

the ClassLoader that will be used to scan for classes

setClassLoader

public void setClassLoader(ClassLoader classloader)

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

Parameters:

classloader - a ClassLoader to use when scanning for classes

find

public void find(ResolverUtil.Test test,
                 String... packageNames)

Attempts to discover classes that pass the test. Accumulated classes can be accessed by calling getClasses().

Parameters:

test - the test to determine matching classes

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

findInPackage

public void findInPackage(ResolverUtil.Test test,
                          String packageName)

Scans for classes starting at the package provided and descending into subpackages. Each class is offered up to the Test as it is discovered, and if the Test returns true the class is retained. Accumulated classes can be fetched by calling getClasses().

Parameters:

test - an instance of ResolverUtil.Test that will be used to filter classes

packageName - the name of the package from which to start scanning for classes, e.g. net.sourceforge.stripes

addIfMatching

protected void addIfMatching(ResolverUtil.Test test,
                             String fqn)

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