net.bytebuddy.dynamic

Class DynamicType.Builder.AbstractBase<S>

java.lang.Object

net.bytebuddy.dynamic.DynamicType.Builder.AbstractBase<S>

Type Parameters:

S - The most specific known loaded type that is implemented by the created dynamic type, usually the type itself, an interface or the direct super class.

All Implemented Interfaces:

DynamicType.Builder<S>

Direct Known Subclasses:

RebaseDynamicTypeBuilder, RedefinitionDynamicTypeBuilder, SubclassDynamicTypeBuilder

Enclosing interface:

DynamicType.Builder<T>

public abstract static class DynamicType.Builder.AbstractBase<S>
extends Object
implements DynamicType.Builder<S>

An abstract base implementation for a dynamic type builder. For representing the built type, the TargetType class can be used as a placeholder.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DynamicType.Builder.AbstractBase.AbstractDelegatingBuilder<U> A base implementation of a builder that is capable of manifesting a change that was not yet applied to the builder.
protected class	DynamicType.Builder.AbstractBase.DefaultExceptionDeclarableMethodInterception A DynamicType.Builder.ExceptionDeclarableMethodInterception which allows the definition of exceptions for a recently defined method.
protected class	DynamicType.Builder.AbstractBase.DefaultFieldValueTarget A DynamicType.Builder for which a field was recently defined such that attributes can be added to this recently defined field.
protected class	DynamicType.Builder.AbstractBase.DefaultMatchedMethodInterception A DynamicType.Builder.MatchedMethodInterception for which a method was recently identified or defined such that an Implementation for these methods can now be defined.
protected class	DynamicType.Builder.AbstractBase.DefaultMethodAnnotationTarget A DynamicType.Builder.MethodAnnotationTarget which allows the definition of annotations for a recently identified method.
protected class	DynamicType.Builder.AbstractBase.DefaultOptionalMatchedMethodInterception Allows for the direct implementation of an interface after its implementation was specified.
protected static class	DynamicType.Builder.AbstractBase.FieldToken A field token representing a latent field that is defined for the built dynamic type.
protected static class	DynamicType.Builder.AbstractBase.MethodToken A method token representing a latent method that is defined for the built dynamic type.

Nested classes/interfaces inherited from interface net.bytebuddy.dynamic.DynamicType.Builder

DynamicType.Builder.AbstractBase<S>, DynamicType.Builder.ExceptionDeclarableMethodInterception<S>, DynamicType.Builder.FieldAnnotationTarget<S>, DynamicType.Builder.FieldValueTarget<S>, DynamicType.Builder.MatchedMethodInterception<S>, DynamicType.Builder.MethodAnnotationTarget<S>, DynamicType.Builder.OptionalMatchedMethodInterception<S>

Field Summary

Fields

Modifier and Type	Field and Description
protected TypeAttributeAppender	attributeAppender The type attribute appender specified for this builder.
protected AuxiliaryType.NamingStrategy	auxiliaryTypeNamingStrategy The naming strategy for auxiliary types specified for this builder.
protected BridgeMethodResolver.Factory	bridgeMethodResolverFactory The bridge method resolver factory specified for this builder.
protected ClassFileVersion	classFileVersion The class file version specified for this builder.
protected ClassVisitorWrapper.Chain	classVisitorWrapperChain The class visitor wrapper chain that is applied on created types by this builder.
protected FieldAttributeAppender.Factory	defaultFieldAttributeAppenderFactory The default field attribute appender factory that is automatically added to any field that is registered on this builder.
protected MethodAttributeAppender.Factory	defaultMethodAttributeAppenderFactory The default method attribute appender factory that is automatically added to any field method is registered on this builder.
protected FieldRegistry	fieldRegistry The field registry of this builder.
protected List<DynamicType.Builder.AbstractBase.FieldToken>	fieldTokens This builder's currently registered field tokens.
protected ElementMatcher<? super MethodDescription>	ignoredMethods The method matcher for ignored method specified for this builder.
protected List<TypeDescription>	interfaceTypes The interface types to implement as specified for this builder.
protected MethodLookupEngine.Factory	methodLookupEngineFactory The method lookup engine factory to be used by this builder.
protected MethodRegistry	methodRegistry The method registry of this builder.
protected List<DynamicType.Builder.AbstractBase.MethodToken>	methodTokens This builder's currently registered method tokens.
protected int	modifiers The modifiers specified for this builder.
protected NamingStrategy	namingStrategy The naming strategy specified for this builder.
protected TypeDescription	targetType The target type description that is specified for this builder.

Constructor Summary

Constructors

Modifier

Constructor and Description

protected

