net.bytebuddy.implementation

Class InvokeDynamic.AbstractDelegator

java.lang.Object

net.bytebuddy.implementation.InvokeDynamic

net.bytebuddy.implementation.InvokeDynamic.AbstractDelegator

All Implemented Interfaces:

InstrumentedType.Prepareable, Implementation, Implementation.Composable

Direct Known Subclasses:

InvokeDynamic.WithImplicitArguments, InvokeDynamic.WithImplicitArgumentType, InvokeDynamic.WithImplicitFieldType

Enclosing class:

InvokeDynamic

protected abstract static class InvokeDynamic.AbstractDelegator
extends InvokeDynamic

An abstract delegator that allows to specify a configuration for any specification of an argument.

Nested Class Summary

Nested classes/interfaces inherited from class net.bytebuddy.implementation.InvokeDynamic

InvokeDynamic.AbstractDelegator, InvokeDynamic.Appender, InvokeDynamic.InvocationProvider, InvokeDynamic.TerminationHandler, InvokeDynamic.WithImplicitArguments, InvokeDynamic.WithImplicitArgumentType, InvokeDynamic.WithImplicitFieldType, InvokeDynamic.WithImplicitTarget

Nested classes/interfaces inherited from interface net.bytebuddy.implementation.Implementation

Implementation.Composable, Implementation.Compound, Implementation.Context, Implementation.Simple, Implementation.SpecialMethodInvocation, Implementation.Target

Field Summary

Fields inherited from class net.bytebuddy.implementation.InvokeDynamic

assigner, bootstrapMethod, handleArguments, invocationProvider, terminationHandler, typing

Constructor Summary

Constructors

Constructor and Description
AbstractDelegator(MethodDescription.InDefinedShape bootstrapMethod, List<?> handleArguments, InvokeDynamic.InvocationProvider invocationProvider, InvokeDynamic.TerminationHandler terminationHandler, Assigner assigner, Assigner.Typing typing) Creates a new abstract delegator for a dynamic method invocation.

Method Summary

Modifier and Type	Method and Description
protected abstract InvokeDynamic	materialize() Resolves the current configuration into a fully initialized invoke dynamic instance.
InvokeDynamic	withArgument(int... index) Passes parameters of the instrumented method to the bootstrapped method.
InvokeDynamic.WithImplicitArgumentType	withArgument(int index) Passes a parameter of the instrumented method to the bootstrapped method.
InvokeDynamic	withBooleanValue(boolean... value) Requires the bootstrap method to bootstrap a method that takes the specified boolean arguments as its next parameters.
InvokeDynamic	withByteValue(byte... value) Requires the bootstrap method to bootstrap a method that takes the specified byte arguments as its next parameters.
InvokeDynamic	withCharacterValue(char... value) Requires the bootstrap method to bootstrap a method that takes the specified char arguments as its next parameters.
InvokeDynamic	withDoubleValue(double... value) Requires the bootstrap method to bootstrap a method that takes the specified double arguments as its next parameters.
InvokeDynamic	withField(String... fieldName) Passes the values of the specified fields to the bootstrap method.
InvokeDynamic	withFloatValue(float... value) Requires the bootstrap method to bootstrap a method that takes the specified float arguments as its next parameters.
InvokeDynamic	withImplicitAndMethodArguments() Adds a potential this reference and all method arguments to the the bootstrapped method.
InvokeDynamic	withInstance(JavaInstance... javaInstance) Hands the provided Java instance to the dynamically bound method.
InvokeDynamic	withInstanceField(String fieldName, Type fieldType) Passes the value of the specified instance field to the bootstrapped method.
InvokeDynamic	withInstanceField(String fieldName, TypeDefinition fieldType) Passes the value of the specified instance field to the bootstrapped method.
InvokeDynamic	withIntegerValue(int... value) Requires the bootstrap method to bootstrap a method that takes the specified int arguments as its next parameters.
InvokeDynamic	withLongValue(long... value) Requires the bootstrap method to bootstrap a method that takes the specified long arguments as its next parameters.
InvokeDynamic	withMethodArguments() Adds all method arguments to the the bootstrapped method.
InvokeDynamic	withNullValue(Class<?>... type) Passes null values of the given types to the bootstrapped method.
InvokeDynamic	withNullValue(TypeDescription... typeDescription) Passes null values of the given types to the bootstrapped method.
InvokeDynamic	withReference(Object... value) Requires the bootstrap method to bootstrap a method that takes the specified arguments as its next parameters.
InvokeDynamic.WithImplicitFieldType	withReference(Object value) Requires the bootstrap method to bootstrap a method that takes the specified argument as its next parameter while allowing to specify the value to be of a different type than the actual instance type.
InvokeDynamic	withShortValue(short... value) Requires the bootstrap method to bootstrap a method that takes the specified short arguments as its next parameters.
InvokeDynamic	withThis(Class<?>... type) Passes references to this onto the operand stack where the instance is represented as the given types.
InvokeDynamic	withThis(TypeDescription... typeDescription) Passes references to this onto the operand stack where the instance is represented as the given types.
InvokeDynamic	withType(TypeDescription... typeDescription) Hands the provided types to the dynamically bound method.
InvokeDynamic	withValue(Object... value) Requires the bootstrap method to bootstrap a method that takes the specified arguments as its next parameters.

