Top Fields Constructors Methods
org.jruby.ext.ffi.jffi

public abstract Class NativeInvoker

extends DynamicMethod
Class Inheritance
Known Direct Subclasses
org.jruby.ext.ffi.jffi.BufferNativeInvoker, org.jruby.ext.ffi.jffi.JITNativeInvoker
Imports
com.kenai.jffi.CallContext, org.jruby.RubyModule, org.jruby.ext.ffi.CallbackInfo, org.jruby.internal.runtime.methods.DynamicMethod, org.jruby.runtime.Arity, .Block, .ThreadContext, .Visibility, org.jruby.runtime.builtin.IRubyObject

Field Summary

Modifier and TypeField and Description
protected final Arity
arity

private final NativeCallbackFactory
cbFactory

private final int
cbIndex

protected final Function
function

Inherited from org.jruby.internal.runtime.methods.DynamicMethod:
aliasCountdefinedClassflagshandleimplementationClassnameprotectedClassserialNumber

Constructor Summary

AccessConstructor and Description
public
NativeInvoker(RubyModule implementationClass, Function function, Signature signature)

Method Summary

Modifier and TypeMethod and Description
public IRubyObject
call(ThreadContext
The thread context for the currently executing thread
context, IRubyObject
The 'self' or 'receiver' object to use for this call
self, RubyModule
The Ruby class against which this method is binding
clazz, String
The incoming name used to invoke this method
name, IRubyObject[]
The argument list to this invocation
args, Block
The block passed to this invocation
block)

Implements abstract org.jruby.internal.runtime.methods.DynamicMethod.call.

The minimum 'call' method required for a dynamic method handle.

public final DynamicMethod
dup()

Implements abstract org.jruby.internal.runtime.methods.DynamicMethod.dup.

Duplicate this method, returning DynamicMethod referencing the same code and with the same attributes.

public final Arity
getArity()

Overrides org.jruby.internal.runtime.methods.DynamicMethod.getArity.

Deprecated

Retrieve the arity of this method, used for reporting arity to Ruby code.

pack-priv CallContext
getCallContext()

pack-priv long
getFunctionAddress()

public final boolean
isNative()

Overrides org.jruby.internal.runtime.methods.DynamicMethod.isNative.

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

Inherited from org.jruby.internal.runtime.methods.DynamicMethod:
adjustAliasCountcalculateProtectedClasscallcallcallcallcallcallcallcallcallcallRespondTogetAliasCountgetCallConfiggetDefinedClassgetHandlegetImplementationClassgetInstanceVariableNamesgetMethodDatagetNamegetProtectedClassgetRealMethodgetSerialNumbergetSignaturegetVisibilityinitinitisBuiltinisCallableFromisImplementedByisNotImplementedisNullisRefinedisUndefinedsetCallConfigsetDefinedClasssetHandlesetImplementationClasssetIsBuiltinsetNotImplementedsetRuby2KeywordssetVisibility

Field Detail

arityback to summary
protected final Arity arity
cbFactoryback to summary
private final NativeCallbackFactory cbFactory
cbIndexback to summary
private final int cbIndex
functionback to summary
protected final Function function

Constructor Detail

NativeInvokerback to summary
public NativeInvoker(RubyModule implementationClass, Function function, Signature signature)

Method Detail

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

Implements abstract org.jruby.internal.runtime.methods.DynamicMethod.call.

Doc from org.jruby.internal.runtime.methods.DynamicMethod.call.

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.

Parameters
context:ThreadContext

The thread context for the currently executing thread

self:IRubyObject

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

clazz:RubyModule

The Ruby class against which this method is binding

name:String

The incoming name used to invoke this method

args:IRubyObject[]

The argument list to this invocation

block:Block

The block passed to this invocation

Returns:IRubyObject

The result of the call

Annotations
@Override
dupback to summary
public final DynamicMethod dup()

Implements abstract org.jruby.internal.runtime.methods.DynamicMethod.dup.

Doc from org.jruby.internal.runtime.methods.DynamicMethod.dup.

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.

Returns:DynamicMethod

An identical DynamicMethod object to the target.

Annotations
@Override
getArityback to summary
public final Arity getArity()

Overrides org.jruby.internal.runtime.methods.DynamicMethod.getArity.

Doc from org.jruby.internal.runtime.methods.DynamicMethod.getArity.

Deprecated

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.

Returns:Arity

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

Annotations
@Deprecated
@Override
getCallContextback to summary
pack-priv CallContext getCallContext()
getFunctionAddressback to summary
pack-priv long getFunctionAddress()
isNativeback to summary
public final boolean isNative()

Overrides org.jruby.internal.runtime.methods.DynamicMethod.isNative.

Doc from org.jruby.internal.runtime.methods.DynamicMethod.isNative.

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

Returns:boolean

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

Annotations
@Override