Class InvocationHandlerAdapter.ForInstance

java.lang.Object

net.bytebuddy.implementation.InvocationHandlerAdapter

net.bytebuddy.implementation.InvocationHandlerAdapter.ForInstance

All Implemented Interfaces:

InstrumentedType.Prepareable, Implementation, Implementation.Composable, InvocationHandlerAdapter.AssignerConfigurable, InvocationHandlerAdapter.WithoutPrivilegeConfiguration

Enclosing class:

InvocationHandlerAdapter

@Enhance
protected static class InvocationHandlerAdapter.ForInstance
extends InvocationHandlerAdapter
implements InvocationHandlerAdapter.WithoutPrivilegeConfiguration

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	Description
protected class	InvocationHandlerAdapter.ForInstance.Appender	An appender for implementing the InvocationHandlerAdapter.ForInstance.

Nested classes/interfaces inherited from class InvocationHandlerAdapter

InvocationHandlerAdapter.AssignerConfigurable, InvocationHandlerAdapter.ForField, InvocationHandlerAdapter.ForInstance, InvocationHandlerAdapter.WithoutPrivilegeConfiguration

Nested classes/interfaces inherited from interface Implementation

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

Nested classes/interfaces inherited from interface InstrumentedType.Prepareable

InstrumentedType.Prepareable.NoOp

Field Summary

Fields

Modifier and Type	Field	Description
protected final InvocationHandler	invocationHandler	The invocation handler to which method interceptions are to be delegated.
private static final String	PREFIX	The prefix for field that are created for storing the instrumented value.

Fields inherited from class InvocationHandlerAdapter

assigner, cached, fieldName, privileged, returning

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ForInstance(String fieldName, boolean cached, boolean privileged, boolean returning, Assigner assigner, InvocationHandler invocationHandler)	Creates a new invocation handler adapter for delegating invocations to an invocation handler that is stored in a static field.

Method Summary

Modifier and Type	Method	Description
Implementation	andThen(Implementation implementation)	Appends the supplied implementation to this implementation.
Implementation.Composable	andThen(Implementation.Composable implementation)	Appends the supplied composable implementation to this implementation.
ByteCodeAppender	appender(Implementation.Target implementationTarget)	Creates a byte code appender that determines the implementation of the instrumented type's methods.
InstrumentedType	prepare(InstrumentedType instrumentedType)	Prepares a given instrumented type.
Implementation.Composable	withAssigner(Assigner assigner)	Configures an assigner to use with this invocation handler adapter.
InvocationHandlerAdapter.WithoutPrivilegeConfiguration	withoutMethodCache()	By default, any Method instance that is handed over to an InvocationHandler is cached in a static field.
InvocationHandlerAdapter.AssignerConfigurable	withPrivilegedLookup()	Configures that the method constants supplied to the invocation handler adapter are resolved using an java.security.AccessController.

Methods inherited from class InvocationHandlerAdapter

apply, of, of, toField, toField

Methods inherited from class Object

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

Field Details

PREFIX

private static final String PREFIX

The prefix for field that are created for storing the instrumented value.

See Also:

• Constant Field Values

invocationHandler

protected final InvocationHandler invocationHandler

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

Constructor Details

ForInstance

protected ForInstance(String fieldName,
 boolean cached,
 boolean privileged,
 boolean returning,
 Assigner assigner,
 InvocationHandler invocationHandler)

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

Parameters:

fieldName - The name of the field.

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

privileged - Determines if the Method instances are retrieved by using an java.security.AccessController.

returning - Determines if this implementation is returning the result value or is dropping it.

assigner - The assigner to apply when defining this implementation.

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

Method Details

withoutMethodCache

public InvocationHandlerAdapter.WithoutPrivilegeConfiguration withoutMethodCache()

Description copied from class: InvocationHandlerAdapter

By default, any Method instance that is handed over to an InvocationHandler is cached in a static field. By invoking this method, this feature can be disabled.

Specified by:

withoutMethodCache in class InvocationHandlerAdapter

Returns:

A similar invocation handler adapter that applies caching.

withAssigner

public Implementation.Composable withAssigner(Assigner assigner)

Description copied from class: InvocationHandlerAdapter

Configures an assigner to use with this invocation handler adapter.

Specified by:

withAssigner in interface InvocationHandlerAdapter.AssignerConfigurable

Specified by:

withAssigner in class InvocationHandlerAdapter

Parameters:

assigner - The assigner to apply when defining this implementation.

Returns:

This instrumentation with the given assigner configured.

withPrivilegedLookup

public InvocationHandlerAdapter.AssignerConfigurable withPrivilegedLookup()

Description copied from class: InvocationHandlerAdapter

Configures that the method constants supplied to the invocation handler adapter are resolved using an java.security.AccessController.

Specified by:

withPrivilegedLookup in interface InvocationHandlerAdapter.WithoutPrivilegeConfiguration

Specified by:

withPrivilegedLookup in class InvocationHandlerAdapter

Returns:

This instrumentation with a privileged lookup configured.

andThen

public Implementation andThen(Implementation implementation)

Appends the supplied implementation to this implementation.

Specified by:

andThen in interface Implementation.Composable

Parameters:

implementation - The subsequent implementation.

Returns:

An implementation that combines this implementation with the provided one.

andThen

public Implementation.Composable andThen(Implementation.Composable implementation)

Appends the supplied composable implementation to this implementation.

Specified by:

andThen in interface Implementation.Composable

Parameters:

implementation - The subsequent composable implementation.

Returns:

A composable implementation that combines this implementation with the provided one.

prepare

public InstrumentedType prepare(InstrumentedType instrumentedType)

Prepares a given instrumented type.

Specified by:

prepare in interface InstrumentedType.Prepareable

Parameters:

instrumentedType - The instrumented type in its current form.

Returns:

The prepared instrumented type.

appender

public ByteCodeAppender appender(Implementation.Target implementationTarget)

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 InstrumentedType.Prepareable.prepare(InstrumentedType).