Package org.jruby.java.dispatch

Class CallableSelector

java.lang.Object

org.jruby.java.dispatch.CallableSelector

public class CallableSelector
extends Object

Method selection logic for calling from Ruby to Java.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static interface	CallableSelector.CallableAcceptor
static interface	CallableSelector.CallableCache<T extends ParameterTypes>	A cache of "callables" based on method signature hash.
private static interface	CallableSelector.Matcher

Field Summary

Fields

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

Constructor Summary

Constructors

Modifier	Constructor	Description
private	CallableSelector()

Method Summary

Modifier and Type	Method	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(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(Class<?> type, IRubyObject arg)
private static boolean	duckable(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> 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 Class<?>	getJavaClass(IRubyObject arg)
private static int	javaClassHashCode(IRubyObject arg)
private static int	javaClassOrProcHashCode(IRubyObject arg)
static JavaCallable	matchingCallableArityFour(Ruby runtime, Map cache, JavaCallable[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)	Deprecated.
static <T extends ParameterTypes> T	matchingCallableArityFour(Ruby runtime, CallableSelector.CallableCache<T> cache, T[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
static <T extends JavaCallable> T	matchingCallableArityFour(Ruby runtime, RubyToJavaInvoker<T> invoker, T[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
static JavaCallable	matchingCallableArityN(Ruby runtime, Map cache, JavaCallable[] methods, IRubyObject[] args)	Deprecated.
static ParameterTypes	matchingCallableArityN(Ruby runtime, Map cache, ParameterTypes[] methods, IRubyObject[] args)	Deprecated.
static <T extends ParameterTypes> T	matchingCallableArityN(Ruby runtime, CallableSelector.CallableCache<T> cache, T[] methods, IRubyObject[] args)
static <T extends JavaCallable> T	matchingCallableArityN(Ruby runtime, RubyToJavaInvoker<T> invoker, T[] methods, IRubyObject[] args)
static JavaCallable	matchingCallableArityOne(Ruby runtime, Map cache, JavaCallable[] methods, IRubyObject arg0)	Deprecated.
static <T extends ParameterTypes> T	matchingCallableArityOne(Ruby runtime, CallableSelector.CallableCache<T> cache, T[] methods, IRubyObject arg0)
static <T extends JavaCallable> T	matchingCallableArityOne(Ruby runtime, RubyToJavaInvoker<T> invoker, T[] methods, IRubyObject arg0)
static JavaCallable	matchingCallableArityThree(Ruby runtime, Map cache, JavaCallable[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2)	Deprecated.
static <T extends ParameterTypes> T	matchingCallableArityThree(Ruby runtime, CallableSelector.CallableCache<T> cache, T[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2)
static <T extends JavaCallable> T	matchingCallableArityThree(Ruby runtime, RubyToJavaInvoker<T> invoker, T[] methods, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2)
static JavaCallable	matchingCallableArityTwo(Ruby runtime, Map cache, JavaCallable[] methods, IRubyObject arg0, IRubyObject arg1)	Deprecated.
static <T extends ParameterTypes> T	matchingCallableArityTwo(Ruby runtime, CallableSelector.CallableCache<T> cache, T[] methods, IRubyObject arg0, IRubyObject arg1)
static <T extends JavaCallable> T	matchingCallableArityTwo(Ruby runtime, RubyToJavaInvoker<T> invoker, T[] methods, IRubyObject arg0, IRubyObject arg1)
static <T extends JavaCallable> T	matchingCallableArityZero(Ruby runtime, RubyToJavaInvoker<T> invoker, T[] methods)
private static Boolean	moreSpecificTypes(Class[] msTypes, Class[] cTypes, boolean lastArgProc)
static <T extends ParameterTypes> IntHashMap<T>	newCallableCache()	Deprecated.
private static boolean	primitivable(Class<?> type, IRubyObject arg)	This method checks whether an argument can be *directly* converted into the target primitive, i.e.
private static int	procArityValue(IRubyObject proc)

Methods inherited from class java.lang.Object

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

Field Details

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 Details

CallableSelector

private CallableSelector()

Method Details

matchingCallableArityN

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

matchingCallableArityOne

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

matchingCallableArityTwo

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

matchingCallableArityThree

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

matchingCallableArityFour

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

matchingCallableArityN

public static <T extends JavaCallable> T matchingCallableArityN(Ruby runtime,
 RubyToJavaInvoker<T> invoker,
 T[] methods,
 IRubyObject[] args)

matchingCallableArityZero

public static <T extends JavaCallable> T matchingCallableArityZero(Ruby runtime,
 RubyToJavaInvoker<T> invoker,
 T[] methods)

matchingCallableArityOne

public static <T extends JavaCallable> T matchingCallableArityOne(Ruby runtime,
 RubyToJavaInvoker<T> invoker,
 T[] methods,
 IRubyObject arg0)

matchingCallableArityTwo

public static <T extends JavaCallable> T matchingCallableArityTwo(Ruby runtime,
 RubyToJavaInvoker<T> invoker,
 T[] methods,
 IRubyObject arg0,
 IRubyObject arg1)

matchingCallableArityThree

public static <T extends JavaCallable> T matchingCallableArityThree(Ruby runtime,
 RubyToJavaInvoker<T> invoker,
 T[] methods,
 IRubyObject arg0,
 IRubyObject arg1,
 IRubyObject arg2)

matchingCallableArityFour

public static <T extends JavaCallable> T matchingCallableArityFour(Ruby runtime,
 RubyToJavaInvoker<T> invoker,
 T[] methods,
 IRubyObject arg0,
 IRubyObject arg1,
 IRubyObject arg2,
 IRubyObject arg3)

findMatchingCallableForArgs

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

moreSpecificTypes

private static Boolean moreSpecificTypes(Class[] msTypes,
 Class[] cTypes,
 boolean lastArgProc)

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> 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(Class<?> type,
 IRubyObject arg)

primitivable

private static boolean primitivable(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(Class<?> type,
 IRubyObject arg)

duckable

private static boolean duckable(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)

procArityValue

private static int procArityValue(IRubyObject proc)

getJavaClass

private static Class<?> getJavaClass(IRubyObject arg)

newCallableCache

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

Deprecated.

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

Type Parameters:

T - the callable type

Returns:

cache usable with CallableSelector

matchingCallableArityN

@Deprecated
public static ParameterTypes matchingCallableArityN(Ruby runtime,
 Map cache,
 ParameterTypes[] methods,
 IRubyObject[] args)

Deprecated.

matchingCallableArityN

@Deprecated
public static JavaCallable matchingCallableArityN(Ruby runtime,
 Map cache,
 JavaCallable[] methods,
 IRubyObject[] args)

Deprecated.

matchingCallableArityOne

@Deprecated
public static JavaCallable matchingCallableArityOne(Ruby runtime,
 Map cache,
 JavaCallable[] methods,
 IRubyObject arg0)

Deprecated.

matchingCallableArityTwo

@Deprecated
public static JavaCallable matchingCallableArityTwo(Ruby runtime,
 Map cache,
 JavaCallable[] methods,
 IRubyObject arg0,
 IRubyObject arg1)

Deprecated.

matchingCallableArityThree

@Deprecated
public static JavaCallable matchingCallableArityThree(Ruby runtime,
 Map cache,
 JavaCallable[] methods,
 IRubyObject arg0,
 IRubyObject arg1,
 IRubyObject arg2)

Deprecated.

matchingCallableArityFour

@Deprecated
public static JavaCallable matchingCallableArityFour(Ruby runtime,
 Map cache,
 JavaCallable[] methods,
 IRubyObject arg0,
 IRubyObject arg1,
 IRubyObject arg2,
 IRubyObject arg3)

Deprecated.