AbstractBase(ClassFileVersion classFileVersion, NamingStrategy namingStrategy, AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy, TypeDescription targetType, List<TypeDescription> interfaceTypes, int modifiers, TypeAttributeAppender attributeAppender, ElementMatcher<? super MethodDescription> ignoredMethods, BridgeMethodResolver.Factory bridgeMethodResolverFactory, ClassVisitorWrapper.Chain classVisitorWrapperChain, FieldRegistry fieldRegistry, MethodRegistry methodRegistry, MethodLookupEngine.Factory methodLookupEngineFactory, FieldAttributeAppender.Factory defaultFieldAttributeAppenderFactory, MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory, List<DynamicType.Builder.AbstractBase.FieldToken> fieldTokens, List<DynamicType.Builder.AbstractBase.MethodToken> methodTokens) Creates a new immutable type builder base implementation.

Method Summary

Modifier and Type	Method and Description
DynamicType.Builder<S>	annotateType(Annotation... annotation) Adds annotations to the currently constructed type.
DynamicType.Builder<S>	annotateType(AnnotationDescription... annotation) Adds annotations to the currently constructed type.
protected InstrumentedType	applyRecordedMembersTo(InstrumentedType instrumentedType) Adds all fields and methods to an instrumented type.
DynamicType.Builder<S>	attribute(TypeAttributeAppender attributeAppender) Adds an attribute appender to the currently constructed type which will be applied on the creation of the type.
DynamicType.Builder<S>	bridgeMethodResolverFactory(BridgeMethodResolver.Factory bridgeMethodResolverFactory) Defines a bridge method resolver factory to be applied to this type creation.
DynamicType.Builder<S>	classFileVersion(ClassFileVersion classFileVersion) Defines a class file format version for this builder for which the dynamic types should be created.
DynamicType.Builder<S>	classVisitor(ClassVisitorWrapper classVisitorWrapper) Adds an additional ASM ClassVisitor to this builder which will be applied in the construction process of this dynamic type.
DynamicType.Builder.MatchedMethodInterception<S>	constructor(ElementMatcher<? super MethodDescription> methodMatcher) Selects a set of constructors of this type for implementation.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	define(MethodDescription methodDescription) Defines a new method or constructor for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineConstructor(Constructor<?> constructor) Defines a new constructor for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineConstructor(Iterable<Class<?>> parameterTypes, int modifiers) Defines a new constructor for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineConstructor(Iterable<Class<?>> parameterTypes, ModifierContributor.ForMethod... modifier) Defines a new constructor for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineConstructor(List<? extends TypeDescription> parameterTypes, int modifiers) Defines a new constructor for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineConstructor(List<? extends TypeDescription> parameterTypes, ModifierContributor.ForMethod... modifier) Defines a new constructor for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineConstructor(MethodDescription methodDescription) Defines a new constructor for this type.
DynamicType.Builder.FieldValueTarget<S>	defineField(Field field) Defines a new field for this type.
DynamicType.Builder.FieldValueTarget<S>	defineField(FieldDescription fieldDescription) Defines a new field for this type.
DynamicType.Builder.FieldValueTarget<S>	defineField(String name, Class<?> fieldType, int modifiers) Defines a new field for this type.
DynamicType.Builder.FieldValueTarget<S>	defineField(String name, Class<?> fieldType, ModifierContributor.ForField... modifier) Defines a new field for this type.
DynamicType.Builder.FieldValueTarget<S>	defineField(String name, TypeDescription fieldTypeDescription, int modifiers) Defines a new field for this type.
DynamicType.Builder.FieldValueTarget<S>	defineField(String name, TypeDescription fieldType, ModifierContributor.ForField... modifier) Defines a new field for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineMethod(Method method) Defines a new method for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineMethod(MethodDescription methodDescription) Defines a new method for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineMethod(String name, Class<?> returnType, List<Class<?>> parameterTypes, int modifiers) Defines a new method for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineMethod(String name, Class<?> returnType, List<Class<?>> parameterTypes, ModifierContributor.ForMethod... modifier) Defines a new method for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineMethod(String name, TypeDescription returnType, List<? extends TypeDescription> parameterTypes, int modifiers) Defines a new method for this type.
DynamicType.Builder.ExceptionDeclarableMethodInterception<S>	defineMethod(String name, TypeDescription returnType, List<? extends TypeDescription> parameterTypes, ModifierContributor.ForMethod... modifier) Defines a new method for this type.
boolean	equals(Object other)
int	hashCode()
DynamicType.Builder<S>	ignoreMethods(ElementMatcher<? super MethodDescription> ignoredMethods) Defines a matcher for methods that will be ignored for any interception attempt.
DynamicType.Builder.OptionalMatchedMethodInterception<S>	implement(Class<?>... interfaceType) Adds an interface to be implemented the created type.
DynamicType.Builder.OptionalMatchedMethodInterception<S>	implement(TypeDescription... interfaceType) Adds an interface to be implemented the created type.
DynamicType.Builder.MatchedMethodInterception<S>	invokable(ElementMatcher<? super MethodDescription> methodMatcher) Selects a set of byte code level methods, i.e.
DynamicType.Builder.MatchedMethodInterception<S>	invokable(LatentMethodMatcher methodMatcher) Selects a set of byte code level methods, i.e.
protected abstract DynamicType.Builder<S>	materialize(ClassFileVersion classFileVersion, NamingStrategy namingStrategy, AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy, TypeDescription targetType, List<TypeDescription> interfaceTypes, int modifiers, TypeAttributeAppender attributeAppender, ElementMatcher<? super MethodDescription> ignoredMethods, BridgeMethodResolver.Factory bridgeMethodResolverFactory, ClassVisitorWrapper.Chain classVisitorWrapperChain, FieldRegistry fieldRegistry, MethodRegistry methodRegistry, MethodLookupEngine.Factory methodLookupEngineFactory, FieldAttributeAppender.Factory defaultFieldAttributeAppenderFactory, MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory, List<DynamicType.Builder.AbstractBase.FieldToken> fieldTokens, List<DynamicType.Builder.AbstractBase.MethodToken> methodTokens) Creates a new immutable type builder which represents the given arguments.
DynamicType.Builder.MatchedMethodInterception<S>	method(ElementMatcher<? super MethodDescription> methodMatcher) Selects a set of methods of this type for instrumentation.
DynamicType.Builder<S>	methodLookupEngine(MethodLookupEngine.Factory methodLookupEngineFactory) Defines the use of a specific factory for a MethodLookupEngine.
DynamicType.Builder<S>	modifiers(int modifiers) Defines modifiers for the created dynamic type.
DynamicType.Builder<S>	modifiers(ModifierContributor.ForType... modifier) Defines modifiers for the created dynamic type.
DynamicType.Builder<S>	name(AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy) Defines a naming strategy for naming auxiliary types.
DynamicType.Builder<S>	name(NamingStrategy namingStrategy) Names the currently created dynamic type by the given naming strategy.
DynamicType.Builder<S>	name(String name) Names the currently created dynamic type by a fixed name.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.bytebuddy.dynamic.DynamicType.Builder

