net.bytebuddy.dynamic.loading

Enum ClassReloadingStrategy.Strategy

java.lang.Object

java.lang.Enum<ClassReloadingStrategy.Strategy>

net.bytebuddy.dynamic.loading.ClassReloadingStrategy.Strategy

All Implemented Interfaces:

Serializable, Comparable<ClassReloadingStrategy.Strategy>

Enclosing class:

ClassReloadingStrategy

public static enum ClassReloadingStrategy.Strategy
extends Enum<ClassReloadingStrategy.Strategy>

A strategy which performs the actual redefinition of a Class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ClassReloadingStrategy.Strategy.ClassRedefinitionTransformer A class file transformer that applies a given ClassDefinition.
protected static class	ClassReloadingStrategy.Strategy.ClassResettingTransformer A transformer that indicates that a class file should not be transformed.

Enum Constant Summary

Enum Constants

Enum Constant and Description
REDEFINITION Redefines a class using Instrumentation.redefineClasses(java.lang.instrument.ClassDefinition...).
RETRANSFORMATION Redefines a class using Instrumentation.retransformClasses(Class[]).

Method Summary

Modifier and Type	Method and Description
protected abstract void	apply(Instrumentation instrumentation, Map<Class<?>,ClassDefinition> classDefinitions) Applies this strategy for the given arguments.
boolean	isRedefinition() Returns true if this strategy represents REDEFINITION.
abstract void	reset(Instrumentation instrumentation, ClassFileLocator classFileLocator, List<Class<?>> types) Resets the provided types to their original format.
protected abstract ClassReloadingStrategy.Strategy	validate(Instrumentation instrumentation) Validates that this strategy supports a given transformation type.
static ClassReloadingStrategy.Strategy	valueOf(String name) Returns the enum constant of this type with the specified name.
static ClassReloadingStrategy.Strategy[]	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

REDEFINITION

public static final ClassReloadingStrategy.Strategy REDEFINITION

Redefines a class using Instrumentation.redefineClasses(java.lang.instrument.ClassDefinition...).

This strategy can be more efficient. However, the redefinition strategy does not allow to reset VM anonymous classes (e.g. classes that represent lambda expressions).

RETRANSFORMATION

public static final ClassReloadingStrategy.Strategy RETRANSFORMATION

Redefines a class using Instrumentation.retransformClasses(Class[]). This requires synchronization on the ClassReloadingStrategy.instrumentation object.

This strategy can require more time to be applied but does not struggle to reset VM anonymous classes (e.g. classes that represent lambda expressions).

Method Detail

values

public static ClassReloadingStrategy.Strategy[] 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 (ClassReloadingStrategy.Strategy c : ClassReloadingStrategy.Strategy.values())
    System.out.println(c);

Returns:

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

valueOf

public static ClassReloadingStrategy.Strategy 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

apply

protected abstract void apply(Instrumentation instrumentation,
                              Map<Class<?>,ClassDefinition> classDefinitions)
                       throws UnmodifiableClassException,
                              ClassNotFoundException

Applies this strategy for the given arguments.

Parameters:

instrumentation - The instrumentation to be used for applying the redefinition.

classDefinitions - A mapping of the classes to be redefined to their redefinition.

Throws:

UnmodifiableClassException - If a class is not modifiable.

ClassNotFoundException - If a class was not found.

validate

protected abstract ClassReloadingStrategy.Strategy validate(Instrumentation instrumentation)

Validates that this strategy supports a given transformation type.

Parameters:

instrumentation - The instrumentation instance being used.

Returns:

This strategy.

isRedefinition

public boolean isRedefinition()

Returns true if this strategy represents REDEFINITION.

Returns:

true if this strategy represents REDEFINITION.

reset

public abstract void reset(Instrumentation instrumentation,
                           ClassFileLocator classFileLocator,
                           List<Class<?>> types)
                    throws IOException,
                           UnmodifiableClassException,
                           ClassNotFoundException

Resets the provided types to their original format.

Parameters:

instrumentation - The instrumentation instance to use for class redefinition or retransformation.

classFileLocator - The class file locator to use.

types - The types to reset.

Throws:

IOException - If an I/O exception occurs.

UnmodifiableClassException - If a class is not modifiable.

ClassNotFoundException - If a class could not be found.