org.jruby.internal.runtime.methods

Class CompiledMethod.LazyCompiledMethod

java.lang.Object

org.jruby.internal.runtime.methods.DynamicMethod

org.jruby.internal.runtime.methods.CompiledMethod.LazyCompiledMethod

All Implemented Interfaces:

java.lang.Cloneable, MethodArgs2, PositionAware

Enclosing class:

CompiledMethod

public static class CompiledMethod.LazyCompiledMethod
extends DynamicMethod
implements java.lang.Cloneable, PositionAware, MethodArgs2

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
private Arity	arity
private DynamicMethod	compiledMethod
private MethodFactory	factory
private java.lang.String	javaName
private java.lang.String	parameterDesc
private java.lang.String[]	parameterList
private ISourcePosition	position
private java.lang.String	rubyName
private StaticScope	scope
private java.lang.Object	scriptObject

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
LazyCompiledMethod(RubyModule implementationClass, java.lang.String rubyName, java.lang.String javaName, Arity arity, Visibility visibility, StaticScope scope, java.lang.Object scriptObject, CallConfiguration callConfig, ISourcePosition position, java.lang.String parameterDesc, MethodFactory factory)

Method Summary

Modifier and Type	Method and Description
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name) Arity 0, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, Block block) Arity 0, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject arg0) Arity 1, no block
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.
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject arg0, Block block) Arity 1, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject arg0, IRubyObject arg1) Arity 2, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject arg0, IRubyObject arg1, Block block) Arity 2, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.String name, IRubyObject arg0, IRubyObject arg1, IRubyObject arg2) Arity 3, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule clazz, java.lang.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.
Arity	getArity() Retrieve the arity of this method, used for reporting arity to Ruby code.
CallConfiguration	getCallConfig() Get the CallConfiguration used for pre/post logic for this method handle.
java.lang.String	getFile() Get the filename for the method.
RubyModule	getImplementationClass() Retrieve the class or module on which this method is implemented, used for 'super' logic among others.
int	getLine() Get the line number for the method.
java.lang.String[]	getParameterList()
protected RubyModule	getProtectedClass() Retrieve the pre-calculated "protected class" used for access checks.
DynamicMethod	getRealMethod() Get the "real" method contained within this method.
Visibility	getVisibility() Get the visibility of this method.
private void	initializeMethod()
boolean	isCallableFrom(IRubyObject caller, CallType callType) Determine whether this method is callable from the given object using the given call type.
boolean	isNative() Returns true if this method is backed by native (i.e.
void	setCallConfig(CallConfiguration callConfig) Set the CallConfiguration used for pre/post logic for this method handle.
void	setImplementationClass(RubyModule implClass) Set the class on which this method is implemented, used for 'super' logic, among others.
void	setVisibility(Visibility visibility) Set the visibility of this method.

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

calculateProtectedClass, getHandle, getMethodData, getName, getNativeCall, getNativeCall, getSerialNumber, handleBreak, handleRedo, handleReturn, init, isBuiltin, isNotImplemented, isUndefined, setHandle, setIsBuiltin, setName, setNativeCall, setNativeCall, setNativeCall, setNotImplemented

Methods inherited from class java.lang.Object

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

Field Detail

rubyName

private final java.lang.String rubyName

javaName

private final java.lang.String javaName

arity

private final Arity arity

scope

private final StaticScope scope

scriptObject

private final java.lang.Object scriptObject

factory

private MethodFactory factory

compiledMethod

private DynamicMethod compiledMethod

position

private final ISourcePosition position

parameterDesc

private final java.lang.String parameterDesc

parameterList

private final java.lang.String[] parameterList

Constructor Detail

LazyCompiledMethod

public LazyCompiledMethod(RubyModule implementationClass,
                          java.lang.String rubyName,
                          java.lang.String javaName,
                          Arity arity,
                          Visibility visibility,
                          StaticScope scope,
                          java.lang.Object scriptObject,
                          CallConfiguration callConfig,
                          ISourcePosition position,
                          java.lang.String parameterDesc,
                          MethodFactory factory)

Method Detail

initializeMethod

private void initializeMethod()

call

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

Description copied from class: DynamicMethod

Arity 0, no block

Overrides:

call in class DynamicMethod

call

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

Description copied from class: DynamicMethod

Arity 1, no block

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule clazz,
                        java.lang.String name,
                        IRubyObject arg0,
                        IRubyObject arg1)