make

Field Detail

classFileVersion

protected final ClassFileVersion classFileVersion

The class file version specified for this builder.

namingStrategy

protected final NamingStrategy namingStrategy

The naming strategy specified for this builder.

auxiliaryTypeNamingStrategy

protected final AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy

The naming strategy for auxiliary types specified for this builder.

targetType

protected final TypeDescription targetType

The target type description that is specified for this builder.

interfaceTypes

protected final List<TypeDescription> interfaceTypes

The interface types to implement as specified for this builder.

modifiers

protected final int modifiers

The modifiers specified for this builder.

attributeAppender

protected final TypeAttributeAppender attributeAppender

The type attribute appender specified for this builder.

ignoredMethods

protected final ElementMatcher<? super MethodDescription> ignoredMethods

The method matcher for ignored method specified for this builder.

bridgeMethodResolverFactory

protected final BridgeMethodResolver.Factory bridgeMethodResolverFactory

The bridge method resolver factory specified for this builder.

classVisitorWrapperChain

protected final ClassVisitorWrapper.Chain classVisitorWrapperChain

The class visitor wrapper chain that is applied on created types by this builder.

fieldRegistry

protected final FieldRegistry fieldRegistry

The field registry of this builder.

methodRegistry

protected final MethodRegistry methodRegistry

The method registry of this builder.

methodLookupEngineFactory

protected final MethodLookupEngine.Factory methodLookupEngineFactory

The method lookup engine factory to be used by this builder.

defaultFieldAttributeAppenderFactory

protected final FieldAttributeAppender.Factory defaultFieldAttributeAppenderFactory

The default field attribute appender factory that is automatically added to any field that is registered on this builder.

defaultMethodAttributeAppenderFactory

protected final MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory

The default method attribute appender factory that is automatically added to any field method is registered on this builder.

fieldTokens

protected final List<DynamicType.Builder.AbstractBase.FieldToken> fieldTokens

This builder's currently registered field tokens.

methodTokens

protected final List<DynamicType.Builder.AbstractBase.MethodToken> methodTokens

This builder's currently registered method tokens.

Constructor Detail

AbstractBase

protected AbstractBase(ClassFileVersion classFileVersion,
                       NamingStrategy namingStrategy,
                       AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy,
                       TypeDescription targetType,
                       List<TypeDescription> interfaceTypes,
                       int modifiers,
                       TypeAttributeAppender attributeAppender,
                       ElementMatcher<? super MethodDescription> ignoredMethods,
                       BridgeMethodResolver.Factory bridgeMethodResolverFactory,
                       ClassVisitorWrapper.Chain classVisitorWrapperChain,
                       FieldRegistry fieldRegistry,
                       MethodRegistry methodRegistry,
                       MethodLookupEngine.Factory methodLookupEngineFactory,
                       FieldAttributeAppender.Factory defaultFieldAttributeAppenderFactory,
                       MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory,
                       List<DynamicType.Builder.AbstractBase.FieldToken> fieldTokens,
                       List<DynamicType.Builder.AbstractBase.MethodToken> methodTokens)

