Class ClassWorld

java.lang.Object

org.codehaus.plexus.classworlds.ClassWorld

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

ClassWorldReverseAdapter

public class ClassWorld
extends Object
implements Closeable

A collection of ClassRealms, indexed by id.

Author:

bob mcwhirter

Constructor Summary

Constructors

Constructor	Description
ClassWorld()
ClassWorld(String realmId, ClassLoader classLoader)

Method Summary

Modifier and Type	Method	Description
void	addListener(ClassWorldListener listener)
void	close()	Closes all contained class realms.
void	disposeRealm(String id)
ClassRealm	getClassRealm(String id)
ClassRealm	getRealm(String id)
Collection<ClassRealm>	getRealms()
ClassRealm	newRealm(String id)
ClassRealm	newRealm(String id, ClassLoader classLoader)
ClassRealm	newRealm(String id, ClassLoader classLoader, Predicate<String> filter)	Adds a class realm with filtering.
void	removeListener(ClassWorldListener listener)

Methods inherited from class java.lang.Object

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

Constructor Details

ClassWorld

public ClassWorld(String realmId,
 ClassLoader classLoader)

ClassWorld

public ClassWorld()

Method Details

newRealm

public ClassRealm newRealm(String id)
                    throws DuplicateRealmException

Throws:

DuplicateRealmException

newRealm

public ClassRealm newRealm(String id,
 ClassLoader classLoader)
                    throws DuplicateRealmException

Throws:

DuplicateRealmException

newRealm

public ClassRealm newRealm(String id,
 ClassLoader classLoader,
 Predicate<String> filter)
                    throws DuplicateRealmException

Adds a class realm with filtering. Only resources/classes whose name matches a given predicate are exposed.

Parameters:

id - The identifier for this realm, must not be null.

classLoader - The base class loader for this realm, may be null to use the bootstrap class loader.

filter - a predicate to apply to each resource name to determine if it should be loaded through this class loader

Returns:

the created class realm

Throws:

DuplicateRealmException - in case a realm with the given id does already exist

Since:

2.7.0

See Also:

• FilteredClassRealm

close

public void close()
           throws IOException

Closes all contained class realms.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

Since:

2.7.0

disposeRealm

public void disposeRealm(String id)
                  throws NoSuchRealmException

Throws:

NoSuchRealmException

getRealm

public ClassRealm getRealm(String id)
                    throws NoSuchRealmException

Throws:

NoSuchRealmException

getRealms

public Collection<ClassRealm> getRealms()

getClassRealm

public ClassRealm getClassRealm(String id)

addListener

public void addListener(ClassWorldListener listener)

removeListener

public void removeListener(ClassWorldListener listener)