Package com.cryptomorin.xseries.reflection.jvm

Class MethodMemberHandle

java.lang.Object

com.cryptomorin.xseries.reflection.jvm.MemberHandle

com.cryptomorin.xseries.reflection.jvm.NamedMemberHandle

com.cryptomorin.xseries.reflection.jvm.FlaggedNamedMemberHandle

com.cryptomorin.xseries.reflection.jvm.MethodMemberHandle

All Implemented Interfaces:

NameableReflectiveHandle, NamedReflectiveHandle, ReflectiveHandle<MethodHandle>

public class MethodMemberHandle
extends FlaggedNamedMemberHandle

A handle for using reflection for Method.

Field Summary

Fields

Modifier and Type	Field	Description
protected ClassHandle[]	parameterTypes

Fields inherited from class com.cryptomorin.xseries.reflection.jvm.FlaggedNamedMemberHandle

returnType

Fields inherited from class com.cryptomorin.xseries.reflection.jvm.NamedMemberHandle

names

Fields inherited from class com.cryptomorin.xseries.reflection.jvm.MemberHandle

accessFlags, clazz

Constructor Summary

Constructors

Constructor	Description
MethodMemberHandle(ClassHandle clazz)

Method Summary

Modifier and Type	Method	Description
MethodMemberHandle	asStatic()
MethodMemberHandle	copy()	Creates a new handle with the same properties.
MethodType	getMethodType()
@NotNull ReflectiveHandle<ReflectedObject>	jvm()	Usually ReflectiveHandles return MethodHandle when possible, however this method returns the raw object using the traditional Java reflection API which can be: Field Method Constructor Class (same as its normal ReflectiveHandle)
MethodMemberHandle	map(MinecraftMapping mapping, String name)
MethodMemberHandle	named(String... names)
MethodMemberHandle	parameters(ClassHandle... parameterTypes)	Overrides any previously set parameters.
MethodMemberHandle	parameters(Class<?>... parameterTypes)
MethodHandle	reflect()	The heart of the class.
Method	reflectJvm()	It's preferred to use one of the MethodHandle methods instead.
MethodMemberHandle	returns(ClassHandle clazz)
MethodMemberHandle	returns(Class<?> clazz)
MethodMemberHandle	signature(String declaration)	Changes the signature of this handle according to the given java code (see ReflectionParser) This overrides the current declaration, but names will be kept and any new names specified in the signature will also be added.
CallSite	toLambda(Class<?> proxy, String interfaceMethod)	Uses LambdaMetafactory to create runtime-generated ASM classes.
String	toString()

Methods inherited from class com.cryptomorin.xseries.reflection.jvm.FlaggedNamedMemberHandle

getParameters, getReturnType

Methods inherited from class com.cryptomorin.xseries.reflection.jvm.NamedMemberHandle

getPossibleNames

Methods inherited from class com.cryptomorin.xseries.reflection.jvm.MemberHandle

getAccessFlags, getClassHandle, handleAccessible, makeAccessible

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.cryptomorin.xseries.reflection.ReflectiveHandle

cached, catchError, exists, reflectOrNull, unreflect, unwrap

Field Details

parameterTypes

protected ClassHandle[] parameterTypes

Constructor Details

MethodMemberHandle

public MethodMemberHandle(ClassHandle clazz)

Method Details

parameters

public MethodMemberHandle parameters(ClassHandle... parameterTypes)

Overrides any previously set parameters.

returns

public MethodMemberHandle returns(Class<?> clazz)

Overrides:

returns in class FlaggedNamedMemberHandle

returns

public MethodMemberHandle returns(ClassHandle clazz)

Overrides:

returns in class FlaggedNamedMemberHandle

asStatic

public MethodMemberHandle asStatic()

Overrides:

asStatic in class FlaggedNamedMemberHandle

parameters

public MethodMemberHandle parameters(Class<?>... parameterTypes)

signature

public MethodMemberHandle signature(@Language(value="Java",suffix=";")
 String declaration)

Description copied from class: MemberHandle

Changes the signature of this handle according to the given java code (see ReflectionParser) This overrides the current declaration, but names will be kept and any new names specified in the signature will also be added.

Specified by:

signature in class MemberHandle

map

public MethodMemberHandle map(MinecraftMapping mapping,
 @Pattern("\\p{javaJavaIdentifierStart}\\p{javaJavaIdentifierPart}*")
 String name)

Specified by:

map in interface NameableReflectiveHandle

Overrides:

map in class NamedMemberHandle

named

public MethodMemberHandle named(@Pattern("\\p{javaJavaIdentifierStart}\\p{javaJavaIdentifierPart}*")
 String... names)

Specified by:

named in interface NameableReflectiveHandle

Overrides:

named in class NamedMemberHandle

getMethodType

public MethodType getMethodType()

Since:

14.0.0

toLambda

@Experimental
public CallSite toLambda(Class<?> proxy,
 String interfaceMethod)
                  throws ReflectiveOperationException,
LambdaConversionException

Uses LambdaMetafactory to create runtime-generated ASM classes.

Parameters:

proxy - the interface used to implement this method.

interfaceMethod - the name of the method inside proxy interface to implement.

Returns:

A callable object with no instance attached.

Throws:

ReflectiveOperationException - if reflect() fails.

LambdaConversionException - read LambdaMetafactory.metafactory(MethodHandles.Lookup, String, MethodType, MethodType, MethodHandle, MethodType) for more info.

Since:

14.0.0

reflect

public MethodHandle reflect()
                     throws ReflectiveOperationException

Description copied from interface: ReflectiveHandle

The heart of the class.

Specified by:

reflect in interface ReflectiveHandle<MethodHandle>

Specified by:

reflect in class MemberHandle

Returns:

the final JVM object that exists in this runtime.

Throws:

ReflectiveOperationException - if any errors occur while getting the object, including unknown objects, security issues, etc...

See Also:

• ReflectiveHandle.reflectOrNull()
• ReflectiveHandle.unreflect()

jvm

@NotNull
public @NotNull ReflectiveHandle<ReflectedObject> jvm()

Description copied from interface: ReflectiveHandle

Usually ReflectiveHandles return MethodHandle when possible, however this method returns the raw object using the traditional Java reflection API which can be:

• Field
• Method
• Constructor
• Class (same as its normal ReflectiveHandle)

See Also:

• ReflectedObject

reflectJvm

public Method reflectJvm()
                  throws ReflectiveOperationException

Description copied from class: MemberHandle

It's preferred to use one of the MethodHandle methods instead. This method should only be used for special cases when a direct JVM object is needed.

Specified by:

reflectJvm in class MemberHandle

Throws:

ReflectiveOperationException

See Also:

• MemberHandle.reflect()

copy

public MethodMemberHandle copy()

Description copied from interface: ReflectiveHandle

Creates a new handle with the same properties.

Specified by:

copy in interface ReflectiveHandle<MethodHandle>

Specified by:

copy in class NamedMemberHandle

toString

public String toString()

Overrides:

toString in class Object