Creates a new immutable type builder base implementation.

Parameters:

classFileVersion - The class file version for the created dynamic type.

namingStrategy - The naming strategy for naming the dynamic type.

auxiliaryTypeNamingStrategy - The naming strategy for naming auxiliary types of the dynamic type.

targetType - A description of the type that the dynamic type should represent.

interfaceTypes - A list of interfaces that should be implemented by the created dynamic type.

modifiers - The modifiers to be represented by the dynamic type.

attributeAppender - The attribute appender to apply onto the dynamic type that is created.

ignoredMethods - A matcher for determining methods that are to be ignored for instrumentation.

bridgeMethodResolverFactory - A factory for creating a bridge method resolver.

classVisitorWrapperChain - A chain of ASM class visitors to apply to the writing process.

fieldRegistry - The field registry to apply to the dynamic type creation.

methodRegistry - The method registry to apply to the dynamic type creation.

methodLookupEngineFactory - The method lookup engine factory to apply to the dynamic type creation.

defaultFieldAttributeAppenderFactory - The field attribute appender factory that should be applied by default if no specific appender was specified for a given field.

defaultMethodAttributeAppenderFactory - The method attribute appender factory that should be applied by default if no specific appender was specified for a given method.

fieldTokens - A list of field representations that were added explicitly to this dynamic type.

methodTokens - A list of method representations that were added explicitly to this dynamic type.

Method Detail

applyRecordedMembersTo

protected InstrumentedType applyRecordedMembersTo(InstrumentedType instrumentedType)

Adds all fields and methods to an instrumented type.

Parameters:

instrumentedType - The instrumented type that is basis of the alteration.

Returns:

The created instrumented type with all fields and methods applied.

implement

public DynamicType.Builder.OptionalMatchedMethodInterception<S> implement(Class<?>... interfaceType)

Description copied from interface: DynamicType.Builder

Adds an interface to be implemented the created type.

Specified by:

implement in interface DynamicType.Builder<S>

Parameters:

interfaceType - The interface to implement.

Returns:

A builder which will create a dynamic type that implements the given interface.

defineField

public DynamicType.Builder.FieldValueTarget<S> defineField(String name,
                                                           Class<?> fieldType,
                                                           ModifierContributor.ForField... modifier)

Description copied from interface: DynamicType.Builder

Defines a new field for this type.

Specified by:

defineField in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

fieldType - The type of this field where the current type can be represented by TargetType.

modifier - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineMethod

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineMethod(String name,
                                                                                 Class<?> returnType,
                                                                                 List<Class<?>> parameterTypes,
                                                                                 ModifierContributor.ForMethod... modifier)

Description copied from interface: DynamicType.Builder

Defines a new method for this type.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

defineMethod in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

returnType - The return type of the method where the current type can be represented by TargetType.

parameterTypes - The parameter types of this method where the current type can be represented by TargetType.

modifier - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineConstructor

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineConstructor(Iterable<Class<?>> parameterTypes,
                                                                                      ModifierContributor.ForMethod... modifier)

Description copied from interface: DynamicType.Builder

Defines a new constructor for this type. A constructor must not be static. Instead, a static type initializer is added automatically if such an initializer is required. See ElementMatchers.isTypeInitializer() for a matcher for this initializer which can be intercepted using DynamicType.Builder.invokable(net.bytebuddy.matcher.ElementMatcher).

Note that a constructor's implementation must call another constructor of the same class or a constructor of its super class. This constructor call must be hardcoded inside of the constructor's method body. Before this constructor call is made, it is not legal to call any methods or to read any fields of the instance under construction.

Specified by:

defineConstructor in interface DynamicType.Builder<S>

Parameters:

parameterTypes - The parameter types of this constructor where the current type can be represented by TargetType.

modifier - The modifiers for this constructor.

Returns:

An interception delegate that exclusively matches the new constructor.

classFileVersion

public DynamicType.Builder<S> classFileVersion(ClassFileVersion classFileVersion)

Description copied from interface: DynamicType.Builder

Defines a class file format version for this builder for which the dynamic types should be created.

Specified by:

classFileVersion in interface DynamicType.Builder<S>

Parameters:

classFileVersion - The class format version for the dynamic type to implement.

Returns:

A builder that writes its classes in a given class format version.

name

public DynamicType.Builder<S> name(String name)

Description copied from interface: DynamicType.Builder

Names the currently created dynamic type by a fixed name.

Specified by:

name in interface DynamicType.Builder<S>

Parameters:

name - A fully qualified name to give to the created dynamic type.

