Package org.jruby.internal.runtime.methods

Class HandleMethod

java.lang.Object

org.jruby.internal.runtime.methods.DynamicMethod

org.jruby.internal.runtime.methods.HandleMethod

All Implemented Interfaces:

Cloneable, MethodArgs2

public class HandleMethod
extends DynamicMethod
implements MethodArgs2, Cloneable

A DynamicMethod backed by one or more java.lang.invoke.MethodHandle objects. The MethodHandles contained in this method are used by invokedynamic-based call site binding to bind more directly to the target. Previously, the handles required for binding were built at the call site by inspecting the DynamicMethod that came in. With the newer logic, handles are created at bind time, so they're already ready and so we don't need to generate our own handle classes that might only get used by the interpreter.

Nested Class Summary

Nested classes/interfaces inherited from class org.jruby.internal.runtime.methods.DynamicMethod

DynamicMethod.NativeCall, DynamicMethod.Version

Field Summary

Fields

Modifier and Type	Field	Description
private final boolean	builtin
private boolean	initialized0
private boolean	initialized1
private boolean	initialized2
private boolean	initialized3
private boolean	initialized4
private Callable<MethodHandle>	maker0
private Callable<MethodHandle>	maker1
private Callable<MethodHandle>	maker2
private Callable<MethodHandle>	maker3
private Callable<MethodHandle>	maker4
private final int	max
private final int	min
private final boolean	notImplemented
private final String	parameterDesc
private final Signature	signature
private MethodHandle	target0
private MethodHandle	target1
private MethodHandle	target2
private MethodHandle	target3
private MethodHandle	target4

Fields inherited from class org.jruby.internal.runtime.methods.DynamicMethod

definedClass, flags, handle, implementationClass, name, protectedClass, serialNumber

Constructor Summary

Constructors

Constructor	Description
HandleMethod(RubyModule implementationClass, Visibility visibility, String name, long encodedSignature, boolean builtin, boolean notImplemented, String parameterDesc, int min, int max, Callable<MethodHandle> maker0, Callable<MethodHandle> maker1, Callable<MethodHandle> maker2, Callable<MethodHandle> maker3, Callable<MethodHandle> maker4)

Method Summary

