org.bbottema.javareflection.model

Enum LookupMode

java.lang.Object

java.lang.Enum<LookupMode>

org.bbottema.javareflection.model.LookupMode

All Implemented Interfaces:

Serializable, Comparable<LookupMode>

public enum LookupMode
extends Enum<LookupMode>

Defines lookup modes for matching Java methods and constructors. Each time a lookup failed on signature type, a less strict lookup is performed, in the following order (signature means: the list of parameters defined for a method or constructor):

1. exact matching: the given type should exactly match the found types during lookup. This lookup cycle is always performed first.
2. autobox matching: the given type should match its boxed/unboxed version.
3. polymorphic interface matching: the given type should match one of the implemented interfaces
4. polymorphic superclass matching: the given type should match one of the super classes (for each superclass, the cycle is repeated, so exact and interface matching come first again before the next superclass up in the chain)
5. common conversion matching: if all other lookups fail, one last resort is to try to convert the given type, if a common type, to any other common type and then try to find a matching method or constructor. See ValueConversionHelper for more on the possibilities.

Enum Constant Summary

Enum Constants

Enum Constant and Description
AUTOBOX Indicates that looking for methods includes trying to find compatible signatures by autoboxing the specified arguments.
CAST_TO_INTERFACE Indicates that looking for methods includes trying to find compatible signatures by casting the specified arguments to an implemented interface.
CAST_TO_SUPER Indicates that looking for methods includes trying to find compatible signatures by casting the specified arguments to a super type.
COMMON_CONVERT Indicates that looking for methods includes trying to find compatible signatures by automatically converting the specified arguments.
SMART_CONVERT Like COMMON_CONVERT, but now takes the registered converters and continues finding a conversion path based on the previous outcomes.

Field Summary

Fields

Modifier and Type	Field and Description
static Set<LookupMode>	FULL Defines a complete method lookup configuration that combines all possible lookup modes.
static Set<LookupMode>	SIMPLE Defines a simple method lookup configuration that goes as far as casting and autoboxing, but no actual conversions are done to the values.

Method Summary

Modifier and Type	Method and Description
static LookupMode	valueOf(String name) Returns the enum constant of this type with the specified name.
static LookupMode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

AUTOBOX

public static final LookupMode AUTOBOX

Indicates that looking for methods includes trying to find compatible signatures by autoboxing the specified arguments.

CAST_TO_SUPER

public static final LookupMode CAST_TO_SUPER

Indicates that looking for methods includes trying to find compatible signatures by casting the specified arguments to a super type.

CAST_TO_INTERFACE

public static final LookupMode CAST_TO_INTERFACE

Indicates that looking for methods includes trying to find compatible signatures by casting the specified arguments to an implemented interface.

COMMON_CONVERT

public static final LookupMode COMMON_CONVERT

Indicates that looking for methods includes trying to find compatible signatures by automatically converting the specified arguments.

SMART_CONVERT

public static final LookupMode SMART_CONVERT

Like COMMON_CONVERT, but now takes the registered converters and continues finding a conversion path based on the previous outcomes.

Examples:

• Joda date object -> String -> Java8 date object. This would require only the toJava8 date object converter to work
• Calendar -> String -> char. Calendar is compatible with String and String with char, but conversion will fail of course.
• Boolean -> Character -> long. This simply works out of the box, resulting in 0 or 1.

Field Detail

SIMPLE

public static final Set<LookupMode> SIMPLE

Defines a simple method lookup configuration that goes as far as casting and autoboxing, but no actual conversions are done to the values.

FULL

public static final Set<LookupMode> FULL

Defines a complete method lookup configuration that combines all possible lookup modes.

Method Detail

values

public static LookupMode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (LookupMode c : LookupMode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static LookupMode valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null