Package com.cryptomorin.xseries.reflection.aggregate

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

java.lang.Object

com.cryptomorin.xseries.reflection.aggregate.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>

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

Constructor	Description
AggregateReflectiveHandle(Collection<Callable<H>> handles)	Use XReflection.anyOf(Callable[]) instead.

Method Summary

Modifier and Type	Method	Description
AggregateReflectiveHandle<T,H>	copy()	Creates a new handle with the same properties.
H	getHandle()
@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)
AggregateReflectiveHandle<T,H>	modify(@Nullable Consumer<H> handleModifier)	Action performed on all the handles before being checked.
AggregateReflectiveHandle<T,H>	or(H handle)
AggregateReflectiveHandle<T,H>	or(@NotNull Callable<H> handle)
T	reflect()	The heart of the class.

Methods inherited from class java.lang.Object

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

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

cached, catchError, exists, reflectOrNull, unreflect, unwrap

Constructor Details

AggregateReflectiveHandle

@Internal
public AggregateReflectiveHandle(Collection<Callable<H>> handles)

Use XReflection.anyOf(Callable[]) instead.

Method Details

or

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

See Also:

• or(Callable)

or

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

See Also:

• or(ReflectiveHandle)

modify

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

Action performed on all the handles before being checked.

getHandle

public H getHandle()

copy

public AggregateReflectiveHandle<T,H> copy()

Description copied from interface: ReflectiveHandle

Creates a new handle with the same properties.

Specified by:

copy in interface ReflectiveHandle<T>

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)

Specified by:

jvm in interface ReflectiveHandle<T>

See Also:

• ReflectedObject

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