org.jruby.ext.ffi.jffi

Class DefaultMethod

java.lang.Object

org.jruby.internal.runtime.methods.DynamicMethod

org.jruby.ext.ffi.jffi.DefaultMethod

All Implemented Interfaces:

CacheableMethod

public class DefaultMethod
extends DynamicMethod
implements CacheableMethod

Nested Class Summary

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

DynamicMethod.NativeCall

Field Summary

Fields

Modifier and Type	Field and Description
protected Arity	arity
private NativeInvoker	compiledInvoker
static boolean	DEBUG
private NativeInvoker	defaultInvoker
protected com.kenai.jffi.Function	function
private JITHandle	jitHandle
static boolean	REIFY
protected Signature	signature

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

builtin, callConfig, handle, implementationClass, name, nativeCall, nativeCalls, notImplemented, protectedClass, serialNumber, visibility

Constructor Summary

Constructors

Constructor and Description
DefaultMethod(RubyModule implementationClass, com.kenai.jffi.Function function, Signature signature, NativeInvoker defaultInvoker)

Method Summary

Modifier and Type	Method and Description
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject[] args) A default implementation of n-arity, non-block 'call' method, which simply calls the n-arity, block-receiving version with the arg list and Block.NULL_BLOCK.
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject[] args, Block block) The minimum 'call' method required for a dynamic method handle.
DynamicMethod	dup() Duplicate this method, returning DynamicMethod referencing the same code and with the same attributes.
NativeInvoker	forceCompilation()
Arity	getArity() Retrieve the arity of this method, used for reporting arity to Ruby code.
(package private) com.kenai.jffi.CallContext	getCallContext()
(package private) long	getFunctionAddress()
private JITHandle	getJITHandle()
DynamicMethod	getMethodForCaching()
protected NativeInvoker	getNativeInvoker()
(package private) Signature	getSignature()
boolean	isNative() Returns true if this method is backed by native (i.e.
private NativeInvoker	tryCompilation()

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

calculateProtectedClass, call, call, call, call, call, call, call, call, getCallConfig, getHandle, getImplementationClass, getMethodData, getName, getNativeCall, getNativeCall, getProtectedClass, getRealMethod, getSerialNumber, getVisibility, handleBreak, handleRedo, handleReturn, init, isBuiltin, isCallableFrom, isNotImplemented, isUndefined, setCallConfig, setHandle, setImplementationClass, setIsBuiltin, setName, setNativeCall, setNativeCall, setNativeCall, setNotImplemented, setVisibility

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static final boolean DEBUG

REIFY

public static final boolean REIFY

signature

protected final Signature signature

defaultInvoker

private final NativeInvoker defaultInvoker

compiledInvoker

private volatile NativeInvoker compiledInvoker

jitHandle

private JITHandle jitHandle

arity

protected final Arity arity

function

protected final com.kenai.jffi.Function function

Constructor Detail

DefaultMethod

public DefaultMethod(RubyModule implementationClass,
                     com.kenai.jffi.Function function,
                     Signature signature,
                     NativeInvoker defaultInvoker)

Method Detail

dup

public final 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.

getArity

public final Arity getArity()

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.

isNative

public final 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

getMethodForCaching

public DynamicMethod getMethodForCaching()

Specified by:

getMethodForCaching in interface CacheableMethod

getSignature

Signature getSignature()

getCallContext

com.kenai.jffi.CallContext getCallContext()

getFunctionAddress

long getFunctionAddress()

getNativeInvoker

protected final NativeInvoker getNativeInvoker()

getJITHandle

private JITHandle getJITHandle()

tryCompilation

private NativeInvoker tryCompilation()

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule clazz,
                        java.lang.String name,
                        IRubyObject[] args)

Description copied from class: DynamicMethod

A default implementation of n-arity, non-block 'call' method, which simply calls the n-arity, block-receiving version with the arg list and Block.NULL_BLOCK.

Overrides:

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

name - The incoming name used to invoke this method

Returns:

The result of the call

call

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

Description copied from class: DynamicMethod

The minimum 'call' method required for a dynamic method handle. Subclasses must impleemnt 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

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

forceCompilation

public final NativeInvoker forceCompilation()