net.bytebuddy.instrumentation

Class InvocationHandlerAdapter.ForStaticDelegation

java.lang.Object

net.bytebuddy.instrumentation.InvocationHandlerAdapter

net.bytebuddy.instrumentation.InvocationHandlerAdapter.ForStaticDelegation

All Implemented Interfaces:

Instrumentation

Enclosing class:

InvocationHandlerAdapter

protected static class InvocationHandlerAdapter.ForStaticDelegation
extends InvocationHandlerAdapter

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

Nested Class Summary

Nested Classes

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

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

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

Modifier and Type	Field and Description
protected InvocationHandler	invocationHandler The invocation handler to which method interceptions are to be delegated.

Fields inherited from class net.bytebuddy.instrumentation.InvocationHandlerAdapter

assigner, cacheMethods, fieldName

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.
boolean	equals(Object other)
int	hashCode()
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	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, of, of, toInstanceField

Methods inherited from class java.lang.Object

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

Field Detail

invocationHandler

protected final InvocationHandler invocationHandler

The invocation handler to which method interceptions are to be delegated.

Method Detail

withMethodCache

public Instrumentation 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.

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.

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.

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).

equals

public boolean equals(Object other)

Overrides:

equals in class InvocationHandlerAdapter

hashCode

public int hashCode()

Overrides:

hashCode in class InvocationHandlerAdapter

toString

public String toString()

Overrides:

toString in class Object