org.jruby.internal.runtime.methods

Class AliasMethod

java.lang.Object

org.jruby.internal.runtime.methods.DynamicMethod

org.jruby.internal.runtime.methods.AliasMethod

public class AliasMethod
extends DynamicMethod

Represents a method which has been aliased. Aliased methods pass as frame class the implementationClass they were created with, which should reflect the level in the related class hierarchy where the alias appears. This allows aliased methods that super to do so from the appropriate starting level.

Nested Class Summary

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

DynamicMethod.NativeCall, DynamicMethod.Version

Field Summary

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

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

Constructor Summary

Constructors

Constructor and Description
AliasMethod(RubyModule implementationClass, CacheEntry entry, java.lang.String oldName) For some java native methods it is convenient to pass in a String instead of a ByteList.

Method Summary

Modifier and Type	Method and Description
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused) Arity 0, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, Block block) Arity 0, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, IRubyObject arg) Arity 1, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, 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 klazz, java.lang.String unused, IRubyObject[] args, Block block) The minimum 'call' method required for a dynamic method handle.
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, IRubyObject arg1, Block block) Arity 1, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, IRubyObject arg1, IRubyObject arg2) Arity 2, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, IRubyObject arg1, IRubyObject arg2, Block block) Arity 2, with block; calls through IRubyObject[] path
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3) Arity 3, no block
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, java.lang.String unused, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3, 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.
java.lang.String	getOldName()
DynamicMethod	getRealMethod() Get the "real" method contained within this method.
long	getSerialNumber() Get the global serial number for this method object

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

calculateProtectedClass, getCallConfig, getDefinedClass, getHandle, getImplementationClass, getMethodData, getName, getProtectedClass, getVisibility, init, init, isBuiltin, isCallableFrom, isImplementedBy, isNative, isNotImplemented, 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

Constructor Detail

AliasMethod

public AliasMethod(RubyModule implementationClass,
                   CacheEntry entry,
                   java.lang.String oldName)

For some java native methods it is convenient to pass in a String instead of a ByteList.

Method Detail

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule klazz,
                        java.lang.String unused)

Description copied from class: DynamicMethod

Arity 0, no block

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule klazz,
                        java.lang.String unused,
                        IRubyObject arg)

Description copied from class: DynamicMethod

Arity 1, no block

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule klazz,
                        java.lang.String unused,
                        IRubyObject arg1,
                        IRubyObject arg2)

Description copied from class: DynamicMethod

Arity 2, no block

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule klazz,
                        java.lang.String unused,
                        IRubyObject arg1,
                        IRubyObject arg2,
                        IRubyObject arg3)

Description copied from class: DynamicMethod

Arity 3, no block

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule klazz,
                        java.lang.String unused,
                        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

klazz - The Ruby class against which this method is binding

unused - The incoming name used to invoke this method

args - The first argument to this invocation

Returns:

The result of the call

call

public IRubyObject call(ThreadContext context,
                        IRubyObject self,
                        RubyModule klazz,
                        java.lang.String unused,
                        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 klazz,
                        java.lang.String unused,
                        IRubyObject arg1,
                        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 klazz,
                        java.lang.String unused,
                        IRubyObject arg1,
                        IRubyObject arg2,
                        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 klazz,
                        java.lang.String unused,
                        IRubyObject arg1,
                        IRubyObject arg2,
                        IRubyObject arg3,
                        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 klazz,
                        java.lang.String unused,
                        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

klazz - The Ruby class against which this method is binding

unused - 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

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.

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.

getOldName

public java.lang.String getOldName()

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, PartialDelegatingMethod, ...).

Overrides:

getRealMethod in class DynamicMethod

Returns:

The "real" method associated with this one

getSerialNumber

public long getSerialNumber()

Description copied from class: DynamicMethod

Get the global serial number for this method object

Overrides:

getSerialNumber in class DynamicMethod

Returns:

This method object's serial number