net.bytebuddy.asm

Class Advice.Dispatcher.Inlining.Resolved.ForMethodExit

java.lang.Object

net.bytebuddy.asm.Advice.Dispatcher.Resolved.AbstractBase

net.bytebuddy.asm.Advice.Dispatcher.Inlining.Resolved

net.bytebuddy.asm.Advice.Dispatcher.Inlining.Resolved.ForMethodExit

All Implemented Interfaces:

Advice.Dispatcher, Advice.Dispatcher.Resolved, Advice.Dispatcher.Resolved.ForMethodExit

Direct Known Subclasses:

Advice.Dispatcher.Inlining.Resolved.ForMethodExit.WithExceptionHandler, Advice.Dispatcher.Inlining.Resolved.ForMethodExit.WithoutExceptionHandler

Enclosing class:

Advice.Dispatcher.Inlining.Resolved

@HashCodeAndEqualsPlugin.Enhance
protected abstract static class Advice.Dispatcher.Inlining.Resolved.ForMethodExit
extends Advice.Dispatcher.Inlining.Resolved
implements Advice.Dispatcher.Resolved.ForMethodExit

A resolved dispatcher for implementing method exit advice.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	Advice.Dispatcher.Inlining.Resolved.ForMethodExit.WithExceptionHandler Implementation of exit advice that handles exceptions.
protected static class	Advice.Dispatcher.Inlining.Resolved.ForMethodExit.WithoutExceptionHandler Implementation of exit advice that ignores exceptions.

Nested classes/interfaces inherited from class net.bytebuddy.asm.Advice.Dispatcher.Inlining.Resolved

Advice.Dispatcher.Inlining.Resolved.AdviceMethodInliner, Advice.Dispatcher.Inlining.Resolved.ForMethodEnter, Advice.Dispatcher.Inlining.Resolved.ForMethodExit

Nested classes/interfaces inherited from interface net.bytebuddy.asm.Advice.Dispatcher.Resolved

Advice.Dispatcher.Resolved.AbstractBase, Advice.Dispatcher.Resolved.ForMethodEnter, Advice.Dispatcher.Resolved.ForMethodExit

Nested classes/interfaces inherited from interface net.bytebuddy.asm.Advice.Dispatcher

Advice.Dispatcher.Bound, Advice.Dispatcher.Delegating, Advice.Dispatcher.Inactive, Advice.Dispatcher.Inlining, Advice.Dispatcher.RelocationHandler, Advice.Dispatcher.Resolved, Advice.Dispatcher.SuppressionHandler, Advice.Dispatcher.Unresolved

Field Summary

Fields inherited from class net.bytebuddy.asm.Advice.Dispatcher.Inlining.Resolved

classReader

Fields inherited from class net.bytebuddy.asm.Advice.Dispatcher.Resolved.AbstractBase

adviceMethod, offsetMappings, relocationHandler, suppressionHandler

Fields inherited from interface net.bytebuddy.asm.Advice.Dispatcher

IGNORE_ANNOTATION, IGNORE_METHOD

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForMethodExit(MethodDescription.InDefinedShape adviceMethod, Map<String,TypeDefinition> namedTypes, List<? extends Advice.OffsetMapping.Factory<?>> userFactories, ClassReader classReader, TypeDefinition enterType) Creates a new resolved dispatcher for implementing method exit advice.

Method Summary

Modifier and Type	Method and Description
protected MethodVisitor	apply(MethodVisitor methodVisitor, Implementation.Context implementationContext, Assigner assigner, Advice.ArgumentHandler.ForInstrumentedMethod argumentHandler, Advice.MethodSizeHandler.ForInstrumentedMethod methodSizeHandler, Advice.StackMapFrameHandler.ForInstrumentedMethod stackMapFrameHandler, TypeDescription instrumentedType, MethodDescription instrumentedMethod, Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler, Advice.Dispatcher.RelocationHandler.Bound relocationHandler) Applies a resolution for a given instrumented method.
Advice.Dispatcher.Bound	bind(TypeDescription instrumentedType, MethodDescription instrumentedMethod, MethodVisitor methodVisitor, Implementation.Context implementationContext, Assigner assigner, Advice.ArgumentHandler.ForInstrumentedMethod argumentHandler, Advice.MethodSizeHandler.ForInstrumentedMethod methodSizeHandler, Advice.StackMapFrameHandler.ForInstrumentedMethod stackMapFrameHandler, StackManipulation exceptionHandler, Advice.Dispatcher.RelocationHandler.Relocation relocation) Binds this dispatcher for resolution to a specific method.
TypeDefinition	getAdviceType() The type that is produced as a result of executing this advice method.
Advice.ArgumentHandler.Factory	getArgumentHandlerFactory() Returns a factory for creating an Advice.ArgumentHandler.
protected static Advice.Dispatcher.Resolved.ForMethodExit	of(MethodDescription.InDefinedShape adviceMethod, Map<String,TypeDefinition> namedTypes, List<? extends Advice.OffsetMapping.Factory<?>> userFactories, ClassReader classReader, TypeDefinition enterType) Resolves exit advice that handles exceptions depending on the specification of the exit advice.
protected Map<Integer,TypeDefinition>	resolveInitializationTypes(Advice.ArgumentHandler argumentHandler) Resolves the initialization types of this advice method.

Methods inherited from class net.bytebuddy.asm.Advice.Dispatcher.Resolved.AbstractBase

isAlive

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.bytebuddy.asm.Advice.Dispatcher.Resolved.ForMethodExit

