net.bytebuddy.implementation

Class InvocationHandlerAdapter.ForInstanceDelegation

java.lang.Object

net.bytebuddy.implementation.InvocationHandlerAdapter

net.bytebuddy.implementation.InvocationHandlerAdapter.ForInstanceDelegation

All Implemented Interfaces:

Implementation, 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.implementation.InvocationHandlerAdapter

InvocationHandlerAdapter.AssignerConfigurable, InvocationHandlerAdapter.ForInstanceDelegation, InvocationHandlerAdapter.ForStaticDelegation

Nested classes/interfaces inherited from interface net.bytebuddy.implementation.Implementation

Implementation.Composable, Implementation.Compound, Implementation.Context, Implementation.Simple, Implementation.SpecialMethodInvocation, Implementation.Target

Field Summary

Fields inherited from class net.bytebuddy.implementation.InvocationHandlerAdapter

assigner, cacheMethods, CACHING, 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(Implementation.Target implementationTarget) 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 implementation, implementations are eligible to adding fields or methods to the currently instrumented type.
String	toString()
Implementation	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.implementation.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 implementation.

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 Implementation 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 implementation.

Returns:

This instrumentation with the given assigner configured.

prepare

public InstrumentedType prepare(InstrumentedType instrumentedType)

Description copied from interface: Implementation

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

Specified by:

prepare in interface Implementation

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(Implementation.Target implementationTarget)

Description copied from interface: Implementation

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

Specified by:

appender in interface Implementation

Parameters:

implementationTarget - The target of the current implementation.

Returns:

A byte code appender for implementing methods delegated to this implementation. This byte code appender is also responsible for handling methods that were added by this implementation on the call to Implementation.prepare(InstrumentedType).

toString

public String toString()

Overrides:

toString in class Object