net.bytebuddy.instrumentation.method.bytecode.stack.member

Class MethodInvocation.Invocation

java.lang.Object

net.bytebuddy.instrumentation.method.bytecode.stack.member.MethodInvocation.Invocation

All Implemented Interfaces:

MethodInvocation.WithImplicitInvocationTargetType, StackManipulation

Enclosing class:

MethodInvocation

protected class MethodInvocation.Invocation
extends Object
implements MethodInvocation.WithImplicitInvocationTargetType

An implementation of a method invoking stack manipulation.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.instrumentation.method.bytecode.stack.StackManipulation

StackManipulation.Compound, StackManipulation.Illegal, StackManipulation.LegalTrivial, StackManipulation.Size

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Invocation(MethodDescription methodDescription) Creates an invocation of a given method on its declaring type as an invocation target.
protected	Invocation(MethodDescription methodDescription, TypeDescription typeDescription) Creates an invocation of a given method on a given invocation target type.

Method Summary

Modifier and Type	Method and Description
StackManipulation.Size	apply(org.objectweb.asm.MethodVisitor methodVisitor, Instrumentation.Context instrumentationContext) Applies the stack manipulation that is described by this instance.
StackManipulation	dynamic(String methodName, TypeDescription returnType, List<? extends TypeDescription> methodType, List<?> arguments) Invokes the method as a bootstrap method to bind a call site with the given properties.
boolean	equals(Object other)
int	hashCode()
boolean	isValid() Determines if this stack manipulation is valid.
StackManipulation	special(TypeDescription invocationTarget) Transforms this method invocation into a special invocation on the given type.
String	toString()
StackManipulation	virtual(TypeDescription invocationTarget) Transforms this method invocation into a virtual (or interface) method invocation on the given type.

Methods inherited from class java.lang.Object

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

Constructor Detail

Invocation

protected Invocation(MethodDescription methodDescription)

Creates an invocation of a given method on its declaring type as an invocation target.

Parameters:

methodDescription - The method to be invoked.

Invocation

protected Invocation(MethodDescription methodDescription,
                     TypeDescription typeDescription)

Creates an invocation of a given method on a given invocation target type.

Parameters:

methodDescription - The method to be invoked.

typeDescription - The type on which this method is to be invoked.

Method Detail

isValid

public boolean isValid()

Description copied from interface: StackManipulation

Determines if this stack manipulation is valid.

Specified by:

isValid in interface StackManipulation

Returns:

If false, this manipulation cannot be applied and should throw an exception.

apply

public StackManipulation.Size apply(org.objectweb.asm.MethodVisitor methodVisitor,
                                    Instrumentation.Context instrumentationContext)

Description copied from interface: StackManipulation

Applies the stack manipulation that is described by this instance.

Specified by:

apply in interface StackManipulation

Parameters:

methodVisitor - The method visitor used to write the method implementation to.

instrumentationContext - The context of the current instrumentation.

Returns:

The changes to the size of the operand stack that are implied by this stack manipulation.

virtual

public StackManipulation virtual(TypeDescription invocationTarget)

Description copied from interface: MethodInvocation.WithImplicitInvocationTargetType

Transforms this method invocation into a virtual (or interface) method invocation on the given type.

Specified by:

virtual in interface MethodInvocation.WithImplicitInvocationTargetType

Parameters:

invocationTarget - The type on which the method is to be invoked virtually on.

Returns:

A stack manipulation representing this method invocation.

special

public StackManipulation special(TypeDescription invocationTarget)

Description copied from interface: MethodInvocation.WithImplicitInvocationTargetType

Transforms this method invocation into a special invocation on the given type.

Specified by:

special in interface MethodInvocation.WithImplicitInvocationTargetType

Parameters:

invocationTarget - The type on which the method is to be invoked specially on.

Returns:

A stack manipulation representing this method invocation.

dynamic

public StackManipulation dynamic(String methodName,
                                 TypeDescription returnType,
                                 List<? extends TypeDescription> methodType,
                                 List<?> arguments)

Description copied from interface: MethodInvocation.WithImplicitInvocationTargetType

Invokes the method as a bootstrap method to bind a call site with the given properties. Note that the Java virtual machine currently only knows how to resolve bootstrap methods that link static methods or a constructor.

Specified by:

dynamic in interface MethodInvocation.WithImplicitInvocationTargetType

Parameters:

methodName - The name of the method to be bound.

returnType - The return type of the method to be bound.

methodType - The parameter types of the method to be bound.

arguments - The arguments to be passed to the bootstrap method.

Returns:

A stack manipulation that represents the dynamic method invocation.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object