Class StriderClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

dev.nozyx.strider.loader.api.StriderClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public final class StriderClassLoader
extends URLClassLoader

A class loader used by StriderLoader to load and transform game classes.

Classes outside the Minecraft and Mojang packages use the standard parent-first class-loading strategy. Classes belonging to net.minecraft or com.mojang are loaded using a child-first strategy so they can be transformed before being defined by the JVM.

Classes loaded by this class loader can be processed by registered class transformers before they are defined by the JVM. Transformers are applied in the order in which they were registered.

Constructor Summary

Constructors

Constructor	Description
StriderClassLoader()	Creates a new StriderClassLoader using the current JVM classpath as its initial classpath.
StriderClassLoader(URL[] urls, ClassLoader parent)	Creates a new StriderClassLoader with the specified classpath and parent class loader.

Method Summary

Modifier and Type	Method	Description
void	addTransformer(ClassTransformer transformer)	Registers a class transformer.
void	addUrl(Path path)	Adds a JAR file or directory to this class loader's classpath.
protected Class<?>	findClass(String name)
Class<?>	loadClass(String name)	Loads a class using the configured class-loading strategy.
Class<?>	loadClass(String name, boolean resolve)	Loads and optionally resolves a class.

Methods inherited from class URLClassLoader

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

Methods inherited from class SecureClassLoader

defineClass, defineClass

Methods inherited from class 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, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class Object

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

Constructor Details

StriderClassLoader

@Internal
public StriderClassLoader()

Creates a new StriderClassLoader using the current JVM classpath as its initial classpath.

StriderClassLoader

@Internal
public StriderClassLoader(URL[] urls,
 ClassLoader parent)

Creates a new StriderClassLoader with the specified classpath and parent class loader.

Parameters:

urls - the URLs from which classes and resources can be loaded

parent - the parent class loader used for class loading

Method Details

loadClass

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

Loads a class using the configured class-loading strategy.

Overrides:

loadClass in class ClassLoader

Parameters:

name - the fully qualified binary name of the class

Returns:

the resulting Class object

Throws:

ClassNotFoundException - if the class cannot be found

loadClass

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

Loads and optionally resolves a class.

Classes in net.minecraft and com.mojang are loaded child-first. All other classes are loaded parent-first.

Overrides:

loadClass in class ClassLoader

Parameters:

name - the fully qualified binary name of the class

resolve - whether the class should be resolved after loading

Returns:

the resulting Class object

Throws:

ClassNotFoundException - if the class cannot be found

findClass

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

Overrides:

findClass in class URLClassLoader

Throws:

ClassNotFoundException

addUrl

public void addUrl(Path path)
            throws MalformedURLException

Adds a JAR file or directory to this class loader's classpath.

Parameters:

path - the JAR file or directory to add

Throws:

MalformedURLException - if the path cannot be converted to a URL

addTransformer

public void addTransformer(ClassTransformer transformer)

Registers a class transformer.

Parameters:

transformer - the transformer to register