Modifier and Type	Method	Description
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, String name, Block block)	Arity 0, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, String name, IRubyObject[] args, Block block)	The minimum 'call' method required for a dynamic method handle.
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, String name, IRubyObject arg0, Block block)	Arity 1, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, String name, IRubyObject arg0, IRubyObject arg1, Block block)	Arity 2, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, String name, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2, Block block)	Arity 3, with block; calls through IRubyObject[] path
DynamicMethod	dup()	Duplicate this method, returning DynamicMethod referencing the same code and with the same attributes.
private MethodHandle	ensureTarget0()
private MethodHandle	ensureTarget1()
private MethodHandle	ensureTarget2()
private MethodHandle	ensureTarget3()
private MethodHandle	ensureTarget4()
Arity	getArity()	Deprecated.
MethodHandle	getHandle(int arity)
String[]	getParameterList()
Signature	getSignature()	Retrieve the signature of this method.
boolean	isBuiltin()
boolean	isNative()	Returns true if this method is backed by native (i.e.
boolean	isNotImplemented()	Whether this method is "not implemented".
private static MethodHandle	safeCall(Callable<MethodHandle> maker)

Methods inherited from class org.jruby.internal.runtime.methods.DynamicMethod

calculateProtectedClass, call, call, call, call, call, callRespondTo, getCallConfig, getDefinedClass, getHandle, getImplementationClass, getInstanceVariableNames, getMethodData, getName, getProtectedClass, getRealMethod, getSerialNumber, getVisibility, init, init, isCallableFrom, isImplementedBy, isNull, isRefined, isUndefined, setCallConfig, setDefinedClass, setHandle, setImplementationClass, setIsBuiltin, setNotImplemented, setVisibility

Methods inherited from class java.lang.Object

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

Field Details

maker0

private Callable<MethodHandle> maker0

maker1

private Callable<MethodHandle> maker1

maker2

private Callable<MethodHandle> maker2

maker3

private Callable<MethodHandle> maker3

maker4

private Callable<MethodHandle> maker4

target0

private MethodHandle target0

target1

private MethodHandle target1

target2

private MethodHandle target2

target3

private MethodHandle target3

target4

private MethodHandle target4

initialized0

private volatile boolean initialized0

initialized1

private volatile boolean initialized1

initialized2

private volatile boolean initialized2

initialized3

private volatile boolean initialized3

initialized4

private volatile boolean initialized4

min

private final int min

max

private final int max

parameterDesc

private final String parameterDesc

signature

private final Signature signature

builtin

private final boolean builtin

notImplemented

private final boolean notImplemented

Constructor Details

HandleMethod

public HandleMethod(RubyModule implementationClass,
 Visibility visibility,
 String name,
 long encodedSignature,
 boolean builtin,
 boolean notImplemented,
 String parameterDesc,
 int min,
 int max,
 Callable<MethodHandle> maker0,
 Callable<MethodHandle> maker1,
 Callable<MethodHandle> maker2,
 Callable<MethodHandle> maker3,
 Callable<MethodHandle> maker4)

Method Details

getArity

@Deprecated
public Arity getArity()

Deprecated.

Description copied from class: DynamicMethod

Retrieve the arity of this method, used for reporting arity to Ruby code. This arity may or may not reflect the actual specific or variable arities of the referenced method.

Overrides:

getArity in class DynamicMethod

Returns:

The arity of the method, as reported to Ruby consumers.

getSignature

public Signature getSignature()

Description copied from class: DynamicMethod

Retrieve the signature of this method.

Overrides:

getSignature in class DynamicMethod

Returns:

the signature

isBuiltin

public boolean isBuiltin()

Overrides:

isBuiltin in class DynamicMethod

isNotImplemented

public boolean isNotImplemented()

Description copied from class: DynamicMethod

Whether this method is "not implemented". This is primarily to support Ruby 1.9's behavior of respond_to? yielding false if the feature in question is unsupported (but still having the method defined).

Overrides:

isNotImplemented in class DynamicMethod

isNative

public boolean isNative()

Description copied from class: DynamicMethod

Returns true if this method is backed by native (i.e. Java) code.

Overrides:

isNative in class DynamicMethod

Returns:

true If backed by Java code or JVM bytecode; false otherwise

ensureTarget0

private MethodHandle ensureTarget0()

ensureTarget1

private MethodHandle ensureTarget1()

ensureTarget2

private MethodHandle ensureTarget2()

ensureTarget3

private MethodHandle ensureTarget3()

ensureTarget4

private MethodHandle ensureTarget4()

safeCall

private static MethodHandle safeCall(Callable<MethodHandle> maker)

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule clazz,
 String name,
 IRubyObject[] args,
 Block block)

Description copied from class: DynamicMethod

The minimum 'call' method required for a dynamic method handle. Subclasses must implement this method, but may implement the other signatures to provide faster, non-boxing call paths. Typically subclasses will implement this method to check variable arity calls, then performing a specific-arity invocation to the appropriate method or performing variable-arity logic in-line.

Specified by:

call in class DynamicMethod

Parameters:

context - The thread context for the currently executing thread

self - The 'self' or 'receiver' object to use for this call

clazz - The Ruby class against which this method is binding

name - The incoming name used to invoke this method

args - The argument list to this invocation

block - The block passed to this invocation

Returns:

The result of the call

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule clazz,
 String name,
 Block block)

Description copied from class: DynamicMethod

Arity 0, with block; calls through IRubyObject[] path

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule clazz,
 String name,
 IRubyObject arg0,
 Block block)

Description copied from class: DynamicMethod

Arity 1, with block; calls through IRubyObject[] path

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule clazz,
 String name,
 IRubyObject arg0,
 IRubyObject arg1,
 Block block)

Description copied from class: DynamicMethod

Arity 2, with block; calls through IRubyObject[] path

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule clazz,
 String name,
 IRubyObject arg0,
 IRubyObject arg1,
 IRubyObject arg2,
 Block block)

Description copied from class: DynamicMethod

Arity 3, with block; calls through IRubyObject[] path

Overrides:

call in class DynamicMethod

dup

public DynamicMethod dup()

Description copied from class: DynamicMethod

Duplicate this method, returning DynamicMethod referencing the same code and with the same attributes. It is not required that this method produce a new object if the semantics of the DynamicMethod subtype do not require such.

Specified by:

dup in class DynamicMethod

Returns:

An identical DynamicMethod object to the target.

getParameterList

public String[] getParameterList()

Specified by:

getParameterList in interface MethodArgs2

getHandle

public MethodHandle getHandle(int arity)