de.aristaflow.adept2.util.reflection

Class ReflectionTools

java.lang.Object

de.aristaflow.adept2.util.reflection.ReflectionTools

public class ReflectionTools
extends java.lang.Object

Various helper methods for reflection.

Constructor Summary

Constructors

Constructor and Description
ReflectionTools()

Method Summary

Modifier and Type	Method and Description
static int	distance(java.lang.Class<?> sup, java.lang.Class<?> sub) Calculates the distance from the designated subclass to the designated superclass: Equal classes have the distance 0.
static MethodWrapper	getCorrespondingVarArgsMethod(java.lang.String name, java.lang.Class<?>[] paramTypes, java.lang.Object[] paramValues, java.lang.Class<?> searchedClass) Gets the method from the designated class that corresponds to the designated method but has an additional varargs parameter or the designated method has an varargs parameter but the returned method from the designated class has not.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionTools

public ReflectionTools()

Method Detail

distance

public static int distance(java.lang.Class<?> sup,
                           java.lang.Class<?> sub)

Calculates the distance from the designated subclass to the designated superclass:

• Equal classes have the distance 0.
• An interface and a class directly implementing it have the distance 1.
• A super-class and its subclass have the distance 2.
• A super-interface and its subinterface have the distance 2.
• If the subclass cannot be converted to the superclass or one of the classes is null, the distance will be Integer.MAX_VALUE.

Distances spanning several classes/instances are totalled. If there are several ways to get from one class to the other (via interfaces), the shortest one will be chosen.

Parameters:

sup - The class (as fixed point) to which to calculate the distance.

sub - The class from which to calculate the distance.

Returns:

The distance between the two classes (or interfaces).

getCorrespondingVarArgsMethod

public static MethodWrapper getCorrespondingVarArgsMethod(java.lang.String name,
                                                          java.lang.Class<?>[] paramTypes,
                                                          java.lang.Object[] paramValues,
                                                          java.lang.Class<?> searchedClass)

Gets the method from the designated class that corresponds to the designated method but has an additional varargs parameter or the designated method has an varargs parameter but the returned method from the designated class has not. If no corresponding method is found or there are two methods found with an additional varargs parameter so we cannot decide which one to choose, null will be returned.
This also applies to constructors. With "corresponding" including name equality, this method is of restricted use for constructors since they need to have the same (class) name. A corresponding method without a varargs parameter will only be searched if parameter values are provided and the last one is null or an array only containing null. In this case we expect the call to the varargs method equal to calling the method without the last parameter and the varargs parameter to be irrelevant.

Parameters:

name - The name of the method/constructor to get the corresponding method/constructor for.

paramTypes - The parameter types of the method/constructor to get a corresponding method/constructor for. This must not be null.

paramValues - The parameter values of the method/constructor. This is only relevant when looking for a corresponding non-varargs method/constructor. In all other cases simply use null.

searchedClass - The class to get the corresponding method/constructor having an additional varargs parameter or not having the varargs parameter.

Returns:

The method/constructor corresponding to the designated method by having an additional varargs parameter or not having the varargs parameter and the last parameter value being null. If no such method/constructor is found or if there are several methods/constructors found matching this criteria, null will be returned.