Package com.cryptomorin.xseries.reflection

Interface ReflectiveHandle<T>

Type Parameters:

T - The JVM type associated with this handle (e.g. Class, Field, Method, or Constructor)

All Superinterfaces:

Cloneable

All Known Implementing Classes:

AggregateReflectiveHandle, ClassHandle, ConstructorMemberHandle, DynamicClassHandle, EnumMemberHandle, FieldMemberHandle, FlaggedNamedMemberHandle, MemberHandle, MethodMemberHandle, MinecraftClassHandle, NamedMemberHandle, StaticClassHandle, UnknownClassHandle

public interface ReflectiveHandle<T>
extends Cloneable

Represents an object that can be used for reflection operations.

See Also:

• AggregateReflectiveHandle
• ClassHandle
• MethodMemberHandle
• FieldMemberHandle
• ConstructorMemberHandle

Method Summary

Modifier and Type	Method	Description
default @Nullable ReflectiveOperationException	catchError()	Deprecated. I don't think there's going to be any practical use for this method.
ReflectiveHandle<T>	clone()	Creates a new handle with the same properties.
default boolean	exists()
T	reflect()	The heart of the class.
default T	reflectOrNull()	Same as reflect() except that it will return null if any ReflectiveOperationException errors occur.
default T	unreflect()	An unchecked exception version of reflect() (throws the original exception, not the a RuntimeException)

Method Details

clone

@Experimental
ReflectiveHandle<T> clone()

Creates a new handle with the same properties.

exists

default boolean exists()

Returns:

true if this object exists at runtime, otherwise false.

catchError

@Nullable
@Obsolete
default @Nullable ReflectiveOperationException catchError()

Deprecated.

I don't think there's going to be any practical use for this method.

Catches any ReflectiveOperationException thrown by reflect()

unreflect

@Nonnull
default T unreflect()

An unchecked exception version of reflect() (throws the original exception, not the a RuntimeException)

Throws:

ReflectiveOperationException - throws silently.

See Also:

• reflect()
• reflectOrNull()

reflectOrNull

@Nullable
default T reflectOrNull()

Same as reflect() except that it will return null if any ReflectiveOperationException errors occur.

See Also:

• reflect()
• unreflect()

reflect

@Nonnull
T reflect()
   throws ReflectiveOperationException

The heart of the class.

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:

• reflectOrNull()
• unreflect()