net.lenni0451.classtransform.utils.loader

Class InjectionClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

net.lenni0451.classtransform.utils.loader.InjectionClassLoader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

@ParametersAreNonnullByDefault
public class InjectionClassLoader
extends java.net.URLClassLoader

Inject into classes by using a custom class loader.

Constructor Summary

Constructors

Constructor and Description
InjectionClassLoader(TransformerManager transformerManager, java.lang.ClassLoader parent, java.net.URL... urls)
InjectionClassLoader(TransformerManager transformerManager, java.net.URL... urls)

Method Summary

Modifier and Type	Method and Description
void	addProtectedPackage(java.lang.String protectedPackage) Add a protected package to prevent the classes from being transformed.
void	addProtectionException(java.lang.String protectionException) Add an exception to the protected packages.
void	addRuntimeResource(java.lang.String path, byte[] data) Add a new resource to the classpath during runtime.
void	addURL(java.net.URL url) Add an url to the classpath.
void	copyClass(IClassProvider classProvider, java.lang.String className) Copy a class to the runtime resources.
void	copyResource(java.lang.ClassLoader classLoader, java.lang.String path) Copy a resource from a class loader to the runtime resources.
void	executeMain(java.lang.String className, java.lang.String methodName, java.lang.String... args) Execute the main method of the given class. The only argument of the main method has to be a String[].
protected java.lang.Class<?>	findClass(java.lang.String name)
java.net.URL	findResource(java.lang.String name)
java.util.Enumeration<java.net.URL>	findResources(java.lang.String name)
java.net.URL	getResource(java.lang.String name)
TransformerManager	getTransformerManager()
boolean	isProtected(java.lang.String className) Check if the given class is protected and should not be transformed/loaded by this class loader.
protected java.lang.Class<?>	loadClass(java.lang.String name, boolean resolve)
void	setPriority(EnumLoaderPriority priority) Set the priority of the load class method.

Methods inherited from class java.net.URLClassLoader

close, definePackage, 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, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

InjectionClassLoader

public InjectionClassLoader(TransformerManager transformerManager,
                            java.net.URL... urls)

InjectionClassLoader

public InjectionClassLoader(TransformerManager transformerManager,
                            java.lang.ClassLoader parent,
                            java.net.URL... urls)

Method Detail

loadClass

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

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

findClass

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

Overrides:

findClass in class java.net.URLClassLoader

Throws:

java.lang.ClassNotFoundException

getResource

@Nullable
public java.net.URL getResource(java.lang.String name)

Overrides:

getResource in class java.lang.ClassLoader

findResource

@Nullable
public java.net.URL findResource(java.lang.String name)

Overrides:

findResource in class java.net.URLClassLoader

findResources

@Nonnull
public java.util.Enumeration<java.net.URL> findResources(java.lang.String name)

Overrides:

findResources in class java.net.URLClassLoader

isProtected

public boolean isProtected(java.lang.String className)

Check if the given class is protected and should not be transformed/loaded by this class loader.

Parameters:

className - The name of the class to check

Returns:

If the class is protected

addProtectedPackage

public void addProtectedPackage(java.lang.String protectedPackage)

Add a protected package to prevent the classes from being transformed.

Parameters:

protectedPackage - The package to protect

addProtectionException

public void addProtectionException(java.lang.String protectionException)

Add an exception to the protected packages.

Parameters:

protectionException - The package to add

getTransformerManager

public TransformerManager getTransformerManager()

Returns:

The transformer manager used by this class loader

addURL

public void addURL(java.net.URL url)

Add an url to the classpath.

Overrides:

addURL in class java.net.URLClassLoader

Parameters:

url - The url to add

addRuntimeResource

public void addRuntimeResource(java.lang.String path,
                               byte[] data)

Add a new resource to the classpath during runtime.

Parameters:

path - The path to the resource

data - The data of the resource

copyResource

public void copyResource(java.lang.ClassLoader classLoader,
                         java.lang.String path)

Copy a resource from a class loader to the runtime resources.

Parameters:

classLoader - The class loader to copy the resource from

path - The path to the resource

copyClass

public void copyClass(IClassProvider classProvider,
                      java.lang.String className)

Copy a class to the runtime resources.

Parameters:

classProvider - The class provider to get the bytecode from

className - The name of the class to copy

setPriority

public void setPriority(EnumLoaderPriority priority)

Set the priority of the load class method.

Parameters:

priority - The priority

Throws:

java.lang.IllegalArgumentException - If the priority is set to EnumLoaderPriority.PARENT_FIRST and no parent class loader is set

executeMain

public void executeMain(java.lang.String className,
                        java.lang.String methodName,
                        java.lang.String... args)
                 throws java.lang.ClassNotFoundException,
                        java.lang.NoSuchMethodException,
                        java.lang.reflect.InvocationTargetException,
                        java.lang.IllegalAccessException

Execute the main method of the given class.
The only argument of the main method has to be a String[].

Parameters:

className - The name of the class containing the main method

methodName - The name of the main method

args - The arguments to pass to the main method

Throws:

java.lang.ClassNotFoundException - If the class could not be found

java.lang.NoSuchMethodException - If the main method could not be found

java.lang.reflect.InvocationTargetException - If the main method throws an exception

java.lang.IllegalAccessException - If the main method could not be accessed