Package com.cryptomorin.xseries.reflection

Class AggregateReflectiveHandle<T,H extends ReflectiveHandle<T>>

java.lang.Object

com.cryptomorin.xseries.reflection.AggregateReflectiveHandle<T,H>

Type Parameters:

T - the JVM type of AggregateReflectiveHandle

H - the types of handles that are going to be checked.

All Implemented Interfaces:

ReflectiveHandle<T>, Cloneable

public class AggregateReflectiveHandle<T,H extends ReflectiveHandle<T>>
extends Object
implements ReflectiveHandle<T>

Most reflection APIs already provide a name-based fallback system that can be used (like DynamicClassHandle.named(String...)) but sometimes the signature of certain JVM declarations just change entirely, that's where this class could be useful.

It simply tries the reflect() method of each handle until one of them returns without throwing an exception (order matters).

Usage

    MethodMemberHandle profileByName = XReflection.of(GameProfileCache.class).method().named("getProfile", "a");
    MethodHandle getProfileByName = XReflection.anyOf(
        () -> profileByName.signature("public GameProfile get(String username);"),
        () -> profileByName.signature("public Optional<GameProfile> get(String username);")
    ).reflect();
 

See Also:

• ReflectiveHandle

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AggregateReflectiveHandle(Collection<Callable<H>> handles)

Method Summary

Modifier and Type	Method	Description
AggregateReflectiveHandle<T,H>	clone()	Creates a new handle with the same properties.
H	getHandle()
AggregateReflectiveHandle<T,H>	modify(Consumer<H> handleModifier)	Action performed on all the handles before being checked.
AggregateReflectiveHandle<T,H>	or(H handle)
AggregateReflectiveHandle<T,H>	or(Callable<H> handle)
T	reflect()	The heart of the class.

Methods inherited from class java.lang.Object

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

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

catchError, exists, reflectOrNull, unreflect

Constructor Details

AggregateReflectiveHandle

protected AggregateReflectiveHandle(Collection<Callable<H>> handles)

Method Details

or

public AggregateReflectiveHandle<T,H> or(@Nonnull
 H handle)

See Also:

• or(Callable)

or

public AggregateReflectiveHandle<T,H> or(@Nonnull
 Callable<H> handle)

See Also:

• or(ReflectiveHandle)

modify

public AggregateReflectiveHandle<T,H> modify(@Nullable
 Consumer<H> handleModifier)

Action performed on all the handles before being checked.

getHandle

public H getHandle()

clone

public AggregateReflectiveHandle<T,H> clone()

Description copied from interface: ReflectiveHandle

Creates a new handle with the same properties.

Specified by:

clone in interface ReflectiveHandle<T>

Overrides:

clone in class Object

reflect

public T reflect()
          throws ReflectiveOperationException

Description copied from interface: ReflectiveHandle

The heart of the class.

Specified by:

reflect in interface ReflectiveHandle<T>

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