net.bytebuddy.instrumentation

Class InvocationHandlerAdapter

java.lang.Object

net.bytebuddy.instrumentation.InvocationHandlerAdapter

All Implemented Interfaces:

Instrumentation

public abstract class InvocationHandlerAdapter
extends Object
implements Instrumentation

An adapter for adapting an InvocationHandler. The adapter allows the invocation handler to also intercept method calls to non-interface methods.

Nested Class Summary

Nested classes/interfaces inherited from interface net.bytebuddy.instrumentation.Instrumentation

Instrumentation.Compound, Instrumentation.Context, Instrumentation.ForAbstractMethod

Field Summary

Fields

Modifier and Type	Field and Description
protected Assigner	assigner The assigner that is used for assigning the return invocation handler's return value to the intercepted method's return value.
protected String	fieldName The name of the field for storing an invocation handler.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InvocationHandlerAdapter(String fieldName) Creates a new invocation handler for a given field.

Method Summary

Modifier and Type	Method and Description
protected ByteCodeAppender.Size	apply(org.objectweb.asm.MethodVisitor methodVisitor, Instrumentation.Context instrumentationContext, MethodDescription instrumentedMethod, TypeDescription instrumentedType, StackManipulation preparingManipulation) Applies an instrumentation that delegates to a invocation handler.
boolean	equals(Object other)
int	hashCode()
static Instrumentation	of(InvocationHandler invocationHandler) Creates an instrumentation for any instance of an InvocationHandler that delegates all method interceptions to the given instance which will be stored in a static field.
static Instrumentation	of(InvocationHandler invocationHandler, String fieldName) Creates an instrumentation for any instance of an InvocationHandler that delegates all method interceptions to the given instance which will be stored in a static field.
static Instrumentation	of(String fieldName) Creates an instrumentation for any InvocationHandler that delegates all method interceptions to a public instance field with the given name.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.bytebuddy.instrumentation.Instrumentation

appender, prepare

Field Detail

fieldName

protected final String fieldName

The name of the field for storing an invocation handler.

assigner

protected final Assigner assigner

The assigner that is used for assigning the return invocation handler's return value to the intercepted method's return value.

Constructor Detail

InvocationHandlerAdapter

protected InvocationHandlerAdapter(String fieldName)

Creates a new invocation handler for a given field.

Parameters:

fieldName - The name of the field.

Method Detail

of

public static Instrumentation of(InvocationHandler invocationHandler)

Creates an instrumentation for any instance of an InvocationHandler that delegates all method interceptions to the given instance which will be stored in a static field.

Parameters:

invocationHandler - The invocation handler to which all method calls are delegated.

Returns:

An instrumentation that delegates all method interceptions to the given invocation handler.

of

public static Instrumentation of(InvocationHandler invocationHandler,
                                 String fieldName)

Creates an instrumentation for any instance of an InvocationHandler that delegates all method interceptions to the given instance which will be stored in a static field.

Parameters:

invocationHandler - The invocation handler to which all method calls are delegated.

fieldName - The name of the field.

Returns:

An instrumentation that delegates all method interceptions to the given invocation handler.

of

public static Instrumentation of(String fieldName)

Creates an instrumentation for any InvocationHandler that delegates all method interceptions to a public instance field with the given name. This field has to be set before any invocations are intercepted. Otherwise, a NullPointerException will be thrown.

Parameters:

fieldName - The name of the field.

Returns:

An instrumentation that delegates all method interceptions to an instance field of the given name.

apply

protected ByteCodeAppender.Size apply(org.objectweb.asm.MethodVisitor methodVisitor,
                                      Instrumentation.Context instrumentationContext,
                                      MethodDescription instrumentedMethod,
                                      TypeDescription instrumentedType,
                                      StackManipulation preparingManipulation)

Applies an instrumentation that delegates to a invocation handler.

Parameters:

methodVisitor - The method visitor for writing the byte code to.

instrumentationContext - The instrumentation context for the current instrumentation.

instrumentedMethod - The method that is instrumented.

instrumentedType - The type that is instrumented.

preparingManipulation - A stack manipulation that applies any preparation to the operand stack.

Returns:

The size of the applied assignment.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object