Package com.cryptomorin.xseries.reflection.jvm

Class FieldMemberHandle

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

All Implemented Interfaces:

NameableReflectiveHandle, NamedReflectiveHandle, ReflectiveHandle<MethodHandle>

public class FieldMemberHandle
extends FlaggedNamedMemberHandle

A handle for using reflection for Field.

Field Summary

Fields

Modifier and Type	Field	Description
protected Boolean	getter
static final MethodHandle	MODIFIERS_FIELD
static final MethodHandle	VAR_HANDLE_SET
static final DynamicClassHandle	VarHandle

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
FieldMemberHandle(ClassHandle clazz)

Method Summary

Modifier and Type	Method	Description
FieldMemberHandle	asFinal()
FieldMemberHandle	asStatic()
FieldMemberHandle	copy()	Creates a new handle with the same properties.
boolean	exists()
@Nullable Object	get(Object instance)
@Nullable Object	getStatic()
FieldMemberHandle	getter()
protected <T extends AccessibleObject & Member> T	handleAccessible(T field)	Handles private/final declarations.
boolean	isGetter()
@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)
FieldMemberHandle	makeAccessible()	If this member is known to be private or a final field.
FieldMemberHandle	map(MinecraftMapping mapping, String name)
FieldMemberHandle	named(String... names)
MethodHandle	reflect()	The heart of the class.
Field	reflectJvm()	It's preferred to use one of the MethodHandle methods instead.
FieldMemberHandle	returns(ClassHandle clazz)
FieldMemberHandle	returns(Class<?> clazz)
FieldMemberHandle	setter()
FieldMemberHandle	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.
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

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, reflectOrNull, unreflect, unwrap

Field Details

MODIFIERS_FIELD

public static final MethodHandle MODIFIERS_FIELD

VarHandle

public static final DynamicClassHandle VarHandle

VAR_HANDLE_SET

public static final MethodHandle VAR_HANDLE_SET

getter

protected Boolean getter

Constructor Details

FieldMemberHandle

public FieldMemberHandle(ClassHandle clazz)

Method Details

isGetter

public boolean isGetter()

getter

public FieldMemberHandle getter()

asStatic

public FieldMemberHandle asStatic()

Overrides:

asStatic in class FlaggedNamedMemberHandle

asFinal

public FieldMemberHandle asFinal()

makeAccessible

public FieldMemberHandle makeAccessible()

Description copied from class: MemberHandle

If this member is known to be private or a final field.

Overrides:

makeAccessible in class MemberHandle

setter

public FieldMemberHandle setter()

returns

public FieldMemberHandle returns(Class<?> clazz)

Overrides:

returns in class FlaggedNamedMemberHandle

returns

public FieldMemberHandle returns(ClassHandle clazz)

Overrides:

returns in class FlaggedNamedMemberHandle

copy

public FieldMemberHandle 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

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

exists

public boolean exists()

Returns:

true if this object exists at runtime, otherwise false.

signature

public FieldMemberHandle 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 FieldMemberHandle map(MinecraftMapping mapping,
 @Pattern("\\p{javaJavaIdentifierStart}\\p{javaJavaIdentifierPart}*")
 String name)

Specified by:

map in interface NameableReflectiveHandle

Overrides:

map in class NamedMemberHandle

named

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

Specified by:

named in interface NameableReflectiveHandle

Overrides:

named in class NamedMemberHandle

handleAccessible

protected <T extends AccessibleObject & Member> T handleAccessible(T field)
                                                            throws ReflectiveOperationException

Description copied from class: MemberHandle

Handles private/final declarations.

Overrides:

handleAccessible in class MemberHandle

Throws:

ReflectiveOperationException

get

@Nullable
public @Nullable Object get(Object instance)

getStatic

@Nullable
public @Nullable Object getStatic()

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 Field 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()

toString

public String toString()

Overrides:

toString in class Object