net.bytebuddy.instrumentation

Class InvocationHandlerAdapter.ForInstanceDelegation

java.lang.Object

net.bytebuddy.instrumentation.InvocationHandlerAdapter

net.bytebuddy.instrumentation.InvocationHandlerAdapter.ForInstanceDelegation

All Implemented Interfaces:

Instrumentation, InvocationHandlerAdapter.AssignerConfigurable

Enclosing class:

InvocationHandlerAdapter

protected static class InvocationHandlerAdapter.ForInstanceDelegation
extends InvocationHandlerAdapter
implements InvocationHandlerAdapter.AssignerConfigurable

An implementation of an InvocationHandlerAdapter that delegates method invocations to an adapter that is stored in an instance field.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	InvocationHandlerAdapter.ForInstanceDelegation.Appender An appender for implementing the InvocationHandlerAdapter.ForInstanceDelegation.

Nested classes/interfaces inherited from class net.bytebuddy.instrumentation.InvocationHandlerAdapter

InvocationHandlerAdapter.AssignerConfigurable, InvocationHandlerAdapter.ForInstanceDelegation, InvocationHandlerAdapter.ForStaticDelegation

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

Instrumentation.Compound, Instrumentation.Context, Instrumentation.ForAbstractMethod, Instrumentation.Simple, Instrumentation.SpecialMethodInvocation, Instrumentation.Target

Field Summary

Fields inherited from class net.bytebuddy.instrumentation.InvocationHandlerAdapter

assigner, cacheMethods, fieldName

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForInstanceDelegation(String fieldName, boolean cacheMethods, Assigner assigner) Creates a new invocation handler adapter for delegating invocations to an invocation handler that is stored in an instance field.

Method Summary

Modifier and Type	Method and Description
ByteCodeAppender	appender(Instrumentation.Target instrumentationTarget) Creates a byte code appender that determines the implementation of the instrumented type's methods.
InstrumentedType	prepare(InstrumentedType instrumentedType) During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type.
String	toString()
Instrumentation	withAssigner(Assigner assigner) Configures an assigner to use with this invocation handler adapter.
InvocationHandlerAdapter.AssignerConfigurable	withMethodCache() By default, any Method instance that is handed over to an InvocationHandler is created on each invocation of the method.

Methods inherited from class net.bytebuddy.instrumentation.InvocationHandlerAdapter

apply, equals, hashCode, of, of, toInstanceField

Methods inherited from class java.lang.Object

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

Constructor Detail

ForInstanceDelegation

protected ForInstanceDelegation(String fieldName,
                                boolean cacheMethods,
                                Assigner assigner)

Creates a new invocation handler adapter for delegating invocations to an invocation handler that is stored in an instance field.

Parameters:

fieldName - The name of the field.

cacheMethods - Determines if the Method instances that are handed to the intercepted methods are cached in static fields.

assigner - The assigner to apply when defining this instrumentation.

Method Detail

withMethodCache

public InvocationHandlerAdapter.AssignerConfigurable withMethodCache()

Description copied from class: InvocationHandlerAdapter

By default, any Method instance that is handed over to an InvocationHandler is created on each invocation of the method. Method look-ups are normally cached by its defining Class what makes a repeated look-up of a method little expensive. However, because Method instances are mutable by their AccessibleObject contact, any looked-up instance needs to be copied by its defining Class before exposing it. This can cause performance deficits when a method is for example called repeatedly in a loop. By enabling the method cache, this performance penalty can be avoided by caching a single Method instance for any intercepted method as a static field in the instrumented type.

Specified by:

withMethodCache in class InvocationHandlerAdapter

Returns:

A similar invocation handler adapter which caches any Method instance in form of a static field.

withAssigner

public Instrumentation withAssigner(Assigner assigner)

Description copied from interface: InvocationHandlerAdapter.AssignerConfigurable

Configures an assigner to use with this invocation handler adapter.

Specified by:

withAssigner in interface InvocationHandlerAdapter.AssignerConfigurable

Parameters:

assigner - The assigner to apply when defining this instrumentation.

Returns:

This instrumentation with the given assigner configured.

prepare

public InstrumentedType prepare(InstrumentedType instrumentedType)

Description copied from interface: Instrumentation

During the preparation phase of an instrumentation, implementations are eligible to adding fields or methods to the currently instrumented type. All methods that are added by this instrumentation are required to be implemented by the ByteCodeAppender that is emitted on the call to Instrumentation.appender(net.bytebuddy.instrumentation.Instrumentation.Target) call. On this method call, loaded type initializers can also be added to the instrumented type.

Specified by:

prepare in interface Instrumentation

Parameters:

instrumentedType - The instrumented type that is the basis of the ongoing instrumentation.

Returns:

The instrumented type with any applied changes, if any.

appender

public ByteCodeAppender appender(Instrumentation.Target instrumentationTarget)

Description copied from interface: Instrumentation

Creates a byte code appender that determines the implementation of the instrumented type's methods.

Specified by:

appender in interface Instrumentation

Parameters:

instrumentationTarget - The target of the current instrumentation.

Returns:

A byte code appender for implementing methods delegated to this instrumentation. This byte code appender is also responsible for handling methods that were added by this instrumentation on the call to Instrumentation.prepare(net.bytebuddy.instrumentation.type.InstrumentedType).

toString

public String toString()

Overrides:

toString in class Object