getThrowable

Methods inherited from interface net.bytebuddy.asm.Advice.Dispatcher

isAlive

Constructor Detail

ForMethodExit

protected ForMethodExit(MethodDescription.InDefinedShape adviceMethod,
                        Map<String,TypeDefinition> namedTypes,
                        List<? extends Advice.OffsetMapping.Factory<?>> userFactories,
                        ClassReader classReader,
                        TypeDefinition enterType)

Creates a new resolved dispatcher for implementing method exit advice.

Parameters:

adviceMethod - The represented advice method.

namedTypes - A mapping of all available local variables by their name to their type.

userFactories - A list of user-defined factories for offset mappings.

classReader - The class reader for parsing the advice method's class file.

enterType - The type of the value supplied by the enter advice method or void if no such value exists.

Method Detail

of

protected static Advice.Dispatcher.Resolved.ForMethodExit of(MethodDescription.InDefinedShape adviceMethod,
                                                             Map<String,TypeDefinition> namedTypes,
                                                             List<? extends Advice.OffsetMapping.Factory<?>> userFactories,
                                                             ClassReader classReader,
                                                             TypeDefinition enterType)

Resolves exit advice that handles exceptions depending on the specification of the exit advice.

Parameters:

adviceMethod - The advice method.

namedTypes - A mapping of all available local variables by their name to their type.

userFactories - A list of user-defined factories for offset mappings.

classReader - The class reader for parsing the advice method's class file.

enterType - The type of the value supplied by the enter advice method or void if no such value exists.

Returns:

An appropriate exit handler.

resolveInitializationTypes

protected Map<Integer,TypeDefinition> resolveInitializationTypes(Advice.ArgumentHandler argumentHandler)

Description copied from class: Advice.Dispatcher.Inlining.Resolved

Resolves the initialization types of this advice method.

Specified by:

resolveInitializationTypes in class Advice.Dispatcher.Inlining.Resolved

Parameters:

argumentHandler - The argument handler to use for resolving the initialization.

Returns:

A mapping of parameter offsets to the type to initialize.

apply

protected MethodVisitor apply(MethodVisitor methodVisitor,
                              Implementation.Context implementationContext,
                              Assigner assigner,
                              Advice.ArgumentHandler.ForInstrumentedMethod argumentHandler,
                              Advice.MethodSizeHandler.ForInstrumentedMethod methodSizeHandler,
                              Advice.StackMapFrameHandler.ForInstrumentedMethod stackMapFrameHandler,
                              TypeDescription instrumentedType,
                              MethodDescription instrumentedMethod,
                              Advice.Dispatcher.SuppressionHandler.Bound suppressionHandler,
                              Advice.Dispatcher.RelocationHandler.Bound relocationHandler)

Description copied from class: Advice.Dispatcher.Inlining.Resolved

Applies a resolution for a given instrumented method.

Specified by:

apply in class Advice.Dispatcher.Inlining.Resolved

Parameters:

methodVisitor - A method visitor for writing byte code to the instrumented method.

implementationContext - The implementation context to use.

assigner - The assigner to use.

argumentHandler - A handler for accessing values on the local variable array.

methodSizeHandler - A handler for computing the method size requirements.

stackMapFrameHandler - A handler for translating and injecting stack map frames.

instrumentedType - A description of the instrumented type.

instrumentedMethod - A description of the instrumented method.

suppressionHandler - A bound suppression handler that is used for suppressing exceptions of this advice method.

relocationHandler - A bound relocation handler that is responsible for considering a non-standard control flow.

Returns:

A method visitor for visiting the advice method's byte code.

getArgumentHandlerFactory

public Advice.ArgumentHandler.Factory getArgumentHandlerFactory()

Returns a factory for creating an Advice.ArgumentHandler.

Specified by:

getArgumentHandlerFactory in interface Advice.Dispatcher.Resolved.ForMethodExit

Returns:

A factory for creating an Advice.ArgumentHandler.

getAdviceType

public TypeDefinition getAdviceType()

The type that is produced as a result of executing this advice method.

Specified by:

getAdviceType in interface Advice.Dispatcher

Returns:

A description of the type that is produced by this advice method.

bind

public Advice.Dispatcher.Bound bind(TypeDescription instrumentedType,
                                    MethodDescription instrumentedMethod,
                                    MethodVisitor methodVisitor,
                                    Implementation.Context implementationContext,
                                    Assigner assigner,
                                    Advice.ArgumentHandler.ForInstrumentedMethod argumentHandler,
                                    Advice.MethodSizeHandler.ForInstrumentedMethod methodSizeHandler,
                                    Advice.StackMapFrameHandler.ForInstrumentedMethod stackMapFrameHandler,
                                    StackManipulation exceptionHandler,
                                    Advice.Dispatcher.RelocationHandler.Relocation relocation)

Binds this dispatcher for resolution to a specific method.

Specified by:

bind in interface Advice.Dispatcher.Resolved

Parameters:

instrumentedType - The instrumented type.

instrumentedMethod - The instrumented method.

methodVisitor - The method visitor for writing the instrumented method.

implementationContext - The implementation context to use.

assigner - The assigner to use.

argumentHandler - A handler for accessing values on the local variable array.

methodSizeHandler - A handler for computing the method size requirements.

stackMapFrameHandler - A handler for translating and injecting stack map frames.

exceptionHandler - The stack manipulation to apply within a suppression handler.

relocation - A relocation to use with a relocation handler.

Returns:

A dispatcher that is bound to the instrumented method.