Returns:

A builder that will name its dynamic type by the given name.

name

public DynamicType.Builder<S> name(NamingStrategy namingStrategy)

Description copied from interface: DynamicType.Builder

Names the currently created dynamic type by the given naming strategy.

Specified by:

name in interface DynamicType.Builder<S>

Parameters:

namingStrategy - The naming strategy to apply.

Returns:

A builder that creates a type by applying the given naming strategy.

name

public DynamicType.Builder<S> name(AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy)

Description copied from interface: DynamicType.Builder

Defines a naming strategy for naming auxiliary types.

Specified by:

name in interface DynamicType.Builder<S>

Parameters:

auxiliaryTypeNamingStrategy - The naming strategy to use.

Returns:

This builder where the auxiliary naming strategy was set to be used.

modifiers

public DynamicType.Builder<S> modifiers(ModifierContributor.ForType... modifier)

Description copied from interface: DynamicType.Builder

Defines modifiers for the created dynamic type.

Specified by:

modifiers in interface DynamicType.Builder<S>

Parameters:

modifier - A collection of modifiers to be reflected by the created dynamic type.

Returns:

A builder that will create a dynamic type that reflects the given modifiers.

modifiers

public DynamicType.Builder<S> modifiers(int modifiers)

Description copied from interface: DynamicType.Builder

Defines modifiers for the created dynamic type.

Specified by:

modifiers in interface DynamicType.Builder<S>

Parameters:

modifiers - The modifiers to be reflected by the created dynamic type.

Returns:

A builder that will create a dynamic type that reflects the given modifiers.

ignoreMethods

public DynamicType.Builder<S> ignoreMethods(ElementMatcher<? super MethodDescription> ignoredMethods)

Description copied from interface: DynamicType.Builder

Defines a matcher for methods that will be ignored for any interception attempt. Any methods that were directly declared on an instrumented type will never be ignored, i.e. ignored methods only represent a filter for methods that are declared in super types that should never be overriden.

Specified by:

ignoreMethods in interface DynamicType.Builder<S>

Parameters:

ignoredMethods - A method matcher characterizing the methods to be ignored.

Returns:

A builder that will always ignore the methods matched by the given method matcher.

attribute

public DynamicType.Builder<S> attribute(TypeAttributeAppender attributeAppender)

Description copied from interface: DynamicType.Builder

Adds an attribute appender to the currently constructed type which will be applied on the creation of the type.

Specified by:

attribute in interface DynamicType.Builder<S>

Parameters:

attributeAppender - An attribute appender to be applied onto the currently created type.

Returns:

A builder that will apply the given attribute appender onto the currently created type.

annotateType

public DynamicType.Builder<S> annotateType(Annotation... annotation)

Description copied from interface: DynamicType.Builder

Adds annotations to the currently constructed type.

Note: The annotations will not be visible to Implementations.

Specified by:

annotateType in interface DynamicType.Builder<S>

Parameters:

annotation - The annotations to be added to the currently constructed type.

Returns:

A builder that will add the given annotation to the created type.

annotateType

public DynamicType.Builder<S> annotateType(AnnotationDescription... annotation)

Description copied from interface: DynamicType.Builder

Adds annotations to the currently constructed type.

Note: The annotations will not be visible to Implementations.

Specified by:

annotateType in interface DynamicType.Builder<S>

Parameters:

annotation - The annotations to be added to the currently constructed type.

Returns:

A builder that will add the given annotation to the created type.

classVisitor

public DynamicType.Builder<S> classVisitor(ClassVisitorWrapper classVisitorWrapper)

Description copied from interface: DynamicType.Builder

Adds an additional ASM ClassVisitor to this builder which will be applied in the construction process of this dynamic type.

Specified by:

classVisitor in interface DynamicType.Builder<S>

Parameters:

classVisitorWrapper - The wrapper delegate for the ASM class visitor.

Returns:

A builder that will apply the given ASM class visitor.

methodLookupEngine

public DynamicType.Builder<S> methodLookupEngine(MethodLookupEngine.Factory methodLookupEngineFactory)

Description copied from interface: DynamicType.Builder

Defines the use of a specific factory for a MethodLookupEngine.

Specified by:

methodLookupEngine in interface DynamicType.Builder<S>

Parameters:

methodLookupEngineFactory - The factory to be used.

Returns:

A builder that applies the given method lookup engine factory.

bridgeMethodResolverFactory

public DynamicType.Builder<S> bridgeMethodResolverFactory(BridgeMethodResolver.Factory bridgeMethodResolverFactory)

Description copied from interface: DynamicType.Builder

Defines a bridge method resolver factory to be applied to this type creation. A bridge method resolver is responsible for determining the target method that is invoked by a bridge method. This way, a super method invocation is resolved by invoking the actual super method instead of the bridge method which would in turn resolve the actual method virtually.

Specified by:

