org.jruby.java.dispatch

Class CallableSelector

java.lang.Object

org.jruby.java.dispatch.CallableSelector

public class CallableSelector
extends java.lang.Object

Method selection logic for calling from Ruby to Java.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static interface	CallableSelector.CallableAcceptor
private static interface	CallableSelector.Matcher

Field Summary

Fields

Modifier and Type	Field and Description
private static CallableSelector.Matcher	ASSIGNABLE
private static CallableSelector.CallableAcceptor	AssignableAndPrimitivable
private static CallableSelector.CallableAcceptor	AssignableAndPrimitivableWithVarargs
private static CallableSelector.CallableAcceptor	AssignableOrDuckable
private static CallableSelector.Matcher	DUCKABLE
private static CallableSelector.CallableAcceptor	Exact
private static CallableSelector.Matcher	EXACT
private static CallableSelector.Matcher	PRIMITIVABLE

Constructor Summary

Constructors

Modifier	Constructor and Description
private	CallableSelector()

Method Summary

Modifier and Type	Method and Description
private static int	argsHashCode(IRubyObject a0)
private static int	argsHashCode(IRubyObject[] args)
private static int	argsHashCode(IRubyObject a0, IRubyObject a1)
private static int	argsHashCode(IRubyObject a0, IRubyObject a1, IRubyObject a2)
private static int	argsHashCode(IRubyObject a0, IRubyObject a1, IRubyObject a2, IRubyObject a3)
private static boolean	assignable(java.lang.Class<?> type, IRubyObject arg)
private static boolean	assignableAndPrimitivable(ParameterTypes paramTypes, IRubyObject... args)
private static boolean	assignableAndPrimitivableWithVarargs(ParameterTypes paramTypes, IRubyObject... args)
private static boolean	assignableOrDuckable(ParameterTypes paramTypes, IRubyObject... args)
private static int	calcExactnessScore(ParameterTypes callable, IRubyObject[] args)
private static int	calcTypePreference(java.lang.Class<?> type, IRubyObject arg)
private static boolean	duckable(java.lang.Class<?> type, IRubyObject arg)
private static boolean	exactMatch(ParameterTypes paramTypes, IRubyObject... args)
private static <T extends ParameterTypes> T	findCallable(T[] callables, CallableSelector.CallableAcceptor acceptor, IRubyObject[] args)
private static <T extends ParameterTypes> java.util.List<T>	findCallableCandidates(T[] callables, IRubyObject[] args)
private static <T extends ParameterTypes> T	findMatchingCallableForArgs(Ruby runtime, T[] methods, IRubyObject... args)
private static <T extends ParameterTypes> T	findMatchingCallableForArgsFallback(Ruby runtime, T[] methods, IRubyObject... args)
private static java.lang.Class<?>	getJavaClass(IRubyObject arg)
private static int	javaClassHashCode(IRubyObject arg)
private static int	javaClassOrProcHashCode(IRubyObject arg)
static <T extends ParameterTypes> T	matchingCallableArityFour(Ruby runtime, IntHashMap<T> cache, T[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
static JavaCallable	matchingCallableArityFour(Ruby runtime, java.util.Map cache, JavaCallable[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
static <T extends ParameterTypes> T	matchingCallableArityN(Ruby runtime, IntHashMap<T> cache, T[] methods, IRubyObject[] args)
static JavaCallable	matchingCallableArityN(Ruby runtime, java.util.Map cache, JavaCallable[] methods, IRubyObject[] args)
static ParameterTypes	matchingCallableArityN(Ruby runtime, java.util.Map cache, ParameterTypes[] methods, IRubyObject[] args)
static <T extends ParameterTypes> T	matchingCallableArityOne(Ruby runtime, IntHashMap<T> cache, T[] methods, IRubyObject arg0)
static JavaCallable	matchingCallableArityOne(Ruby runtime, java.util.Map cache, JavaCallable[] methods, IRubyObject arg0)
static <T extends ParameterTypes> T	matchingCallableArityThree(Ruby runtime, IntHashMap<T> cache, T[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2)
static JavaCallable	matchingCallableArityThree(Ruby runtime, java.util.Map cache, JavaCallable[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2)
static <T extends ParameterTypes> T	matchingCallableArityTwo(Ruby runtime, IntHashMap<T> cache, T[] methods, IRubyObject arg0, IRubyObject arg1)
static JavaCallable	matchingCallableArityTwo(Ruby runtime, java.util.Map cache, JavaCallable[] methods, IRubyObject arg0, IRubyObject arg1)
static <T extends ParameterTypes> IntHashMap<T>	newCallableCache() Internal helper to allocate a callable map to cache argument method matches.
private static boolean	primitivable(java.lang.Class<?> type, IRubyObject arg) This method checks whether an argument can be *directly* converted into the target primitive, i.e.

Methods inherited from class java.lang.Object

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

Field Detail

Exact

private static final CallableSelector.CallableAcceptor Exact

AssignableAndPrimitivable

private static final CallableSelector.CallableAcceptor AssignableAndPrimitivable

AssignableOrDuckable

private static final CallableSelector.CallableAcceptor AssignableOrDuckable

AssignableAndPrimitivableWithVarargs

private static final CallableSelector.CallableAcceptor AssignableAndPrimitivableWithVarargs

EXACT

private static final CallableSelector.Matcher EXACT

ASSIGNABLE

private static final CallableSelector.Matcher ASSIGNABLE

PRIMITIVABLE

private static final CallableSelector.Matcher PRIMITIVABLE

DUCKABLE

private static final CallableSelector.Matcher DUCKABLE

Constructor Detail

CallableSelector

private CallableSelector()

Method Detail

matchingCallableArityN

public static ParameterTypes matchingCallableArityN(Ruby runtime,
                                                    java.util.Map cache,
                                                    ParameterTypes[] methods,
                                                    IRubyObject[] args)

matchingCallableArityN

public static JavaCallable matchingCallableArityN(Ruby runtime,
                                                  java.util.Map cache,
                                                  JavaCallable[] methods,
                                                  IRubyObject[] args)

matchingCallableArityOne

public static JavaCallable matchingCallableArityOne(Ruby runtime,
                                                    java.util.Map cache,
                                                    JavaCallable[] methods,
                                                    IRubyObject arg0)

matchingCallableArityTwo

public static JavaCallable matchingCallableArityTwo(Ruby runtime,
                                                    java.util.Map cache,
                                                    JavaCallable[] methods,
                                                    IRubyObject arg0,
                                                    IRubyObject arg1)

matchingCallableArityThree

public static JavaCallable matchingCallableArityThree(Ruby runtime,
                                                      java.util.Map cache,
                                                      JavaCallable[] methods,
                                                      IRubyObject arg0,
                                                      IRubyObject arg1,
                                                      IRubyObject arg2)

matchingCallableArityFour

public static JavaCallable matchingCallableArityFour(Ruby runtime,
                                                     java.util.Map cache,
                                                     JavaCallable[] methods,
                                                     IRubyObject arg0,
                                                     IRubyObject arg1,
                                                     IRubyObject arg2,
                                                     IRubyObject arg3)

matchingCallableArityN

public static <T extends ParameterTypes> T matchingCallableArityN(Ruby runtime,
                                                                  IntHashMap<T> cache,
                                                                  T[] methods,
                                                                  IRubyObject[] args)

matchingCallableArityOne

public static <T extends ParameterTypes> T matchingCallableArityOne(Ruby runtime,
                                                                    IntHashMap<T> cache,
                                                                    T[] methods,
                                                                    IRubyObject arg0)

matchingCallableArityTwo

public static <T extends ParameterTypes> T matchingCallableArityTwo(Ruby runtime,
                                                                    IntHashMap<T> cache,
                                                                    T[] methods,
                                                                    IRubyObject arg0,
                                                                    IRubyObject arg1)

matchingCallableArityThree

public static <T extends ParameterTypes> T matchingCallableArityThree(Ruby runtime,
                                                                      IntHashMap<T> cache,
                                                                      T[] methods,
                                                                      IRubyObject arg0,
                                                                      IRubyObject arg1,
                                                                      IRubyObject arg2)

matchingCallableArityFour

public static <T extends ParameterTypes> T matchingCallableArityFour(Ruby runtime,
                                                                     IntHashMap<T> cache,
                                                                     T[] methods,
                                                                     IRubyObject arg0,
                                                                     IRubyObject arg1,
                                                                     IRubyObject arg2,
                                                                     IRubyObject arg3)

findMatchingCallableForArgs

private static <T extends ParameterTypes> T findMatchingCallableForArgs(Ruby runtime,
                                                                        T[] methods,
                                                                        IRubyObject... args)

findMatchingCallableForArgsFallback

private static <T extends ParameterTypes> T findMatchingCallableForArgsFallback(Ruby runtime,
                                                                                T[] methods,
                                                                                IRubyObject... args)

findCallable

private static <T extends ParameterTypes> T findCallable(T[] callables,
                                                         CallableSelector.CallableAcceptor acceptor,
                                                         IRubyObject[] args)

findCallableCandidates

private static <T extends ParameterTypes> java.util.List<T> findCallableCandidates(T[] callables,
                                                                                   IRubyObject[] args)

calcExactnessScore

private static int calcExactnessScore(ParameterTypes callable,
                                      IRubyObject[] args)

exactMatch

private static boolean exactMatch(ParameterTypes paramTypes,
                                  IRubyObject... args)

assignableAndPrimitivable

private static boolean assignableAndPrimitivable(ParameterTypes paramTypes,
                                                 IRubyObject... args)

assignableOrDuckable

private static boolean assignableOrDuckable(ParameterTypes paramTypes,
                                            IRubyObject... args)

assignableAndPrimitivableWithVarargs

private static boolean assignableAndPrimitivableWithVarargs(ParameterTypes paramTypes,
                                                            IRubyObject... args)

assignable

private static boolean assignable(java.lang.Class<?> type,
                                  IRubyObject arg)

primitivable

private static boolean primitivable(java.lang.Class<?> type,
                                    IRubyObject arg)

This method checks whether an argument can be *directly* converted into the target primitive, i.e. without changing from integral to floating-point.

Parameters:

type - The target type

arg - The argument to convert

Returns:

Whether the argument can be directly converted to the target primitive type

calcTypePreference

private static int calcTypePreference(java.lang.Class<?> type,
                                      IRubyObject arg)

duckable

private static boolean duckable(java.lang.Class<?> type,
                                IRubyObject arg)

argsHashCode

private static int argsHashCode(IRubyObject a0)

argsHashCode

private static int argsHashCode(IRubyObject a0,
                                IRubyObject a1)

argsHashCode

private static int argsHashCode(IRubyObject a0,
                                IRubyObject a1,
                                IRubyObject a2)

argsHashCode

private static int argsHashCode(IRubyObject a0,
                                IRubyObject a1,
                                IRubyObject a2,
                                IRubyObject a3)

argsHashCode

private static int argsHashCode(IRubyObject[] args)

javaClassHashCode

private static int javaClassHashCode(IRubyObject arg)

javaClassOrProcHashCode

private static int javaClassOrProcHashCode(IRubyObject arg)

getJavaClass

private static java.lang.Class<?> getJavaClass(IRubyObject arg)

newCallableCache

public static <T extends ParameterTypes> IntHashMap<T> newCallableCache()

Internal helper to allocate a callable map to cache argument method matches.

Type Parameters:

T - the callable type

Returns:

cache usable with CallableSelector