net.bytebuddy.dynamic

Enum ClassLoadingStrategy.Default

java.lang.Object

java.lang.Enum<ClassLoadingStrategy.Default>

net.bytebuddy.dynamic.ClassLoadingStrategy.Default

All Implemented Interfaces:

Serializable, Comparable<ClassLoadingStrategy.Default>, ClassLoadingStrategy

Enclosing interface:

ClassLoadingStrategy

public static enum ClassLoadingStrategy.Default
extends Enum<ClassLoadingStrategy.Default>
implements ClassLoadingStrategy

Default class loading strategies.

1. The WRAPPER strategy will create a new ByteArrayClassLoader which has the given class loader as its parent. The byte array class loader is aware of a given number of types and can natively load the given classes. This allows to load classes with cyclic dependencies since the byte array class loader is queried on each encountered unknown class. Due to the encapsulation of the classes that were loaded by a byte array class loader, this strategy will lead to the unloading of these classes once this class loader, its classes or any instances of these classes become unreachable.
2. The INJECTION strategy will not create a new class loader but inject all classes into the given ClassLoader by reflective access. This prevents the loading of classes with cyclic dependencies but avoids the creation of an additional class loader. The advantage of this strategy is that the loaded classes will have package-private access to other classes within their package of the class loader into which they are injected what is not permitted when the wrapper class loader is used. This strategy is implemented using a ClassLoaderByteArrayInjector.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.ClassLoadingStrategy

ClassLoadingStrategy.Default

Enum Constant Summary

Enum Constants

Enum Constant and Description
INJECTION
WRAPPER

Method Summary

Modifier and Type	Method and Description
Map<TypeDescription,Class<?>>	load(ClassLoader classLoader, Map<TypeDescription,byte[]> types) Loads a given collection of classes given their binary representation.
static ClassLoadingStrategy.Default	valueOf(String name) Returns the enum constant of this type with the specified name.
static ClassLoadingStrategy.Default[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

WRAPPER

public static final ClassLoadingStrategy.Default WRAPPER

INJECTION

public static final ClassLoadingStrategy.Default INJECTION

Method Detail

values

public static ClassLoadingStrategy.Default[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ClassLoadingStrategy.Default c : ClassLoadingStrategy.Default.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ClassLoadingStrategy.Default valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

load

public Map<TypeDescription,Class<?>> load(ClassLoader classLoader,
                                          Map<TypeDescription,byte[]> types)

Description copied from interface: ClassLoadingStrategy

Loads a given collection of classes given their binary representation.

Specified by:

load in interface ClassLoadingStrategy

Parameters:

classLoader - The class loader to used for loading the classes.

types - Byte array representations of the types to be loaded mapped by their descriptions, where an iteration order defines an order in which they are supposed to be loaded, if relevant.

Returns:

A collection of the loaded classes which will be initialized in the iteration order of the returned collection.