net.bytebuddy.implementation.auxiliary

Class MethodCallProxy

java.lang.Object

net.bytebuddy.implementation.auxiliary.MethodCallProxy

All Implemented Interfaces:

AuxiliaryType

@HashCodeAndEqualsPlugin.Enhance
public class MethodCallProxy
extends Object
implements AuxiliaryType

A method call proxy represents a class that is compiled against a particular method which can then be called whenever either its Callable.call() or Runnable.run() method is called where the method call proxy implements both interfaces.

In order to do so, the method call proxy instances are constructed by providing all the necessary information for calling a particular method:

1. If the target method is not static, the first argument should be an instance on which the method is called.
2. All arguments for the called method in the order in which they are required.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MethodCallProxy.AssignableSignatureCall A stack manipulation that creates a MethodCallProxy for a given method an pushes such an object onto the call stack.
protected static class	MethodCallProxy.ConstructorCall An implementation for a constructor of a MethodCallProxy.
protected static class	MethodCallProxy.MethodCall An implementation for a method of a MethodCallProxy.
protected static class	MethodCallProxy.PrecomputedMethodGraph A precomputed method graph that only displays the methods that are relevant for creating a method call proxy.

Nested classes/interfaces inherited from interface net.bytebuddy.implementation.auxiliary.AuxiliaryType

AuxiliaryType.NamingStrategy, AuxiliaryType.SignatureRelevant

Field Summary

Fields inherited from interface net.bytebuddy.implementation.auxiliary.AuxiliaryType

DEFAULT_TYPE_MODIFIER

Constructor Summary

Constructors

Constructor and Description
MethodCallProxy(Implementation.SpecialMethodInvocation specialMethodInvocation, boolean serializableProxy) Creates a new method call proxy for a given method and uses a default assigner for assigning the method's return value to either the Callable.call() or Runnable.run() method returns.
MethodCallProxy(Implementation.SpecialMethodInvocation specialMethodInvocation, boolean serializableProxy, Assigner assigner) Creates a new method call proxy for a given method.

Method Summary

Modifier and Type	Method and Description
String	getSuffix() Produces a suffix that gives this auxiliary type a stable name.
DynamicType	make(String auxiliaryTypeName, ClassFileVersion classFileVersion, MethodAccessorFactory methodAccessorFactory) Creates a new auxiliary type.

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodCallProxy

public MethodCallProxy(Implementation.SpecialMethodInvocation specialMethodInvocation,
                       boolean serializableProxy)

Creates a new method call proxy for a given method and uses a default assigner for assigning the method's return value to either the Callable.call() or Runnable.run() method returns.

Parameters:

specialMethodInvocation - The special method invocation which should be invoked by this method call proxy.

serializableProxy - Determines if the generated proxy should be serializableProxy.

MethodCallProxy

public MethodCallProxy(Implementation.SpecialMethodInvocation specialMethodInvocation,
                       boolean serializableProxy,
                       Assigner assigner)

Creates a new method call proxy for a given method.

Parameters:

specialMethodInvocation - The special method invocation which should be invoked by this method call proxy.

serializableProxy - Determines if the generated proxy should be serializableProxy.

assigner - An assigner for assigning the target method's return value to either the Callable.call() or Runnable.run()} methods' return values.

Method Detail

getSuffix

public String getSuffix()

Produces a suffix that gives this auxiliary type a stable name. A best effort is made that this suffix is unique.

Specified by:

getSuffix in interface AuxiliaryType

Returns:

The suffix for this auxiliary type.

make

public DynamicType make(String auxiliaryTypeName,
                        ClassFileVersion classFileVersion,
                        MethodAccessorFactory methodAccessorFactory)

Creates a new auxiliary type.

Specified by:

make in interface AuxiliaryType

Parameters:

auxiliaryTypeName - The fully qualified binary name for this auxiliary type. The type should be in the same package than the instrumented type this auxiliary type is providing services to in order to allow package-private access.

classFileVersion - The class file version the auxiliary class should be written in.

methodAccessorFactory - A factory for accessor methods.

Returns:

A dynamically created type representing this auxiliary type.