Description copied from class: DynamicMethod

Arity 2, no block

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule clazz,
                        java.lang.String name,
                        IRubyObject arg0,
                        IRubyObject arg1,
                        IRubyObject arg2)

Description copied from class: DynamicMethod

Arity 3, no block

Overrides:

call in class DynamicMethod

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,
                        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,
                        java.lang.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,
                        java.lang.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,
                        java.lang.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

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

getArity

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

getCallConfig

public CallConfiguration getCallConfig()

Description copied from class: DynamicMethod

Get the CallConfiguration used for pre/post logic for this method handle.

Overrides:

getCallConfig in class DynamicMethod

Returns:

The CallConfiguration for this method handle

getImplementationClass

public RubyModule getImplementationClass()

Description copied from class: DynamicMethod

Retrieve the class or module on which this method is implemented, used for 'super' logic among others.

Overrides:

getImplementationClass in class DynamicMethod

Returns:

The class on which this method is implemented

getProtectedClass

protected RubyModule getProtectedClass()

Description copied from class: DynamicMethod

Retrieve the pre-calculated "protected class" used for access checks.

Overrides:

getProtectedClass in class DynamicMethod

Returns:

The "protected class" for access checks.

getRealMethod

public DynamicMethod getRealMethod()

Description copied from class: DynamicMethod

Get the "real" method contained within this method. This simply returns self except in cases where a method is wrapped to give it a new name or new implementation class (AliasMethod, WrapperMethod, ...).

Overrides:

getRealMethod in class DynamicMethod

Returns:

The "real" method associated with this one

getVisibility

public Visibility getVisibility()

Description copied from class: DynamicMethod

Get the visibility of this method.

Overrides:

getVisibility in class DynamicMethod

Returns:

The visibility of this method

isCallableFrom

public boolean isCallableFrom(IRubyObject caller,
                              CallType callType)

Description copied from class: DynamicMethod

Determine whether this method is callable from the given object using the given call type.

Overrides:

isCallableFrom in class DynamicMethod

Parameters:

caller - The calling object

callType - The type of call

Returns:

true if the call would not violate visibility; false otherwise

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

setCallConfig

public void setCallConfig(CallConfiguration callConfig)

Description copied from class: DynamicMethod

Set the CallConfiguration used for pre/post logic for this method handle.

Overrides:

setCallConfig in class DynamicMethod

Parameters:

callConfig - The CallConfiguration for this method handle

setImplementationClass

public void setImplementationClass(RubyModule implClass)

Description copied from class: DynamicMethod

Set the class on which this method is implemented, used for 'super' logic, among others.

Overrides:

setImplementationClass in class DynamicMethod

Parameters:

implClass - The class on which this method is implemented

setVisibility

public void setVisibility(Visibility visibility)

Description copied from class: DynamicMethod

Set the visibility of this method.

Overrides:

setVisibility in class DynamicMethod

Parameters:

visibility - The visibility of this method

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.

getFile

public java.lang.String getFile()

Description copied from interface: PositionAware

Get the filename for the method.

Specified by:

getFile in interface PositionAware

Returns:

the filename for the method

getLine

public int getLine()

Description copied from interface: PositionAware

Get the line number for the method.

Specified by:

getLine in interface PositionAware

Returns:

the line number for the method

getParameterList

public java.lang.String[] getParameterList()

Specified by:

getParameterList in interface MethodArgs2