bridgeMethodResolverFactory in interface DynamicType.Builder<S>

Parameters:

bridgeMethodResolverFactory - The bridge method resolver factory that is to be used.

Returns:

A builder that will apply the given bridge method resolver factory.

implement

public DynamicType.Builder.OptionalMatchedMethodInterception<S> implement(TypeDescription... interfaceType)

Description copied from interface: DynamicType.Builder

Adds an interface to be implemented the created type.

Specified by:

implement in interface DynamicType.Builder<S>

Parameters:

interfaceType - A description of the interface to implement.

Returns:

A builder which will create a dynamic type that implements the given interface.

defineField

public DynamicType.Builder.FieldValueTarget<S> defineField(String name,
                                                           TypeDescription fieldType,
                                                           ModifierContributor.ForField... modifier)

Description copied from interface: DynamicType.Builder

Defines a new field for this type.

Specified by:

defineField in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

fieldType - The type of this field where the current type can be represented by TargetType.

modifier - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineField

public DynamicType.Builder.FieldValueTarget<S> defineField(String name,
                                                           Class<?> fieldType,
                                                           int modifiers)

Description copied from interface: DynamicType.Builder

Defines a new field for this type.

Specified by:

defineField in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

fieldType - The type of this field where the current type can be represented by TargetType.

modifiers - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineField

public DynamicType.Builder.FieldValueTarget<S> defineField(String name,
                                                           TypeDescription fieldTypeDescription,
                                                           int modifiers)

Description copied from interface: DynamicType.Builder

Defines a new field for this type.

Specified by:

defineField in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

fieldTypeDescription - The type of this field where the current type can be represented by TargetType.

modifiers - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineField

public DynamicType.Builder.FieldValueTarget<S> defineField(Field field)

Description copied from interface: DynamicType.Builder

Defines a new field for this type. The annotations of the given field are not copied and must be added manually if they are required.

Specified by:

defineField in interface DynamicType.Builder<S>

Parameters:

field - The field that the generated type should imitate.

Returns:

An interception delegate that exclusively matches the new method.

defineField

public DynamicType.Builder.FieldValueTarget<S> defineField(FieldDescription fieldDescription)

Description copied from interface: DynamicType.Builder

Defines a new field for this type. The annotations of the given field are not copied and must be added manually if they are required.

Specified by:

defineField in interface DynamicType.Builder<S>

Parameters:

fieldDescription - The field that the generated type should imitate.

Returns:

An interception delegate that exclusively matches the new method.

defineMethod

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineMethod(String name,
                                                                                 TypeDescription returnType,
                                                                                 List<? extends TypeDescription> parameterTypes,
                                                                                 ModifierContributor.ForMethod... modifier)

Description copied from interface: DynamicType.Builder

Defines a new method for this type.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

defineMethod in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

returnType - A description of the return type of the method where the current type can be represented by TargetType.

parameterTypes - Descriptions of the parameter types of this method where the current type can be represented by TargetType.

modifier - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineMethod

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineMethod(Method method)

Description copied from interface: DynamicType.Builder

Defines a new method for this type. Declared exceptions or annotations of the method are not copied and must be added manually.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

defineMethod in interface DynamicType.Builder<S>

Parameters:

method - The method that the generated type should imitate.

Returns:

An interception delegate that exclusively matches the new method.

defineMethod

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineMethod(MethodDescription methodDescription)

Description copied from interface: DynamicType.Builder

Defines a new method for this type. Declared exceptions or annotations of the method are not copied and must be added manually.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

defineMethod in interface DynamicType.Builder<S>

Parameters:

methodDescription - The method that the generated type should imitate.

Returns:

An interception delegate that exclusively matches the new method.

defineMethod

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineMethod(String name,
                                                                                 Class<?> returnType,
                                                                                 List<Class<?>> parameterTypes,
                                                                                 int modifiers)

Description copied from interface: DynamicType.Builder

Defines a new method for this type.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

defineMethod in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

returnType - The return type of the method where the current type can be represented by TargetType.

parameterTypes - The parameter types of this method where the current type can be represented by TargetType.

modifiers - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineMethod

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineMethod(String name,
                                                                                 TypeDescription returnType,
                                                                                 List<? extends TypeDescription> parameterTypes,
                                                                                 int modifiers)

Description copied from interface: DynamicType.Builder

Defines a new method for this type.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

defineMethod in interface DynamicType.Builder<S>

Parameters:

name - The name of the method.

returnType - A description of the return type of the method where the current type can be represented by TargetType.

parameterTypes - Descriptions of the parameter types of this method where the current type can be represented by TargetType.

modifiers - The modifiers for this method.

Returns:

An interception delegate that exclusively matches the new method.

defineConstructor

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineConstructor(List<? extends TypeDescription> parameterTypes,
                                                                                      ModifierContributor.ForMethod... modifier)

