Package org.jruby.internal.runtime.methods

Class PartialDelegatingMethod

java.lang.Object

org.jruby.internal.runtime.methods.DynamicMethod

org.jruby.internal.runtime.methods.PartialDelegatingMethod

public class PartialDelegatingMethod
extends DynamicMethod

This is similar to DelegatingDynamicMethod except that it does not delegate most properties of DynamicMethod. Visibility, etc, set on an instance of PartialDelegatingMethod will not be delegated to the contained method. This type of method is used primarily for altering the visibility of a parent class's method in a child class. Note that AliasMethod is not a suitable substitute since it always passes the method's original name to the delegate, and DelegatingDynamicMethod is not a suitable substitute since it delegates all properties to the delegate.

Author:

jpetersen

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
PartialDelegatingMethod(RubyModule implementationClass, CacheEntry entry, Visibility visibility)	Constructor for PartialDelegatingMethod.

Method Summary

Modifier and Type	Method	Description
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, Block block)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, IRubyObject arg)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, 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 klazz, String name, IRubyObject[] args, Block block)	The minimum 'call' method required for a dynamic method handle.
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, IRubyObject arg1, Block block)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, IRubyObject arg1, IRubyObject arg2)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, IRubyObject arg1, IRubyObject arg2, Block block)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, IRubyObject arg1, IRubyObject arg2, IRubyObject arg3)
IRubyObject	call(ThreadContext context, IRubyObject self, RubyModule klazz, String name, 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.
RubyModule	getDefinedClass()	Get the original owner of this method/
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.

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

adjustAliasCount, calculateProtectedClass, callRespondTo, getAliasCount, getCallConfig, getHandle, getImplementationClass, getInstanceVariableNames, getMethodData, getName, getProtectedClass, getVisibility, init, init, isBuiltin, isCallableFrom, isImplementedBy, isNative, isNotImplemented, isNull, isRefined, isUndefined, setCallConfig, setDefinedClass, setHandle, setImplementationClass, setIsBuiltin, setNotImplemented, setRuby2Keywords, setVisibility

Methods inherited from class java.lang.Object

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

Constructor Details

PartialDelegatingMethod

public PartialDelegatingMethod(RubyModule implementationClass,
 CacheEntry entry,
 Visibility visibility)

Constructor for PartialDelegatingMethod.

Parameters:

visibility -

Method Details

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

klazz - The Ruby class against which this method is binding

name - 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 name,
 Block block)

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

Overrides:

call in class DynamicMethod

call

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

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

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.

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

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

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

getDefinedClass

public RubyModule getDefinedClass()

Description copied from class: DynamicMethod

Get the original owner of this method/

Overrides:

getDefinedClass in class DynamicMethod

Returns:

the module method was defined in