org.jruby.ext.ffi.jffi

Class NativeInvoker

java.lang.Object

org.jruby.internal.runtime.methods.DynamicMethod

org.jruby.ext.ffi.jffi.NativeInvoker

Direct Known Subclasses:

BufferNativeInvoker, JITNativeInvoker

public abstract class NativeInvoker
extends DynamicMethod

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 NativeCallbackFactory	cbFactory
private int	cbIndex
protected com.kenai.jffi.Function	function
private 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
NativeInvoker(RubyModule implementationClass, com.kenai.jffi.Function function, Signature signature)

Method Summary

Modifier and Type	Method and Description
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.
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()
(package private) Signature	getSignature()
boolean	isNative() Returns true if this method is backed by native (i.e.

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

calculateProtectedClass, call, 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

arity

protected final Arity arity

function

protected final com.kenai.jffi.Function function

cbIndex

private final int cbIndex

cbFactory

private final NativeCallbackFactory cbFactory

signature

private final Signature signature

Constructor Detail

NativeInvoker

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

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

getSignature

Signature getSignature()

getCallContext

com.kenai.jffi.CallContext getCallContext()

getFunctionAddress

long getFunctionAddress()

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