public final class MethodKey extends Object
This stores a method (or class) name and parameters.
This replaces the original key scheme which used to build the key by concatenating the method name and parameters class names as one string with the exception that primitive types were converted to their object class equivalents.
The key is still based on the same information, it is just wrapped in an object instead. Primitive type classes are converted to they object equivalent to make a key; int foo(int) and int foo(Integer) do generate the same key.
A key can be constructed either from arguments (array of objects) or from parameters (array of class). Roughly 3x faster than string key to access the map and uses less memory.Modifier and Type | Class and Description |
---|---|
static class |
MethodKey.AmbiguousException
Simple distinguishable exception, used when
we run across ambiguous overloading.
|
Constructor and Description |
---|
MethodKey(String aMethod,
Object[] args)
Creates a key from a method name and a set of arguments.
|
Modifier and Type | Method and Description |
---|---|
String |
debugString()
Outputs a human readable debug representation of this key.
|
boolean |
equals(Object obj) |
Constructor<?> |
getMostSpecificConstructor(Constructor<?>[] methods)
Gets the most specific constructor that is applicable to the parameters of this key.
|
Method |
getMostSpecificMethod(Method[] methods)
Gets the most specific method that is applicable to the parameters of this key.
|
int |
hashCode() |
static boolean |
isInvocationConvertible(Class<?> formal,
Class<?> actual,
boolean possibleVarArg)
Determines whether a type represented by a class object is
convertible to another type represented by a class object using a
method invocation conversion, treating object types of primitive
types as if they were primitive types (that is, a Boolean actual
parameter type matches boolean primitive formal type).
|
static boolean |
isStrictInvocationConvertible(Class<?> formal,
Class<?> actual,
boolean possibleVarArg)
Determines whether a type represented by a class object is
convertible to another type represented by a class object using a
method invocation conversion, without matching object and primitive
types.
|
static boolean |
isVarArgs(Method method)
Checks whether a method accepts a variable number of arguments.
|
String |
toString() |
public String debugString()
public static boolean isVarArgs(Method method)
May be due to a subtle bug in some JVMs, if a varargs method is an override, depending on (may be) the class introspection order, the isVarargs flag on the method itself will be false. To circumvent the potential problem, fetch the method with the same signature from the super-classes, - which will be different if override -and get the varargs flag from it.
method
- the method to check for varargspublic Method getMostSpecificMethod(Method[] methods)
methods
- a list of methods.MethodKey.AmbiguousException
- if there is more than one.public Constructor<?> getMostSpecificConstructor(Constructor<?>[] methods)
methods
- a list of constructors.MethodKey.AmbiguousException
- if there is more than one.public static boolean isInvocationConvertible(Class<?> formal, Class<?> actual, boolean possibleVarArg)
formal
- the formal parameter type to which the actual
parameter type should be convertibleactual
- the actual parameter type.possibleVarArg
- whether or not we're dealing with the last parameter
in the method declarationpublic static boolean isStrictInvocationConvertible(Class<?> formal, Class<?> actual, boolean possibleVarArg)
formal
- the formal parameter type to which the actual
parameter type should be convertibleactual
- the actual parameter type.possibleVarArg
- whether or not we're dealing with the last parameter
in the method declarationCopyright © 2001–2021 The Apache Software Foundation. All rights reserved.