Package 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

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

Constructor Summary

Constructors

Constructor	Description
AliasMethod(RubyModule implementationClass, CacheEntry entry, String newName, 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	Description
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, Block block)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, IRubyObject arg)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, 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, String unused, IRubyObject[] args, Block block)	The minimum 'call' method required for a dynamic method handle.
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, IRubyObject arg1, Block block)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, IRubyObject arg1, IRubyObject arg2)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, IRubyObject arg1, IRubyObject arg2, Block block)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String unused, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3, Block block)
DynamicMethod	dup()	Duplicate this method, returning DynamicMethod referencing the same code and with the same attributes.
Arity	getArity()	Deprecated.
String	getOldName()
DynamicMethod	getRealMethod()	Get the "real" method contained within this method.
long	getSerialNumber()	Get the global serial number for this method object
Signature	getSignature()	Retrieve the signature of this method.
boolean	isNative()	Returns true if this method is backed by native (i.e.
void	setRuby2Keywords()	Indicates the method will behave like a ruby2 keywords accepting method.

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

adjustAliasCount, calculateProtectedClass, callRespondTo, getAliasCount, getCallConfig, getDefinedClass, getHandle, getImplementationClass, getInstanceVariableNames, getMethodData, getName, getProtectedClass, getVisibility, init, init, isBuiltin, isCallableFrom, isImplementedBy, 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 Details

AliasMethod

public AliasMethod(RubyModule implementationClass,
 CacheEntry entry,
 String newName,
 String oldName)

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

Method Details

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule klazz,
 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,
 String unused,
 Block block)

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule klazz,
 String unused,
 IRubyObject arg1,
 Block block)

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule klazz,
 String unused,
 IRubyObject arg1,
 IRubyObject arg2,
 Block block)

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule klazz,
 String unused,
 IRubyObject arg1,
 IRubyObject arg2,
 IRubyObject arg3,
 Block block)

Overrides:

call in class DynamicMethod

call

public IRubyObject call(ThreadContext context,
 IRubyObject self,
 RubyModule klazz,
 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

@Deprecated
public Arity getArity()

Deprecated.

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.

getSignature

public Signature getSignature()

Description copied from class: DynamicMethod

Retrieve the signature of this method.

Overrides:

getSignature in class DynamicMethod

Returns:

the signature

getOldName

public 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

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

setRuby2Keywords

public void setRuby2Keywords()

Description copied from class: DynamicMethod

Indicates the method will behave like a ruby2 keywords accepting method. This must be a Ruby implementation to work. See Module#ruby2_keywords for information on the semantics of a method which is marked this way.

Overrides:

setRuby2Keywords in class DynamicMethod