Methods inherited from class net.bytebuddy.implementation.InvokeDynamic

andThen, appender, bootstrap, bootstrap, bootstrap, bootstrap, bootstrap, bootstrap, equals, getInvocationProvider, hashCode, prepare, toString, withAssigner, withEnumeration

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDelegator

public AbstractDelegator(MethodDescription.InDefinedShape bootstrapMethod,
                         List<?> handleArguments,
                         InvokeDynamic.InvocationProvider invocationProvider,
                         InvokeDynamic.TerminationHandler terminationHandler,
                         Assigner assigner,
                         Assigner.Typing typing)

Creates a new abstract delegator for a dynamic method invocation.

Parameters:

bootstrapMethod - The bootstrap method.

handleArguments - The arguments that are provided to the bootstrap method.

invocationProvider - The target provided that identifies the method to be bootstrapped.

terminationHandler - A handler that handles the method return.

assigner - The assigner to be used.

typing - Indicates if dynamic type castings should be attempted for incompatible assignments.

Method Detail

materialize

protected abstract InvokeDynamic materialize()

Resolves the current configuration into a fully initialized invoke dynamic instance.

Returns:

The fully resolved invoke dynamic instance.

withBooleanValue

public InvokeDynamic withBooleanValue(boolean... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified boolean arguments as its next parameters.

Overrides:

withBooleanValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withByteValue

public InvokeDynamic withByteValue(byte... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified byte arguments as its next parameters.

Overrides:

withByteValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withShortValue

public InvokeDynamic withShortValue(short... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified short arguments as its next parameters.

Overrides:

withShortValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withCharacterValue

public InvokeDynamic withCharacterValue(char... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified char arguments as its next parameters.

Overrides:

withCharacterValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withIntegerValue

public InvokeDynamic withIntegerValue(int... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified int arguments as its next parameters.

Overrides:

withIntegerValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withLongValue

public InvokeDynamic withLongValue(long... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified long arguments as its next parameters.

Overrides:

withLongValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withFloatValue

public InvokeDynamic withFloatValue(float... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified float arguments as its next parameters.

Overrides:

withFloatValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withDoubleValue

public InvokeDynamic withDoubleValue(double... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified double arguments as its next parameters.

Overrides:

withDoubleValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withValue

public InvokeDynamic withValue(Object... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified arguments as its next parameters. Note that any primitive parameters are passed as their wrapper types. Furthermore, values that can be stored in the instrumented class's constant pool might be of different object identity when passed to the bootstrapped method or might not be visible to the the created class what later results in a runtime error.

Overrides:

withValue in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withReference

public InvokeDynamic.WithImplicitFieldType withReference(Object value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified argument as its next parameter while allowing to specify the value to be of a different type than the actual instance type.

Overrides:

withReference in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withReference

public InvokeDynamic withReference(Object... value)

Description copied from class: InvokeDynamic

Requires the bootstrap method to bootstrap a method that takes the specified arguments as its next parameters. Note that any primitive parameters are passed as their wrapper types. Any value that is passed to the bootstrapped method is guaranteed to be of the same object identity.

Overrides:

withReference in class InvokeDynamic

Parameters:

value - The arguments to pass to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withType

public InvokeDynamic withType(TypeDescription... typeDescription)

Description copied from class: InvokeDynamic

Hands the provided types to the dynamically bound method. The type is stored in the generated class's constant pool and is loaded at invocation time. For this to be possible, the created class's class loader must be able to see the provided type.

Overrides:

withType in class InvokeDynamic

Parameters:

typeDescription - The classes to provide to the bound method as an argument.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified type.

withInstance

public InvokeDynamic withInstance(JavaInstance... javaInstance)

Description copied from class: InvokeDynamic

Hands the provided Java instance to the dynamically bound method. The instance is stored in the generated class's constant pool and is loaded at invocation time. For this to be possible, the created class's class loader must be able to create the provided Java instance.

Overrides:

withInstance in class InvokeDynamic

Parameters:

javaInstance - The Java instance to provide to the bound method as an argument.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified Java instance.

withNullValue

public InvokeDynamic withNullValue(Class<?>... type)

Description copied from class: InvokeDynamic

Passes null values of the given types to the bootstrapped method.

Overrides:

withNullValue in class InvokeDynamic

Parameters:

type - The type that the null values should represent.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withNullValue

public InvokeDynamic withNullValue(TypeDescription... typeDescription)

Description copied from class: InvokeDynamic

Passes null values of the given types to the bootstrapped method.

Overrides:

withNullValue in class InvokeDynamic

Parameters:

typeDescription - The type that the null values should represent.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withArgument

public InvokeDynamic withArgument(int... index)

Description copied from class: InvokeDynamic

Passes parameters of the instrumented method to the bootstrapped method.

Overrides:

withArgument in class InvokeDynamic

Parameters:

index - The indices of the parameters that should be passed to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.

withArgument

public InvokeDynamic.WithImplicitArgumentType withArgument(int index)

Description copied from class: InvokeDynamic

Passes a parameter of the instrumented method to the bootstrapped method.

Overrides:

withArgument in class InvokeDynamic

Parameters:

index - The index of the parameter that should be passed to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified argument with its implicit type.

withThis

public InvokeDynamic withThis(Class<?>... type)

Description copied from class: InvokeDynamic

Passes references to this onto the operand stack where the instance is represented as the given types.

Overrides:

withThis in class InvokeDynamic

Parameters:

type - The types as which the this reference of the intercepted method should be masked.

Returns:

This implementation where this references are passed as the next arguments.

withThis

public InvokeDynamic withThis(TypeDescription... typeDescription)

Description copied from class: InvokeDynamic

Passes references to this onto the operand stack where the instance is represented as the given types.

Overrides:

withThis in class InvokeDynamic

Parameters:

typeDescription - The types as which the this reference of the intercepted method should be masked.

Returns:

This implementation where this references are passed as the next arguments.

withMethodArguments

public InvokeDynamic withMethodArguments()

Description copied from class: InvokeDynamic

Adds all method arguments to the the bootstrapped method.

Overrides:

withMethodArguments in class InvokeDynamic

Returns:

This invoke dynamic implementation with all parameters of the instrumented method added.

withImplicitAndMethodArguments

public InvokeDynamic withImplicitAndMethodArguments()

Description copied from class: InvokeDynamic

Adds a potential this reference and all method arguments to the the bootstrapped method.

Overrides:

withImplicitAndMethodArguments in class InvokeDynamic

Returns:

This invoke dynamic implementation with a potential this reference and all parameters of the instrumented method added.

withInstanceField

public InvokeDynamic withInstanceField(String fieldName,
                                       Type fieldType)

Description copied from class: InvokeDynamic

Passes the value of the specified instance field to the bootstrapped method. The field value of the created private field must be set manually on any instrumented instance.

Overrides:

withInstanceField in class InvokeDynamic

Parameters:

fieldName - The name of the field.

fieldType - The type of the field.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the value of the defined field.

withInstanceField

public InvokeDynamic withInstanceField(String fieldName,
                                       TypeDefinition fieldType)

Description copied from class: InvokeDynamic

Passes the value of the specified instance field to the bootstrapped method. The field value of the created private field must be set manually on any instrumented instance.

Overrides:

withInstanceField in class InvokeDynamic

Parameters:

fieldName - The name of the field.

fieldType - The type of the field.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the value of the defined field.

withField

public InvokeDynamic withField(String... fieldName)

Description copied from class: InvokeDynamic

Passes the values of the specified fields to the bootstrap method. Any of the specified fields must already exist for the instrumented type.

Overrides:

withField in class InvokeDynamic

Parameters:

fieldName - The names of the fields to be passed to the bootstrapped method.

Returns:

This invoke dynamic implementation where the bootstrapped method is passed the specified arguments.