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, ClassLoadingStrategy.WithDefaultProtectionDomain

Enclosing interface:

ClassLoadingStrategy

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

This class contains implementations of default class loading strategies.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ClassLoadingStrategy.Default.ProtectionDomainInjection A class loading strategy which applies a class loader injection while applying a given ProtectionDomain on class injection.
protected static class	ClassLoadingStrategy.Default.ProtectionDomainWrapper A class loading strategy which creates a wrapping class loader while applying a given ProtectionDomain on class loading.

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

ClassLoadingStrategy.Default, ClassLoadingStrategy.WithDefaultProtectionDomain

Enum Constant Summary

Enum Constants

Enum Constant and Description
CHILD_FIRST The child-first class loading strategy is a modified version of the WRAPPER where the dynamic types are given priority over any types of a parent class loader with the same name.
CHILD_FIRST_PERSISTENT The strategy is identical to CHILD_FIRST but exposes the byte arrays that represent a class by ClassLoader.getResourceAsStream(String).
INJECTION This strategy does not create a new class loader but injects all classes into the given ClassLoader by reflective access.
WRAPPER This strategy creates a new ByteArrayClassLoader with the given class loader as its parent.
WRAPPER_PERSISTENT The strategy is identical to WRAPPER but exposes the byte arrays that represent a class by ClassLoader.getResourceAsStream(String).

Method Summary

Modifier and Type	Method and Description
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

Methods inherited from interface net.bytebuddy.dynamic.ClassLoadingStrategy.WithDefaultProtectionDomain

withProtectionDomain

Methods inherited from interface net.bytebuddy.dynamic.ClassLoadingStrategy

load

Enum Constant Detail

WRAPPER

public static final ClassLoadingStrategy.Default WRAPPER

This strategy creates a new ByteArrayClassLoader with the given class loader as its parent. The byte array class loader is aware of a any dynamically created type and can natively load the given classes. This allows to load classes with cyclic load-time 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.

WRAPPER_PERSISTENT

public static final ClassLoadingStrategy.Default WRAPPER_PERSISTENT

The strategy is identical to WRAPPER but exposes the byte arrays that represent a class by ClassLoader.getResourceAsStream(String). For this purpose, all class files are persisted as byte arrays withing the wrapping class loader.

CHILD_FIRST

public static final ClassLoadingStrategy.Default CHILD_FIRST

The child-first class loading strategy is a modified version of the WRAPPER where the dynamic types are given priority over any types of a parent class loader with the same name.

Important: This does not replace a type of the same name, but it makes the type invisible by the reach of this class loader.

CHILD_FIRST_PERSISTENT

public static final ClassLoadingStrategy.Default CHILD_FIRST_PERSISTENT

The strategy is identical to CHILD_FIRST but exposes the byte arrays that represent a class by ClassLoader.getResourceAsStream(String). For this purpose, all class files are persisted as byte arrays withing the wrapping class loader.

INJECTION

public static final ClassLoadingStrategy.Default INJECTION

This strategy does not create a new class loader but injects all classes into the given ClassLoader by reflective access. This prevents the loading of classes with cyclic load-time 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. Note that this strategy usually yields a better runtime performance.

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