org.jruby.internal.runtime.methods

Class ReflectionMethodFactory

java.lang.Object

org.jruby.runtime.MethodFactory

org.jruby.internal.runtime.methods.ReflectionMethodFactory

public class ReflectionMethodFactory
extends MethodFactory

This MethodFactory uses reflection to provide method handles. Reflection is typically slower than code-generated handles, but it does provide a simple mechanism for binding in environments where code-generation isn't supported.

See Also:

MethodFactory

Nested Class Summary

Nested classes/interfaces inherited from class org.jruby.runtime.MethodFactory

MethodFactory.MethodDefiningCallback

Field Summary

Fields inherited from class org.jruby.runtime.MethodFactory

CAN_LOAD_BYTECODE, COMPILED_METHOD_PARAMS

Constructor Summary

Constructors

Constructor and Description
ReflectionMethodFactory()

Method Summary

Methods

Modifier and Type	Method and Description
DynamicMethod	getAnnotatedMethod(RubyModule implementationClass, JavaMethodDescriptor desc) Use reflection to provide a method handle based on an annotated Java method.
DynamicMethod	getAnnotatedMethod(RubyModule implementationClass, List<JavaMethodDescriptor> descs) Use reflection to provide a method handle based on an annotated Java method.
CompiledBlockCallback	getBlockCallback(String method, String file, int line, Object scriptObject) Get a CompiledBlockCallback for the specified block
CompiledBlockCallback19	getBlockCallback19(String method, String file, int line, Object scriptObject) Get a CompiledBlockCallback for the specified block
DynamicMethod	getCompiledMethod(RubyModule implementationClass, String rubyName, String javaName, Visibility visibility, StaticScope scope, Object scriptObject, CallConfiguration callConfig, ISourcePosition position, String parameterDesc, MethodNodes methodNodes) Use reflection to provide a method handle for a compiled Ruby method.
DynamicMethod	getCompiledMethodLazily(RubyModule implementationClass, String rubyName, String javaName, Visibility visibility, StaticScope scope, Object scriptObject, CallConfiguration callConfig, ISourcePosition position, String parameterDesc, MethodNodes methodNodes) Use reflection to provide a method handle for a compiled Ruby method.

Methods inherited from class org.jruby.runtime.MethodFactory

createFactory, getBlockCallback19Offline, getBlockCallbackOffline, getCompiledMethodOffline

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionMethodFactory

public ReflectionMethodFactory()

Method Detail

getCompiledMethodLazily

public DynamicMethod getCompiledMethodLazily(RubyModule implementationClass,
                                    String rubyName,
                                    String javaName,
                                    Visibility visibility,
                                    StaticScope scope,
                                    Object scriptObject,
                                    CallConfiguration callConfig,
                                    ISourcePosition position,
                                    String parameterDesc,
                                    MethodNodes methodNodes)

Use reflection to provide a method handle for a compiled Ruby method.

Specified by:

getCompiledMethodLazily in class MethodFactory

Parameters:

implementationClass - The class to which the method will be bound.

rubyName - The Ruby method name to which the method will bind

javaName - The name of the method

visibility - The method's visibility on the target type.

scope - The methods static scoping information.

scriptObject - An instace of the target compiled method class.

callConfig - The call configuration to use for this method.

Returns:

A new method handle for the target compiled method.

See Also:

MethodFactory.getCompiledMethod(org.jruby.RubyModule, java.lang.String, java.lang.String, org.jruby.runtime.Visibility, org.jruby.parser.StaticScope, java.lang.Object, org.jruby.internal.runtime.methods.CallConfiguration, org.jruby.lexer.yacc.ISourcePosition, java.lang.String, org.jruby.internal.runtime.methods.MethodNodes)

getCompiledMethod

public DynamicMethod getCompiledMethod(RubyModule implementationClass,
                              String rubyName,
                              String javaName,
                              Visibility visibility,
                              StaticScope scope,
                              Object scriptObject,
                              CallConfiguration callConfig,
                              ISourcePosition position,
                              String parameterDesc,
                              MethodNodes methodNodes)

Use reflection to provide a method handle for a compiled Ruby method.

Specified by:

getCompiledMethod in class MethodFactory

Parameters:

implementationClass - The class to which the method will be bound.

rubyName - The Ruby method name to which the method will bind

javaName - The name of the method

visibility - The method's visibility on the target type.

scope - The methods static scoping information.

scriptObject - An instace of the target compiled method class.

callConfig - The call configuration to use for this method.

position - The position to use when generating traceable handles.

Returns:

A new method handle for the target compiled method.

See Also:

MethodFactory.getCompiledMethod(org.jruby.RubyModule, java.lang.String, java.lang.String, org.jruby.runtime.Visibility, org.jruby.parser.StaticScope, java.lang.Object, org.jruby.internal.runtime.methods.CallConfiguration, org.jruby.lexer.yacc.ISourcePosition, java.lang.String, org.jruby.internal.runtime.methods.MethodNodes)

getAnnotatedMethod

public DynamicMethod getAnnotatedMethod(RubyModule implementationClass,
                               JavaMethodDescriptor desc)

Use reflection to provide a method handle based on an annotated Java method.

Specified by:

getAnnotatedMethod in class MethodFactory

Parameters:

implementationClass - The target class or module on which the method will be bound.

desc - A JavaMethodDescriptor describing the target method

Returns:

A method handle for the target object.

See Also:

MethodFactory.getAnnotatedMethod(org.jruby.RubyModule, java.util.List<org.jruby.anno.JavaMethodDescriptor>)

getAnnotatedMethod

public DynamicMethod getAnnotatedMethod(RubyModule implementationClass,
                               List<JavaMethodDescriptor> descs)

Use reflection to provide a method handle based on an annotated Java method.

Specified by:

getAnnotatedMethod in class MethodFactory

Parameters:

implementationClass - The target class or module on which the method will be bound.

Returns:

A method handle for the target object.

See Also:

MethodFactory.getAnnotatedMethod(org.jruby.RubyModule, java.util.List<org.jruby.anno.JavaMethodDescriptor>)

getBlockCallback

public CompiledBlockCallback getBlockCallback(String method,
                                     String file,
                                     int line,
                                     Object scriptObject)

Description copied from class: MethodFactory

Get a CompiledBlockCallback for the specified block

Specified by:

getBlockCallback in class MethodFactory

Parameters:

method - The name of the method

scriptObject - The object in which the method can be found

Returns:

A new CompiledBlockCallback for the method

getBlockCallback19

public CompiledBlockCallback19 getBlockCallback19(String method,
                                         String file,
                                         int line,
                                         Object scriptObject)

Description copied from class: MethodFactory

Get a CompiledBlockCallback for the specified block

Specified by:

getBlockCallback19 in class MethodFactory

Parameters:

method - The name of the method

scriptObject - The object in which the method can be found

Returns:

A new CompiledBlockCallback for the method