net.bytebuddy.instrumentation.method.bytecode.stack

Interface StackManipulation

All Known Subinterfaces:

ArrayFactory.ArrayCreator, Instrumentation.SpecialMethodInvocation, MethodConstant.CanCache, MethodDelegationBinder.MethodBinding, MethodDelegationBinder.ParameterBinding<T>, MethodInvocation.WithImplicitInvocationTargetType

All Known Implementing Classes:

ArrayFactory.ArrayCreator.Primitive, ArrayFactory.ArrayCreator.Reference, ClassConstant, DefaultValue, DoubleConstant, DownCasting, Duplication, FloatConstant, Instrumentation.SpecialMethodInvocation.Illegal, Instrumentation.SpecialMethodInvocation.Simple, IntegerConstant, LongConstant, MethodCallProxy.AssignableSignatureCall, MethodConstant, MethodDelegationBinder.MethodBinding.Illegal, MethodDelegationBinder.ParameterBinding.Anonymous, MethodDelegationBinder.ParameterBinding.Illegal, MethodDelegationBinder.ParameterBinding.Unique, MethodHandleConstant, MethodReturn, MethodTypeConstant, NullConstant, Pipe.Binder.Redirection, PrimitiveUnboxingDelegate, RebaseInstrumentationTarget.RebasedMethodSpecialMethodInvocation, StackManipulation.Compound, StackManipulation.Illegal, StackManipulation.LegalTrivial, TextConstant, Throw, TypeCreation, TypeProxy.ByConstructor, TypeProxy.ByReflectionFactory

public interface StackManipulation

Describes a manipulation of a method's operand stack that does not affect the frame's variable array.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	StackManipulation.Compound An immutable stack manipulation that aggregates a sequence of other stack manipulations.
static class	StackManipulation.Illegal Canonical representation of an illegal stack manipulation.
static class	StackManipulation.LegalTrivial Canonical representation of a legal stack manipulation which does not require any action.
static class	StackManipulation.Size A description of the size change that is imposed by some StackManipulation.

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.
boolean	isValid() Determines if this stack manipulation is valid.

Method Detail

isValid

boolean isValid()

Determines if this stack manipulation is valid.

Returns:

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

apply

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

Applies the stack manipulation that is described by this instance.

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.