com.goldencode.p2j.util

Class FuzzyMethodRt

java.lang.Object

com.goldencode.p2j.uast.FuzzyMethodLookup

com.goldencode.p2j.util.FuzzyMethodRt

public class FuzzyMethodRt
extends FuzzyMethodLookup

Implements the rules to perform fuzzy method lookup, for runtime.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	FuzzyMethodRt.InternalMethodData The state used by MatchMetrics to calculate the match.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<MatchMetrics>	candidates The candidates used to perform the lookup.
private static CentralLogger	LOG Logger
private java.util.List<InternalEntry>	overloads The overloads which will be used to calculate the candidates.
private java.lang.Class<? extends _BaseObject_>	type The type where the search will start.

Constructor Summary

Constructors

Constructor and Description
FuzzyMethodRt(java.lang.Class<? extends _BaseObject_> type, java.util.List<InternalEntry> overloads) Initialize this instance.

Method Summary

Modifier and Type	Method and Description
private int	calcAccessMode(java.lang.Class<?> thisType) Give the class for the context where this method is being invoked (i.e.
protected java.util.List<MatchMetrics>	candidates(java.lang.String name, int num, int access, boolean isStatic, boolean internal, boolean first, java.util.Set<SignatureKey> exist) Get the list of all possible methods that could match in this class AND its parent classes.
protected java.lang.String	getClassName() Get the class name where this method lookup starts from.
private java.lang.Class<?>[]	getInterfaces(java.lang.Class<?> src) Get the interfaces implemented by this type.
private java.lang.Class<?>[]	getParents(java.lang.Class<?> src) Get the parents of the given type.
private boolean	isImplemented(java.lang.Class<?> src, java.lang.Class<?> tgt) Check if the source class implements the specified interface.
protected boolean	isImplemented(java.lang.String caller, java.lang.String callee) Detect if the callee class is an instance of an implemented interface of the caller class.
private boolean	isInheritedFrom(java.lang.Class<?> src, java.lang.Class<?> tgt, boolean ifaces, java.lang.Runnable incrementer) Check if the source type implements or extends the target type, and calculate the distance from this parent.
protected boolean	isInheritedFrom(java.lang.String caller, java.lang.String callee, java.lang.Runnable incrementer) Detect if the callee class is an instance of a parent class or an implemented interface of a parent class, of the caller.
protected boolean	isSetParam(java.lang.String method) Reports if the class name is Progress.Lang.ParameterList and the method name is setParameter().
InternalEntry	lookup(java.lang.Class<?> thisType, java.lang.String methodName, boolean isStatic, java.lang.String modes, java.lang.Object[] args) Perform a runtime fuzzy lookup of the given method, in the overloads list.
private java.lang.Class<?>	parseObjectSpec(java.lang.String spec) Parse the given object spec (in the form "object" or "jobject") and return the type associated with _CLS_.
private ParameterKey[]	resolveSignature(java.lang.Object[] args, java.lang.String modes) Given a list of arguments and their modes, resolve the signature in conversion-compatible mode.

Methods inherited from class com.goldencode.p2j.uast.FuzzyMethodLookup

fuzzyMethodLookup

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final CentralLogger LOG

Logger

type

private final java.lang.Class<? extends _BaseObject_> type

The type where the search will start.

overloads

private final java.util.List<InternalEntry> overloads

The overloads which will be used to calculate the candidates.

candidates

private java.util.List<MatchMetrics> candidates

The candidates used to perform the lookup.

Constructor Detail

FuzzyMethodRt

public FuzzyMethodRt(java.lang.Class<? extends _BaseObject_> type,
                     java.util.List<InternalEntry> overloads)

Initialize this instance.

Parameters:

type - The type where the search will start.

overloads - The overloads which will be used to calculate the candidates.

Method Detail

lookup

public InternalEntry lookup(java.lang.Class<?> thisType,
                            java.lang.String methodName,
                            boolean isStatic,
                            java.lang.String modes,
                            java.lang.Object[] args)

Perform a runtime fuzzy lookup of the given method, in the overloads list.

Parameters:

thisType - The type where the call is being performed (external program or legacy class).

methodName - The target method name.

isStatic - If true, only static methods will be looked up. Otherwise any method can be returned.

modes - The argument modes.

args - The arguments.

Returns:

The resolved method (as its InternalEntry) or null if none found.

getClassName

protected java.lang.String getClassName()

Get the class name where this method lookup starts from.

Specified by:

getClassName in class FuzzyMethodLookup

Returns:

See above.

isImplemented

protected boolean isImplemented(java.lang.String caller,
                                java.lang.String callee)

Detect if the callee class is an instance of an implemented interface of the caller class.

Specified by:

isImplemented in class FuzzyMethodLookup

Parameters:

caller - The caller type.

callee - The callee type.

Returns:

true if the given class is an implemented interface in this class.

isInheritedFrom

protected boolean isInheritedFrom(java.lang.String caller,
                                  java.lang.String callee,
                                  java.lang.Runnable incrementer)

Detect if the callee class is an instance of a parent class or an implemented interface of a parent class, of the caller.

Specified by:

isInheritedFrom in class FuzzyMethodLookup

Parameters:

caller - The caller type.

callee - The callee type to check.

incrementer - Code to be executed to increment the inheritance level.

Returns:

true if the given class is a parent class or an implemented interface of a parent class.

isSetParam

protected boolean isSetParam(java.lang.String method)

Reports if the class name is Progress.Lang.ParameterList and the method name is setParameter().

Specified by:

isSetParam in class FuzzyMethodLookup

Parameters:

method - The method name.

Returns:

true if this is a setParameter call.

candidates

protected java.util.List<MatchMetrics> candidates(java.lang.String name,
                                                  int num,
                                                  int access,
                                                  boolean isStatic,
                                                  boolean internal,
                                                  boolean first,
                                                  java.util.Set<SignatureKey> exist)

Get the list of all possible methods that could match in this class AND its parent classes. The actual types are not checked but the method name, access mode, static/instance and number of parameters must all match.

Specified by:

candidates in class FuzzyMethodLookup

Parameters:

name - Method name.

num - Number of parameters.

access - Access mode (KW_PUBLIC, KW_PROTECTD or KW_PRIVATE).

isStatic - If true, only static methods will be looked up. Otherwise any method can be returned.

internal - true if the lookup is internal to the current class definition.

first - true if the first match should be immediately returned as the result.

exist - The set of existing methods already represented in the list.

Returns:

List of possible methods that match. This may be an empty list if no match exists.

calcAccessMode

private int calcAccessMode(java.lang.Class<?> thisType)

Give the class for the context where this method is being invoked (i.e. THIS-PROCEDURE or THIS-OBJECT), determine what access mode is allowed for the candidate methods.

Parameters:

thisType - The type where this method call is being performed.

Returns:

See above.

isImplemented

private boolean isImplemented(java.lang.Class<?> src,
                              java.lang.Class<?> tgt)

Check if the source class implements the specified interface.

Parameters:

src - The source type.

tgt - The lookup type.

Returns:

See above.

isInheritedFrom

private boolean isInheritedFrom(java.lang.Class<?> src,
                                java.lang.Class<?> tgt,
                                boolean ifaces,
                                java.lang.Runnable incrementer)

Check if the source type implements or extends the target type, and calculate the distance from this parent.

Parameters:

src - The source type.

tgt - The target type.

ifaces - true if implemented interfaces should be checked.

incrementer - Code to be executed to increment the inheritance level.

Returns:

See above.

getInterfaces

private java.lang.Class<?>[] getInterfaces(java.lang.Class<?> src)

Get the interfaces implemented by this type. If the type is an interface, in 4GL terms the interfaces are inherited, and not implemented, so an empty array is returned.

Parameters:

src - The type.

Returns:

The interfaces.

getParents

private java.lang.Class<?>[] getParents(java.lang.Class<?> src)

Get the parents of the given type. In OpenEdge terms, the parents of an interface are all inherited interfaces, and for class, its direct super-class.

Parameters:

src - The type.

Returns:

The parent list.

parseObjectSpec

private java.lang.Class<?> parseObjectSpec(java.lang.String spec)

Parse the given object spec (in the form "object" or "jobject") and return the type associated with _CLS_.

Parameters:

spec - The specification to parse.

Returns:

The type or null if the spec was malformed or if there is no such definition.

resolveSignature

private ParameterKey[] resolveSignature(java.lang.Object[] args,
                                        java.lang.String modes)

Given a list of arguments and their modes, resolve the signature in conversion-compatible mode.

Parameters:

args - The arguments.

modes - The modes.

Returns:

See above.