net.bytebuddy.dynamic.loading

Class ClassLoaderByteArrayInjector

java.lang.Object

net.bytebuddy.dynamic.loading.ClassLoaderByteArrayInjector

public class ClassLoaderByteArrayInjector
extends Object

An injector that loads classes by reflectively invoking non-public methods on a given ClassLoader.

Note that the injector is only able to load classes in a linear manner. Thus, classes that refer to other classes which are not yet loaded cannot be injected but will result in a NoClassDefFoundError. This becomes a problem when classes refer to each other using cyclic references. This injector can further not be applied to the bootstrap class loader which is usually represented by a null value and can therefore not be accessed by reflection.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	ClassLoaderByteArrayInjector.ClassLoadingAction A privileged action for loading a class reflectively.
protected static interface	ClassLoaderByteArrayInjector.ReflectionStore A storage for method representations in order to access a class loader reflectively.

Constructor Summary

Constructors

Constructor and Description
ClassLoaderByteArrayInjector(ClassLoader classLoader) Creates a new injector for the given ClassLoader and a default ProtectionDomain.
ClassLoaderByteArrayInjector(ClassLoader classLoader, ProtectionDomain protectionDomain) Creates a new injector for the given ClassLoader and ProtectionDomain.

Method Summary

Modifier and Type	Method and Description
static Map<TypeDescription,Class<?>>	inject(ClassLoaderByteArrayInjector classLoaderByteArrayInjector, Map<TypeDescription,byte[]> types) Injects a given type mapping into a class loader byte array injector.
Class<?>	inject(String name, byte[] binaryRepresentation) Explicitly loads a Class by reflective access into the represented class loader.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassLoaderByteArrayInjector

public ClassLoaderByteArrayInjector(ClassLoader classLoader)

Creates a new injector for the given ClassLoader and a default ProtectionDomain.

Parameters:

classLoader - The ClassLoader into which new class definitions are to be injected.

ClassLoaderByteArrayInjector

public ClassLoaderByteArrayInjector(ClassLoader classLoader,
                                    ProtectionDomain protectionDomain)

Creates a new injector for the given ClassLoader and ProtectionDomain.

Parameters:

classLoader - The ClassLoader into which new class definitions are to be injected.

protectionDomain - The protection domain to apply during class definition.

Method Detail

inject

public static Map<TypeDescription,Class<?>> inject(ClassLoaderByteArrayInjector classLoaderByteArrayInjector,
                                                   Map<TypeDescription,byte[]> types)

Injects a given type mapping into a class loader byte array injector.

Parameters:

classLoaderByteArrayInjector - The target of the injection.

types - A mapping of types to their binary representation.

Returns:

A map of loaded classes which were injected into the class loader byte array injector.

inject

public Class<?> inject(String name,
                       byte[] binaryRepresentation)

Explicitly loads a Class by reflective access into the represented class loader.

Parameters:

name - The fully qualified name of the Class to be loaded.

binaryRepresentation - The type's binary representation.

Returns:

The loaded class that is a result of the class loading attempt.

toString

public String toString()

Overrides:

toString in class Object