net.bytebuddy.dynamic.loading

Class ByteArrayClassLoader

java.lang.Object

java.lang.ClassLoader

net.bytebuddy.dynamic.loading.ByteArrayClassLoader

Direct Known Subclasses:

ByteArrayClassLoader.ChildFirst

public class ByteArrayClassLoader
extends ClassLoader

A ClassLoader that is capable of loading explicitly defined classes. The class loader will free any binary resources once a class that is defined by its binary data is loaded. This class loader is thread safe since the class loading mechanics are only called from synchronized context.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ByteArrayClassLoader.ChildFirst A ByteArrayClassLoader which applies child-first semantics for the given type definitions.
static class	ByteArrayClassLoader.PersistenceHandler A persistence handler decides on weather the byte array that represents a loaded class is exposed by the ClassLoader.getResourceAsStream(String) method.

Field Summary

Fields

Modifier and Type	Field and Description
protected AccessControlContext	accessControlContext The access control context of this class loader's instantiation.
protected ByteArrayClassLoader.PersistenceHandler	persistenceHandler The persistence handler of this class loader.
protected ProtectionDomain	protectionDomain The protection domain to apply.
protected Map<String,byte[]>	typeDefinitions A mutable map of type names mapped to their binary representation.

Constructor Summary

Constructors

Constructor and Description
ByteArrayClassLoader(ClassLoader parent, Map<String,byte[]> typeDefinitions, ProtectionDomain protectionDomain, ByteArrayClassLoader.PersistenceHandler persistenceHandler) Creates a new class loader for a given definition of classes.

Method Summary

Modifier and Type	Method and Description
protected Class<?>	findClass(String name)
InputStream	getResourceAsStream(String name)
static Map<TypeDescription,Class<?>>	load(ClassLoader classLoader, Map<TypeDescription,byte[]> types, ProtectionDomain protectionDomain, ByteArrayClassLoader.PersistenceHandler persistenceHandler, boolean childFirst) Loads a given set of class descriptions and their binary representations.
static ClassLoader	of(ClassLoader parent, Map<TypeDescription,byte[]> typeDefinitions, ProtectionDomain protectionDomain, ByteArrayClassLoader.PersistenceHandler persistenceHandler, boolean childFirst) Creates a new class loader for a given definition of classes.
String	toString()

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findResource, findResources, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, 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, wait, wait, wait

Field Detail

typeDefinitions

protected final Map<String,byte[]> typeDefinitions

A mutable map of type names mapped to their binary representation.

persistenceHandler

protected final ByteArrayClassLoader.PersistenceHandler persistenceHandler

The persistence handler of this class loader.

protectionDomain

protected final ProtectionDomain protectionDomain

The protection domain to apply. Might be null when referencing the default protection domain.

accessControlContext

protected final AccessControlContext accessControlContext

The access control context of this class loader's instantiation.

Constructor Detail

ByteArrayClassLoader

public ByteArrayClassLoader(ClassLoader parent,
                            Map<String,byte[]> typeDefinitions,
                            ProtectionDomain protectionDomain,
                            ByteArrayClassLoader.PersistenceHandler persistenceHandler)

Creates a new class loader for a given definition of classes.

Parameters:

parent - The ClassLoader that is the parent of this class loader.

typeDefinitions - A map of fully qualified class names pointing to their binary representations.

protectionDomain - The protection domain to apply where null references an implicit protection domain.

persistenceHandler - The persistence handler of this class loader.

Method Detail

of

public static ClassLoader of(ClassLoader parent,
                             Map<TypeDescription,byte[]> typeDefinitions,
                             ProtectionDomain protectionDomain,
                             ByteArrayClassLoader.PersistenceHandler persistenceHandler,
                             boolean childFirst)

Creates a new class loader for a given definition of classes.

Parameters:

parent - The ClassLoader that is the parent of this class loader.

typeDefinitions - A map of type descriptions pointing to their binary representations.

protectionDomain - The protection domain to apply where null references an implicit protection domain.

persistenceHandler - The persistence handler to be used by the created class loader.

childFirst - true if the class loader should apply child first semantics when loading the typeDefinitions.

Returns:

A corresponding class loader.

load

public static Map<TypeDescription,Class<?>> load(ClassLoader classLoader,
                                                 Map<TypeDescription,byte[]> types,
                                                 ProtectionDomain protectionDomain,
                                                 ByteArrayClassLoader.PersistenceHandler persistenceHandler,
                                                 boolean childFirst)

Loads a given set of class descriptions and their binary representations.

Parameters:

classLoader - The parent class loader.

types - The raw types to load.

protectionDomain - The protection domain to apply where null references an implicit protection domain.

persistenceHandler - The persistence handler of the created class loader.

childFirst - true true if the created class loader should apply child-first semantics when loading the types.

Returns:

A map of the given type descriptions pointing to their loaded representations.

findClass

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

Overrides:

findClass in class ClassLoader

Throws:

ClassNotFoundException

getResourceAsStream

public InputStream getResourceAsStream(String name)

Overrides:

getResourceAsStream in class ClassLoader

toString

public String toString()

Overrides:

toString in class Object