Description copied from interface: DynamicType.Builder

Defines a new constructor for this type. A constructor must not be static. Instead, a static type initializer is added automatically if such an initializer is required. See ElementMatchers.isTypeInitializer() for a matcher for this initializer which can be intercepted using DynamicType.Builder.invokable(net.bytebuddy.matcher.ElementMatcher).

Note that a constructor's implementation must call another constructor of the same class or a constructor of its super class. This constructor call must be hardcoded inside of the constructor's method body. Before this constructor call is made, it is not legal to call any methods or to read any fields of the instance under construction.

Specified by:

defineConstructor in interface DynamicType.Builder<S>

Parameters:

parameterTypes - The parameter types of this constructor where the current type can be represented by TargetType.

modifier - The modifiers for this constructor.

Returns:

An interception delegate that exclusively matches the new constructor.

defineConstructor

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineConstructor(Constructor<?> constructor)

Description copied from interface: DynamicType.Builder

Defines a new constructor for this type. A constructor must not be static. Instead, a static type initializer is added automatically if such an initializer is required. See ElementMatchers.isTypeInitializer() for a matcher for this initializer which can be intercepted using DynamicType.Builder.invokable(net.bytebuddy.matcher.ElementMatcher). Declared exceptions or annotations of the method are not copied and must be added manually.

Note that a constructor's implementation must call another constructor of the same class or a constructor of its super class. This constructor call must be hardcoded inside of the constructor's method body. Before this constructor call is made, it is not legal to call any methods or to read any fields of the instance under construction.

Specified by:

defineConstructor in interface DynamicType.Builder<S>

Parameters:

constructor - The constructor for the generated type to imitate.

Returns:

An interception delegate that exclusively matches the new constructor.

defineConstructor

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineConstructor(MethodDescription methodDescription)

Description copied from interface: DynamicType.Builder

Defines a new constructor for this type. A constructor must not be static. Instead, a static type initializer is added automatically if such an initializer is required. See ElementMatchers.isTypeInitializer() for a matcher for this initializer which can be intercepted using DynamicType.Builder.invokable(net.bytebuddy.matcher.ElementMatcher). Declared exceptions or annotations of the method are not copied and must be added manually.

Note that a constructor's implementation must call another constructor of the same class or a constructor of its super class. This constructor call must be hardcoded inside of the constructor's method body. Before this constructor call is made, it is not legal to call any methods or to read any fields of the instance under construction.

Specified by:

defineConstructor in interface DynamicType.Builder<S>

Parameters:

methodDescription - The constructor for the generated type to imitate.

Returns:

An interception delegate that exclusively matches the new constructor.

defineConstructor

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineConstructor(Iterable<Class<?>> parameterTypes,
                                                                                      int modifiers)

Description copied from interface: DynamicType.Builder

Defines a new constructor for this type. A constructor must not be static. Instead, a static type initializer is added automatically if such an initializer is required. See ElementMatchers.isTypeInitializer() for a matcher for this initializer which can be intercepted using DynamicType.Builder.invokable(net.bytebuddy.matcher.ElementMatcher).

Note that a constructor's implementation must call another constructor of the same class or a constructor of its super class. This constructor call must be hardcoded inside of the constructor's method body. Before this constructor call is made, it is not legal to call any methods or to read any fields of the instance under construction.

Specified by:

defineConstructor in interface DynamicType.Builder<S>

Parameters:

parameterTypes - The parameter types of this constructor where the current type can be represented by TargetType.

modifiers - The modifiers for this constructor.

Returns:

An interception delegate that exclusively matches the new constructor.

defineConstructor

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> defineConstructor(List<? extends TypeDescription> parameterTypes,
                                                                                      int modifiers)

Description copied from interface: DynamicType.Builder

Defines a new constructor for this type. A constructor must not be static. Instead, a static type initializer is added automatically if such an initializer is required. See ElementMatchers.isTypeInitializer() for a matcher for this initializer which can be intercepted using DynamicType.Builder.invokable(net.bytebuddy.matcher.ElementMatcher).

Note that a constructor's implementation must call another constructor of the same class or a constructor of its super class. This constructor call must be hardcoded inside of the constructor's method body. Before this constructor call is made, it is not legal to call any methods or to read any fields of the instance under construction.

Specified by:

defineConstructor in interface DynamicType.Builder<S>

Parameters:

parameterTypes - The parameter types of this constructor where the current type can be represented by TargetType.

modifiers - The modifiers for this constructor.

Returns:

An interception delegate that exclusively matches the new constructor.

define

public DynamicType.Builder.ExceptionDeclarableMethodInterception<S> define(MethodDescription methodDescription)

Description copied from interface: DynamicType.Builder

Defines a new method or constructor for this type. Declared exceptions or annotations of the method are not copied and must be added manually.

