net.bytebuddy.dynamic.scaffold.subclass

Enum ConstructorStrategy.Default

java.lang.Object

java.lang.Enum<ConstructorStrategy.Default>

net.bytebuddy.dynamic.scaffold.subclass.ConstructorStrategy.Default

All Implemented Interfaces:

Serializable, Comparable<ConstructorStrategy.Default>, ConstructorStrategy

Enclosing interface:

ConstructorStrategy

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

Default implementations of constructor strategies.

1. The NO_CONSTRUCTORS strategy is adding no constructors such that the instrumented type will by default not have any. This is legal by Java byte code requirements. However, if no constructor is added manually if this strategy is applied, the type is not constructable without using JVM non-public functionality.
2. The DEFAULT_CONSTRUCTOR strategy is adding a default constructor that calls it's super types default constructor. If no such constructor is defined, an IllegalArgumentException is thrown. Only public or protected constructors are considered by this strategy.
3. The IMITATE_SUPER_TYPE strategy is adding all constructors of the super type which are making direct calls to their super constructor of same signature. Only public or protected constructors are considered by this strategy.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.scaffold.subclass.ConstructorStrategy

ConstructorStrategy.Default

Enum Constant Summary

Enum Constants

Enum Constant and Description
DEFAULT_CONSTRUCTOR
IMITATE_SUPER_TYPE
NO_CONSTRUCTORS

Method Summary

Modifier and Type	Method and Description
MethodList	extractConstructors(TypeDescription superType) Extracts constructors for a given super type.
MethodRegistry	inject(MethodRegistry methodRegistry, MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory) Returns a method registry that is capable of creating byte code for the constructors that were provided by the ConstructorStrategy.extractConstructors(net.bytebuddy.instrumentation.type.TypeDescription) method of this instance.
static ConstructorStrategy.Default	valueOf(String name) Returns the enum constant of this type with the specified name.
static ConstructorStrategy.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

NO_CONSTRUCTORS

public static final ConstructorStrategy.Default NO_CONSTRUCTORS

DEFAULT_CONSTRUCTOR

public static final ConstructorStrategy.Default DEFAULT_CONSTRUCTOR

IMITATE_SUPER_TYPE

public static final ConstructorStrategy.Default IMITATE_SUPER_TYPE

Method Detail

values

public static ConstructorStrategy.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 (ConstructorStrategy.Default c : ConstructorStrategy.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 ConstructorStrategy.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

extractConstructors

public MethodList extractConstructors(TypeDescription superType)

Description copied from interface: ConstructorStrategy

Extracts constructors for a given super type. The extracted constructor signatures will then be imitated by the created dynamic type.

Specified by:

extractConstructors in interface ConstructorStrategy

Parameters:

superType - The super type from which constructors are to be extracted.

Returns:

A list of constructor descriptions which will be mimicked by the instrumented type of which the superType is the direct super type of the instrumented type.

inject

public MethodRegistry inject(MethodRegistry methodRegistry,
                             MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory)

Description copied from interface: ConstructorStrategy

Returns a method registry that is capable of creating byte code for the constructors that were provided by the ConstructorStrategy.extractConstructors(net.bytebuddy.instrumentation.type.TypeDescription) method of this instance.

Specified by:

inject in interface ConstructorStrategy

Parameters:

methodRegistry - The original method registry.

defaultMethodAttributeAppenderFactory - The default method attribute appender factory.

Returns:

A method registry that is capable of providing byte code for the constructors that were added by this strategy.