net.bytebuddy.dynamic.loading

Class InjectionClassLoader

java.lang.Object

java.lang.ClassLoader

net.bytebuddy.dynamic.loading.InjectionClassLoader

Direct Known Subclasses:

ByteArrayClassLoader, MultipleParentClassLoader

public abstract class InjectionClassLoader
extends ClassLoader

An injection class loader allows for the injection of a class after the class loader was created. Injection is only possible if this class loader is not sealed.

Important: Not sealing a class loader allows to break package encapsulation for anybody getting hold of a reference to this class loader.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InjectionClassLoader.Strategy A class loading strategy for adding a type to an injection class loader.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InjectionClassLoader(ClassLoader parent, boolean sealed) Creates a new injection class loader.

Method Summary

Modifier and Type	Method and Description
Class<?>	defineClass(String name, byte[] binaryRepresentation) Defines a new type to be loaded by this class loader.
Map<String,Class<?>>	defineClasses(Map<String,byte[]> typeDefinitions) Defines a group of types to be loaded by this class loader.
protected abstract Map<String,Class<?>>	doDefineClasses(Map<String,byte[]> typeDefinitions) Defines a group of types to be loaded by this class loader.
boolean	isSealed() Returns true if this class loader is sealed.
boolean	seal() Seals the class loader and returns true if the class loader was not sealed previously.

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, 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

protected InjectionClassLoader(@MaybeNull
                               ClassLoader parent,
                               boolean sealed)

Creates a new injection class loader.

Parameters:

parent - The class loader's parent.

sealed - Indicates if this class loader is sealed, i.e. forbids runtime injection.

Method Detail

isSealed

public boolean isSealed()

Returns true if this class loader is sealed.

Returns:

true if this class loader is sealed.

seal

public boolean seal()

Seals the class loader and returns true if the class loader was not sealed previously.

Returns:

true if the class loader was not sealed previously.

defineClass

public Class<?> defineClass(String name,
                            byte[] binaryRepresentation)
                     throws ClassNotFoundException

Defines a new type to be loaded by this class loader.

Parameters:

name - The name of the type.

binaryRepresentation - The type's binary representation.

Returns:

The defined class or a previously defined class.

Throws:

ClassNotFoundException - If the class could not be loaded.

defineClasses

public Map<String,Class<?>> defineClasses(Map<String,byte[]> typeDefinitions)
                                   throws ClassNotFoundException

Defines a group of types to be loaded by this class loader. If this class loader is sealed, an IllegalStateException is thrown.

Parameters:

typeDefinitions - The types binary representations.

Returns:

The mapping of defined classes or previously defined classes by their name.

Throws:

ClassNotFoundException - If the class could not be loaded.

doDefineClasses

protected abstract Map<String,Class<?>> doDefineClasses(Map<String,byte[]> typeDefinitions)
                                                 throws ClassNotFoundException

Defines a group of types to be loaded by this class loader.

Parameters:

typeDefinitions - The types binary representations.

Returns:

The mapping of defined classes or previously defined classes by their name.

Throws:

ClassNotFoundException - If the class could not be loaded.