net.thevpc.nuts.runtime.standalone.extension

Class NIdClassLoaderRegistry

java.lang.Object

net.thevpc.nuts.runtime.standalone.extension.NIdClassLoaderRegistry

public final class NIdClassLoaderRegistry
extends Object

VM-static (classloader-global) registry of leaf classloaders keyed by NId.longName (group:artifact:classifier#version) or absolute NPath for raw-path entries.

Guarantees that for the same GAV (longName), exactly one DefaultNLeafClassLoader is ever created in this VM, so Class identity is preserved across workspaces, searches, and mutable extension classloaders.

Mirror-de-duplication comes for free: entries with the same longName but different paths/mirrors simply return the already-registered leaf.

All methods are thread-safe. Entries are held with strong references to respect JVM class identity semantics (leaves are pinned as long as any Class they defined is reachable, which is effectively forever for most workloads).

Lifecycle note: Registry entries and leaf indexes are held for the lifetime of the JVM unless explicitly invalidated via invalidate(NId), invalidate(NPath), or invalidateAll(). Applications embedding Nuts in long-running processes should manage registry lifecycle when extensions are dynamically loaded and discarded.

Category:

Internal

Method Summary

Modifier and Type	Method and Description
static ClassLoader	getIfPresent(NId id)
static ClassLoader	getIfPresent(NPath path)
static void	invalidate(NId id)
static void	invalidate(NPath path)
static void	invalidateAll()
static void	invalidateCache()
static void	invalidateClass(String className)
static boolean	LEAF_PARENT(ClassLoader c)

Methods inherited from class java.lang.Object

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

Method Detail

LEAF_PARENT

public static boolean LEAF_PARENT(ClassLoader c)

getIfPresent

public static ClassLoader getIfPresent(NId id)

getIfPresent

public static ClassLoader getIfPresent(NPath path)

invalidate

public static void invalidate(NId id)

invalidate

public static void invalidate(NPath path)

invalidateAll

public static void invalidateAll()

invalidateCache

public static void invalidateCache()

invalidateClass

public static void invalidateClass(String className)