Package io.quarkus.bootstrap.runner

Class AotRunnerClassLoader

java.lang.Object

java.lang.ClassLoader

io.quarkus.bootstrap.runner.AotRunnerClassLoader

public class AotRunnerClassLoader
extends ClassLoader

A ClassLoader that behaves similarly to the RunnerClassLoader for resources but delegates all class loading to the JDK application class loader. The idea is that it lets us optimize the resource case, while still benefiting from AOT. Our hope is that we will be able to use a fully custom ClassLoader with Project Leyden at some point but we are not there yet. Key characteristics: - All class loading is delegated to the parent - Resource lookups are intercepted for the service files and otherwise delegated to the parent - For some selected directories, we have a full index of the content so that we can avoid negative lookups in the parent Note that not all ServiceLoader calls will hit this ClassLoader as some low levels one are directly hitting the ClassLoader used to load the classes, thus circumventing the optimizations we have in this ClassLoader. It is an expected behavior though, and will be vastly improved once we can use a custom ClassLoader with Leyden.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
protected Class<?>	findClass(String moduleName, String name)	This method is needed to make packages work correctly on JDK9+, as it will be called to load the package-info class.
protected URL	findResource(String name)
Enumeration<URL>	findResources(String name)	Finds all resources with the given name.
URL	getResource(String name)
Enumeration<URL>	getResources(String name)	Gets all resources with the given name.
int	hashCode()
Class<?>	loadClass(String name)
Class<?>	loadClass(String name, boolean resolve)

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, getResourceAsStream, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Method Details

loadClass

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

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

loadClass

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

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

findClass

protected Class<?> findClass(String moduleName,
 String name)

This method is needed to make packages work correctly on JDK9+, as it will be called to load the package-info class.

Overrides:

findClass in class ClassLoader

getResource

public URL getResource(String name)

Overrides:

getResource in class ClassLoader

findResource

protected URL findResource(String name)

Overrides:

findResource in class ClassLoader

getResources

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

Gets all resources with the given name. This is the method called by ServiceLoader and other resource loading mechanisms. If the resource is cached, returns ONLY the cached version without jar scanning. This is the key optimization - service files and config files are pre-cached, so ServiceLoader and config loading don't need to scan jars.

Overrides:

getResources in class ClassLoader

Parameters:

name - the resource name

Returns:

an enumeration of URLs for the resources

Throws:

IOException - if I/O errors occur

findResources

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

Finds all resources with the given name. If the resource is cached, returns ONLY the cached version without jar scanning.

Overrides:

findResources in class ClassLoader

Parameters:

name - the resource name

Returns:

an enumeration of URLs for the resources

Throws:

IOException - if I/O errors occur

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object