net.thevpc.nuts.runtime.standalone.extension

Class DefaultImmutableNClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

net.thevpc.nuts.runtime.standalone.extension.NClassLoaderBase

net.thevpc.nuts.runtime.standalone.extension.DefaultImmutableNClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable, NClassLoader

public class DefaultImmutableNClassLoader
extends NClassLoaderBase
implements NClassLoader

Immutable implementation of NClassLoader backed by the shared leaf registry. Fully resolves its classpath entries at construction time via the base class NClassLoaderBase.build(), after which the instance is frozen and all mutator operations become no-ops.

Note: the workspace extension model's createImmutableClassLoader(...) now prefers to return a DefaultNCompositeClassLoader directly (which doesn't carry the mutable-classloader fields), but this class is kept for any callers that construct it explicitly or rely on its type.

Category:

Internal

Field Summary

Fields inherited from class net.thevpc.nuts.runtime.standalone.extension.NClassLoaderBase

baseEntries, children, dependencyFilter, lastDefinitions, lastResolved, loadedShortNameVersions, pendingEntries, repositoryFilter

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DefaultImmutableNClassLoader(String name, ClassLoader parent, NClasspathEntry[] nodes, NRepositoryFilter repositoryFilter, NDependencyFilter dependencyFilter)

Method Summary

Modifier and Type	Method and Description
NDefinition[]	add(NClasspathEntry... entries)
NDefinition[]	add(NDefinition... defs)
NDefinition[]	add(NDependency... dependencies)
NDefinition[]	add(NId... ids)
boolean	add0(NClasspathEntry entry)
boolean	add0(NDefinition definition)
boolean	add0(NDependency dependency)
boolean	add0(NId id)
void	addURL(URL url)
NDefinition[]	build()
NClassLoader	immutable()
NMutableClassLoader	mutable()
NDefinition[]	rebuild(NDefinition[] desired) Atomically rebuild the mutable composite so only the desired set of NDefinitions (and their resolved entries) remain in the delegation list.
void	remove(NId id) Remove all children that correspond to the given NId from the delegation list.

Methods inherited from class net.thevpc.nuts.runtime.standalone.extension.NClassLoaderBase

addPath0, asClassLoader, baseEntries, buildInternal, contains, definePackage, equals, findResource, findResources, getName, getResource, getResourceAsStream, getResources, getURLs, hashCode, isShortNameVersionAllowed, loadClass, loadClass, loadClassFromChildren, loadedDefinitions, loadResourcesFromChildren, name, search, search, toString

Methods inherited from class java.net.URLClassLoader

close, findClass, getPermissions, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.thevpc.nuts.reflect.NClassLoader

asClassLoader, contains, getName, getParent, getResource, getResourceAsStream, getResources, loadClass, name, of, of, of, of, ofPreferred, ofPreferred, ofPreferred, ofPreferred, search

Constructor Detail

DefaultImmutableNClassLoader

protected DefaultImmutableNClassLoader(String name,
                                       ClassLoader parent,
                                       NClasspathEntry[] nodes,
                                       NRepositoryFilter repositoryFilter,
                                       NDependencyFilter dependencyFilter)

Method Detail

immutable

public NClassLoader immutable()

Specified by:

immutable in interface NClassLoader

mutable

public NMutableClassLoader mutable()

Specified by:

mutable in interface NClassLoader

add

public NDefinition[] add(NDefinition... defs)

Overrides:

add in class NClassLoaderBase

add

public NDefinition[] add(NClasspathEntry... entries)

Overrides:

add in class NClassLoaderBase

add

public NDefinition[] add(NId... ids)

Overrides:

add in class NClassLoaderBase

add

public NDefinition[] add(NDependency... dependencies)

Overrides:

add in class NClassLoaderBase

add0

public boolean add0(NClasspathEntry entry)

Overrides:

add0 in class NClassLoaderBase

add0

public boolean add0(NDefinition definition)

Overrides:

add0 in class NClassLoaderBase

add0

public boolean add0(NId id)

Overrides:

add0 in class NClassLoaderBase

add0

public boolean add0(NDependency dependency)

Overrides:

add0 in class NClassLoaderBase

addURL

public void addURL(URL url)

Overrides:

addURL in class NClassLoaderBase

build

public NDefinition[] build()

Overrides:

build in class NClassLoaderBase

remove

public void remove(NId id)

Description copied from class: NClassLoaderBase

Remove all children that correspond to the given NId from the delegation list. Does NOT remove entries from the VM-static registry (JVM constraints prevent actual unloading).

Overrides:

remove in class NClassLoaderBase

rebuild

public NDefinition[] rebuild(NDefinition[] desired)

Description copied from class: NClassLoaderBase

Atomically rebuild the mutable composite so only the desired set of NDefinitions (and their resolved entries) remain in the delegation list. Dropped jars are no longer consulted for future lookups; loaded Class objects remain valid per JVM constraints.

Overrides:

rebuild in class NClassLoaderBase