Package com.ultikits.ultitools

Class ModuleClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

com.ultikits.ultitools.ModuleClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

final class ModuleClassLoader
extends URLClassLoader

The single, parent-first module loader. Only classes physically supplied by explicit module JAR URLs enter the ordered rewrite chain. Server JARs, directories and manifest Class-Path additions retain URLClassLoader's own definition path. Resource discovery remains inherited; module JAR handles are retained until this loader closes, just like URLClassLoader's own JAR handles.

Field Summary

Fields

Modifier and Type	Field	Description
private final Set<URL>	auditedModules
private boolean	closed
private final BiConsumer<String,byte[]>	definitionObserver
private final ConcurrentMap<URL,LinkageAudit.Audit>	moduleAudits
private final Map<URL,JarFile>	moduleJarFiles
private final Set<URL>	moduleJars
private final ConcurrentMap<String,Package>	ownPackages
private final ConcurrentMap<String,Object>	packageLocks
private final Set<URL>	reportedModules
private final ConcurrentMap<URL,ConcurrentMap<String,Integer>>	rewrittenClasses
private final List<ClassRewriteRule>	rules
private final AtomicBoolean	startupReported

Constructor Summary

Constructors

Constructor	Description
ModuleClassLoader(URL[] urls, ClassLoader parent, URL serverJar)	Production rules use this start's real parent, never the module loader itself.
ModuleClassLoader(URL[] urls, ClassLoader parent, URL serverJar, List<ClassRewriteRule> rules, BiConsumer<String,byte[]> definitionObserver)	Internal test seam observes a copy of exactly the bytes about to be defined.

Method Summary

Modifier and Type	Method	Description
(package private) List<LinkageAudit.Finding>	audit(File module)	Uses exactly the rule snapshot that class definition uses, also for the offline entry point.
(package private) void	auditModules(Logger logger)	Pre-scans each explicit module once; classification waits for normal container assembly.
void	close()
private void	ensurePackage(String binaryName, Manifest manifest, URL source)
protected Class<?>	findClass(String binaryName)
(package private) LinkageAudit.Audit	inspect(File module)
private static boolean	isSealed(String name, Manifest manifest)
(package private) void	logRewriteCounts(Logger logger)	One observed startup snapshot, after module initialization.
private JarFile	moduleJar(URL source, JarURLConnection connection)
private static byte[]	readFully(InputStream input)
private void	recordRewrite(URL source, String binaryName)
(package private) void	reportModule(Class<?> mainClass, String[] roots, Logger logger)	Emits a cached audit only when normal assembly has obtained the module's real scan roots.
private byte[]	rewrite(String binaryName, byte[] bytes)

Methods inherited from class java.net.URLClassLoader

addURL, definePackage, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Details

moduleJars

private final Set<URL> moduleJars

rules

private final List<ClassRewriteRule> rules

definitionObserver

private final BiConsumer<String,byte[]> definitionObserver

packageLocks

private final ConcurrentMap<String,Object> packageLocks

ownPackages

private final ConcurrentMap<String,Package> ownPackages

auditedModules

private final Set<URL> auditedModules

moduleAudits

private final ConcurrentMap<URL,LinkageAudit.Audit> moduleAudits

reportedModules

private final Set<URL> reportedModules

moduleJarFiles

private final Map<URL,JarFile> moduleJarFiles

closed

private boolean closed

rewrittenClasses

private final ConcurrentMap<URL,ConcurrentMap<String,Integer>> rewrittenClasses

startupReported

private final AtomicBoolean startupReported

Constructor Details

ModuleClassLoader

ModuleClassLoader(URL[] urls,
 ClassLoader parent,
 URL serverJar)

Production rules use this start's real parent, never the module loader itself.

ModuleClassLoader

ModuleClassLoader(URL[] urls,
 ClassLoader parent,
 URL serverJar,
 List<ClassRewriteRule> rules,
 BiConsumer<String,byte[]> definitionObserver)

Internal test seam observes a copy of exactly the bytes about to be defined.

Method Details

audit

List<LinkageAudit.Finding> audit(File module)
                          throws IOException

Uses exactly the rule snapshot that class definition uses, also for the offline entry point.

Throws:

IOException

inspect

LinkageAudit.Audit inspect(File module)
                    throws IOException

Throws:

IOException

reportModule

void reportModule(Class<?> mainClass,
 String[] roots,
 Logger logger)

Emits a cached audit only when normal assembly has obtained the module's real scan roots.

auditModules

void auditModules(Logger logger)

Pre-scans each explicit module once; classification waits for normal container assembly.

findClass

protected Class<?> findClass(String binaryName)
                      throws ClassNotFoundException

Overrides:

findClass in class URLClassLoader

Throws:

ClassNotFoundException

moduleJar

private JarFile moduleJar(URL source,
 JarURLConnection connection)
                   throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class URLClassLoader

Throws:

IOException

rewrite

private byte[] rewrite(String binaryName,
 byte[] bytes)

recordRewrite

private void recordRewrite(URL source,
 String binaryName)

logRewriteCounts

void logRewriteCounts(Logger logger)

One observed startup snapshot, after module initialization. Later lazy loads are not predictions in this count and do not print additional startup lines.

ensurePackage

private void ensurePackage(String binaryName,
 Manifest manifest,
 URL source)

isSealed

private static boolean isSealed(String name,
 Manifest manifest)

readFully

private static byte[] readFully(InputStream input)
                         throws IOException

Throws:

IOException