Package revxrsal.asm

Interface MethodCaller

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface MethodCaller

Represents the entrypoint to method callers. This interface is implemented by the generated classes to invoke targeted methods.

To generate, use wrap(Method) or wrap(Method, ClassLoader).

Implementation note: Generating method callers using ASM to invoke private methods is not possible. Therefore, if a private method is requested, the method handles API will be used to generate method callers.

Method Summary

Modifier and Type	Method	Description
default @NotNull BoundMethodCaller	bindTo(@Nullable Object instance)	Binds this method caller to the given instance, and returns a BoundMethodCaller that does not need an instance to be provided for calls.
Object	call(@Nullable Object instance, Object... arguments)	Invokes the method
static MethodCaller	wrap(@NotNull Method method)	Creates a MethodCaller that wraps the given method
static MethodCaller	wrap(@NotNull Method method, @NotNull ClassLoader loader)	Creates a MethodCaller that wraps the given method, and defines the generated method caller class on the given classloader

Method Details

call

Object call(@Nullable
 @Nullable Object instance,
 Object... arguments)

Invokes the method

Parameters:

instance - Instance to invoke the method on. Can be null for static methods.

arguments - Arguments to invoke the method with

Returns:

The returned value of the method. Will return null for void methods

bindTo

@NotNull
default @NotNull BoundMethodCaller bindTo(@Nullable
 @Nullable Object instance)

Binds this method caller to the given instance, and returns a BoundMethodCaller that does not need an instance to be provided for calls.

For static methods, instance can be null.

Parameters:

instance - Instance to bind to. Can be null for static methods.

Returns:

The bound method caller

wrap

static MethodCaller wrap(@NotNull
 @NotNull Method method)

Creates a MethodCaller that wraps the given method

Parameters:

method - Method to wrap

Returns:

The method caller responsible for invoking the method

wrap

static MethodCaller wrap(@NotNull
 @NotNull Method method,
 @NotNull
 @NotNull ClassLoader loader)

Creates a MethodCaller that wraps the given method, and defines the generated method caller class on the given classloader

Parameters:

method - Method to wrap

loader - Classloader to define the generated method on.

Returns:

The method caller responsible for invoking the method