net.thevpc.nuts.runtime.standalone.extension

Class NClassLoaderBase

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

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

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

DefaultImmutableNClassLoader, DefaultNMutableClassLoader

public abstract class NClassLoaderBase
extends URLClassLoader

Base mutable classloader shared by DefaultNMutableClassLoader and legacy DefaultImmutableNClassLoader.

Internally behaves as a mutable composite of NClassLoader children (typically VM-shared DefaultNLeafClassLoader instances obtained via NIdClassLoaderRegistry). The class still extends URLClassLoader for backwards compatibility (so callers that cast to URLClassLoader and collect getURLs() still work); however, URLs are never actually added to the underlying URLClassLoader — they are owned by the children. getURLs() is overridden to aggregate from children.

Category:

Internal

Field Summary

Fields

Modifier and Type	Field and Description
protected List<NClasspathEntry>	baseEntries
protected List<NClassLoader>	children Ordered list of child classloaders used for delegation.
protected NDependencyFilter	dependencyFilter
protected Map<String,NDefinition>	lastDefinitions
protected List<NClasspathEntry>	lastResolved
protected Map<String,NVersion>	loadedShortNameVersions Tracks which (shortName → version) have already been loaded in this mutable composite.
protected List<NClasspathEntry>	pendingEntries
protected NRepositoryFilter	repositoryFilter

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
NDefinition[]	add(NClasspathEntry... entries)
NDefinition[]	add(NDefinition... defs)
NDefinition[]	add(NDependency... defs)
NDefinition[]	add(NId... defs)
boolean	add0(NClasspathEntry entry)
boolean	add0(NDefinition definition)
boolean	add0(NDependency id)
boolean	add0(NId id)
protected void	addPath0(NPath path)
void	addURL(URL url)
ClassLoader	asClassLoader()
List<NClasspathEntry>	baseEntries()
NDefinition[]	build()
protected NDefinition[]	buildInternal() Resolve pending entries via NClasspathBuilder, create or retrieve shared leaves via NIdClassLoaderRegistry, and add them to this mutable composite's children list.
boolean	contains(NId node)
protected Package	definePackage(String name, Manifest man, URL url)
boolean	equals(Object o)
URL	findResource(String name)
Enumeration<URL>	findResources(String name)
String	getName()
URL	getResource(String name)
InputStream	getResourceAsStream(String name)
Enumeration<URL>	getResources(String name)
URL[]	getURLs()
int	hashCode()
boolean	isShortNameVersionAllowed(NId candidateId)
Class<?>	loadClass(String name)
protected Class<?>	loadClass(String name, boolean resolve)
Class<?>	loadClassFromChildren(ClassLoader requester, String name)
List<NDefinition>	loadedDefinitions()
List<URL>	loadResourcesFromChildren(ClassLoader requester, String name)
String	name()
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.
NOptional<NId>	search(NId id)
static NOptional<NId>	search(NId id, ClassLoader classLoader, boolean delegateSearch)
String	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

Field Detail

baseEntries

protected final List<NClasspathEntry> baseEntries

pendingEntries

protected final List<NClasspathEntry> pendingEntries

lastResolved

protected final List<NClasspathEntry> lastResolved

lastDefinitions

protected final Map<String,NDefinition> lastDefinitions

repositoryFilter

protected NRepositoryFilter repositoryFilter

dependencyFilter

protected NDependencyFilter dependencyFilter

children

protected final List<NClassLoader> children

Ordered list of child classloaders used for delegation. Populated by build() from pendingEntries using the registry.

loadedShortNameVersions

protected final Map<String,NVersion> loadedShortNameVersions

Tracks which (shortName → version) have already been loaded in this mutable composite. Used to detect version conflicts and warn the user when a different version for the same shortName is requested (we keep the first-loaded version to respect JVM class identity guarantees).

Constructor Detail

NClassLoaderBase

protected NClassLoaderBase(String name,
                           ClassLoader parent,
                           NClasspathEntry[] entries,
                           NRepositoryFilter repositoryFilter,
                           NDependencyFilter dependencyFilter)

Method Detail

baseEntries

public List<NClasspathEntry> baseEntries()

loadedDefinitions

public List<NDefinition> loadedDefinitions()

contains

public boolean contains(NId node)

search

public static NOptional<NId> search(NId id,
                                    ClassLoader classLoader,
                                    boolean delegateSearch)

asClassLoader

public ClassLoader asClassLoader()

name

public String name()

getName

public String getName()

search

public NOptional<NId> search(NId id)

add

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

add

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

add

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

add

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

add0

public boolean add0(NClasspathEntry entry)

add0

public boolean add0(NDefinition definition)

add0

public boolean add0(NId id)

add0

public boolean add0(NDependency id)

addURL

public void addURL(URL url)

Overrides:

addURL in class URLClassLoader

addPath0

protected void addPath0(NPath path)

toString

public String toString()

Overrides:

toString in class Object

getResourceAsStream

public InputStream getResourceAsStream(String name)

Overrides:

getResourceAsStream in class URLClassLoader

getURLs

public URL[] getURLs()

Overrides:

getURLs in class URLClassLoader

definePackage

protected Package definePackage(String name,
                                Manifest man,
                                URL url)

Overrides:

definePackage in class URLClassLoader

findResource

public URL findResource(String name)

Overrides:

findResource in class URLClassLoader

findResources

public Enumeration<URL> findResources(String name)
                               throws IOException

Overrides:

findResources in class URLClassLoader

Throws:

IOException

loadClass

protected Class<?> loadClass(String name,
                             boolean resolve)
                      throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

loadClassFromChildren

public Class<?> loadClassFromChildren(ClassLoader requester,
                                      String name)
                               throws ClassNotFoundException

Throws:

ClassNotFoundException

loadClass

public Class<?> loadClass(String name)
                   throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

getResource

public URL getResource(String name)

Overrides:

getResource in class ClassLoader

getResources

public Enumeration<URL> getResources(String name)
                              throws IOException

Overrides:

getResources in class ClassLoader

Throws:

IOException

loadResourcesFromChildren

public List<URL> loadResourcesFromChildren(ClassLoader requester,
                                           String name)
                                    throws IOException

Throws:

IOException

isShortNameVersionAllowed

public boolean isShortNameVersionAllowed(NId candidateId)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

remove

public void remove(NId id)

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).

rebuild

public 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. Dropped jars are no longer consulted for future lookups; loaded Class objects remain valid per JVM constraints.

build

public NDefinition[] build()

buildInternal

protected final NDefinition[] buildInternal()

Resolve pending entries via NClasspathBuilder, create or retrieve shared leaves via NIdClassLoaderRegistry, and add them to this mutable composite's children list.

Version conflicts (same shortName, different version already loaded in this composite) are resolved by keeping the first-loaded version and logging a warning for subsequent different versions.

This method is final to ensure subclass constructors (e.g. DefaultImmutableNClassLoader) always execute the real resolution at construction time, even if the subclass overrides the public build() to freeze mutability post-construction.