Note that a method definition overrides any method of identical signature that was defined in a super type what is only valid if the method is of at least broader visibility and if the overridden method is not final.

Specified by:

define in interface DynamicType.Builder<S>

Parameters:

methodDescription - The method tor constructor hat the generated type should imitate.

Returns:

An interception delegate that exclusively matches the new method or constructor.

method

public DynamicType.Builder.MatchedMethodInterception<S> method(ElementMatcher<? super MethodDescription> methodMatcher)

Description copied from interface: DynamicType.Builder

Selects a set of methods of this type for instrumentation.

Specified by:

method in interface DynamicType.Builder<S>

Parameters:

methodMatcher - A matcher describing the methods to be intercepted by this instrumentation.

Returns:

An interception delegate for methods matching the given method matcher.

constructor

public DynamicType.Builder.MatchedMethodInterception<S> constructor(ElementMatcher<? super MethodDescription> methodMatcher)

Description copied from interface: DynamicType.Builder

Selects a set of constructors of this type for implementation.

Specified by:

constructor in interface DynamicType.Builder<S>

Parameters:

methodMatcher - A matcher describing the constructors to be intercepted by this implementation.

Returns:

An interception delegate for constructors matching the given method matcher.

invokable

public DynamicType.Builder.MatchedMethodInterception<S> invokable(ElementMatcher<? super MethodDescription> methodMatcher)

Description copied from interface: DynamicType.Builder

Selects a set of byte code level methods, i.e. methods, constructors and the type initializer of this type for implementation.

Specified by:

invokable in interface DynamicType.Builder<S>

Parameters:

methodMatcher - A matcher describing the byte code methods to be intercepted by this implementation.

Returns:

An interception delegate for byte code methods matching the given method matcher.

invokable

public DynamicType.Builder.MatchedMethodInterception<S> invokable(LatentMethodMatcher methodMatcher)

Description copied from interface: DynamicType.Builder

Selects a set of byte code level methods, i.e. methods, construcors and the type initializer of this type for implementation.

Specified by:

invokable in interface DynamicType.Builder<S>

Parameters:

methodMatcher - A latent matcher describing the byte code methods to be intercepted by this implementation.

Returns:

An interception delegate for byte code methods matching the given method matcher.

materialize

protected abstract DynamicType.Builder<S> materialize(ClassFileVersion classFileVersion,
                                                      NamingStrategy namingStrategy,
                                                      AuxiliaryType.NamingStrategy auxiliaryTypeNamingStrategy,
                                                      TypeDescription targetType,
                                                      List<TypeDescription> interfaceTypes,
                                                      int modifiers,
                                                      TypeAttributeAppender attributeAppender,
                                                      ElementMatcher<? super MethodDescription> ignoredMethods,
                                                      BridgeMethodResolver.Factory bridgeMethodResolverFactory,
                                                      ClassVisitorWrapper.Chain classVisitorWrapperChain,
                                                      FieldRegistry fieldRegistry,
                                                      MethodRegistry methodRegistry,
                                                      MethodLookupEngine.Factory methodLookupEngineFactory,
                                                      FieldAttributeAppender.Factory defaultFieldAttributeAppenderFactory,
                                                      MethodAttributeAppender.Factory defaultMethodAttributeAppenderFactory,
                                                      List<DynamicType.Builder.AbstractBase.FieldToken> fieldTokens,
                                                      List<DynamicType.Builder.AbstractBase.MethodToken> methodTokens)

Creates a new immutable type builder which represents the given arguments.

Parameters:

classFileVersion - The class file version for the created dynamic type.

namingStrategy - The naming strategy for naming the dynamic type.

auxiliaryTypeNamingStrategy - The naming strategy for naming the auxiliary type of the dynamic type.

targetType - A description of the type that the dynamic type should represent.

interfaceTypes - A list of interfaces that should be implemented by the created dynamic type.

modifiers - The modifiers to be represented by the dynamic type.

attributeAppender - The attribute appender to apply onto the dynamic type that is created.

ignoredMethods - A matcher for determining methods that are to be ignored for implementation.

bridgeMethodResolverFactory - A factory for creating a bridge method resolver.

classVisitorWrapperChain - A chain of ASM class visitors to apply to the writing process.

fieldRegistry - The field registry to apply to the dynamic type creation.

methodRegistry - The method registry to apply to the dynamic type creation.

methodLookupEngineFactory - The method lookup engine factory to apply to the dynamic type creation.

defaultFieldAttributeAppenderFactory - The field attribute appender factory that should be applied by default if no specific appender was specified for a given field.

defaultMethodAttributeAppenderFactory - The method attribute appender factory that should be applied by default if no specific appender was specified for a given method.

fieldTokens - A list of field representations that were added explicitly to this dynamic type.

methodTokens - A list of method representations that were added explicitly to this dynamic type.

Returns:

A dynamic type builder that represents the given arguments.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object