org.apache.commons.jexl2.internal.introspection

Class MethodKey.Parameters<T>

java.lang.Object

org.apache.commons.jexl2.internal.introspection.MethodKey.Parameters<T>

Type Parameters:

T - Method or Constructor

Enclosing class:

MethodKey

private abstract static class MethodKey.Parameters<T>
extends java.lang.Object

Utility for parameters matching.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Parameters()

Method Summary

Modifier and Type	Method and Description
private java.util.LinkedList<T>	getApplicables(java.util.List<T> methods, java.lang.Class<?>[] classes) Returns all methods that are applicable to actual argument types.
private T	getMostSpecific(java.util.List<T> methods, java.lang.Class<?>[] classes) Gets the most specific method that is applicable to actual argument types.
protected abstract java.lang.Class<?>[]	getParameterTypes(T app) Extract the parameter types from its applicable argument.
private boolean	isApplicable(T method, java.lang.Class<?>[] classes) Returns true if the supplied method is applicable to actual argument types.
private boolean	isConvertible(java.lang.Class<?> formal, java.lang.Class<?> actual, boolean possibleVarArg)
private boolean	isStrictConvertible(java.lang.Class<?> formal, java.lang.Class<?> actual, boolean possibleVarArg)
private int	moreSpecific(java.lang.Class<?>[] c1, java.lang.Class<?>[] c2) Determines which method signature (represented by a class array) is more specific.

Methods inherited from class java.lang.Object

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

Constructor Detail

Parameters

private Parameters()

Method Detail

getParameterTypes

protected abstract java.lang.Class<?>[] getParameterTypes(T app)

Extract the parameter types from its applicable argument.

Parameters:

app - a method or constructor

Returns:

the parameters

getMostSpecific

private T getMostSpecific(java.util.List<T> methods,
                          java.lang.Class<?>[] classes)

Gets the most specific method that is applicable to actual argument types.

Parameters:

methods - a list of methods.

classes - list of argument types.

Returns:

the most specific method.

Throws:

MethodKey.AmbiguousException - if there is more than one.

moreSpecific

private int moreSpecific(java.lang.Class<?>[] c1,
                         java.lang.Class<?>[] c2)

Determines which method signature (represented by a class array) is more specific. This defines a partial ordering on the method signatures.

Parameters:

c1 - first signature to compare

c2 - second signature to compare

Returns:

MORE_SPECIFIC if c1 is more specific than c2, LESS_SPECIFIC if c1 is less specific than c2, INCOMPARABLE if they are incomparable.

getApplicables

private java.util.LinkedList<T> getApplicables(java.util.List<T> methods,
                                               java.lang.Class<?>[] classes)

Returns all methods that are applicable to actual argument types.

Parameters:

methods - list of all candidate methods

classes - the actual types of the arguments

Returns:

a list that contains only applicable methods (number of formal and actual arguments matches, and argument types are assignable to formal types through a method invocation conversion).

isApplicable

private boolean isApplicable(T method,
                             java.lang.Class<?>[] classes)

Returns true if the supplied method is applicable to actual argument types.

Parameters:

method - method that will be called

classes - arguments to method

Returns:

true if method is applicable to arguments

isConvertible

private boolean isConvertible(java.lang.Class<?> formal,
                              java.lang.Class<?> actual,
                              boolean possibleVarArg)

Parameters:

formal - the formal parameter type to which the actual parameter type should be convertible

actual - the actual parameter type.

possibleVarArg - whether or not we're dealing with the last parameter in the method declaration

Returns:

see isMethodInvocationConvertible.

See Also:

MethodKey.isInvocationConvertible(Class, Class, boolean)

isStrictConvertible

private boolean isStrictConvertible(java.lang.Class<?> formal,
                                    java.lang.Class<?> actual,
                                    boolean possibleVarArg)

Parameters:

formal - the formal parameter type to which the actual parameter type should be convertible

actual - the actual parameter type.

possibleVarArg - whether or not we're dealing with the last parameter in the method declaration

Returns:

see isStrictMethodInvocationConvertible.

See Also:

MethodKey.isStrictInvocationConvertible(Class, Class, boolean)