org.jruby.internal.runtime.methods

Class InvocationMethodFactory

java.lang.Object

org.jruby.runtime.MethodFactory

org.jruby.internal.runtime.methods.InvocationMethodFactory

All Implemented Interfaces:

org.objectweb.asm.Opcodes

Direct Known Subclasses:

DumpingInvocationMethodFactory, InvokeDynamicMethodFactory

public class InvocationMethodFactory
extends MethodFactory
implements org.objectweb.asm.Opcodes

In order to avoid the overhead with reflection-based method handles, this MethodFactory uses ASM to generate tiny invoker classes. This allows for better performance and more specialization per-handle than can be supported via reflection. It also allows optimizing away many conditionals that can be determined once ahead of time. When running in secured environments, this factory may not function. When this can be detected, MethodFactory will fall back on the reflection-based factory instead.

See Also:

MethodFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	InvocationMethodFactory.DescriptorInfo

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

MethodFactory.MethodDefiningCallback

Field Summary

Fields

Modifier and Type	Field and Description
static int	ARGS_INDEX The lvar index of the method args on the call
private static java.lang.String	BLOCK_CALL_SIG
private static java.lang.String	BLOCK_CALL_SIG19
static int	BLOCK_INDEX The lvar index of the passed-in Block on the call
static int	CLASS_INDEX The lvar index of the RubyClass being invoked against
protected JRubyClassLoader	classLoader The classloader to use for code loading
static java.lang.Class<CompiledBlockCallback19>	COMPILED_BLOCK_19_INTERFACE The interface used for compiled Ruby 1.9+ block handles.
static java.lang.String	COMPILED_BLOCK_19_INTERFACE_NAME The pathname of the interface for compiled Ruby block handles.
private static java.lang.Class<CompiledBlockCallback>	COMPILED_BLOCK_SUPER_CLASS The class used for the super class of compiled Ruby block handles.
private static java.lang.String	COMPILED_BLOCK_SUPER_CLASS_NAME The pathname of the super class for compiled Ruby block handles.
private static java.lang.String	COMPILED_CALL_SIG The outward call signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_BLOCK The outward call signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_ONE The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_ONE_BLOCK The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_THREE The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_THREE_BLOCK The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_TWO The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_TWO_BLOCK The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_ZERO The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.String	COMPILED_CALL_SIG_ZERO_BLOCK The outward arity-zero call-with-block signature for compiled Ruby method handles.
private static java.lang.Class	COMPILED_SUPER_CLASS The class used for the super class of compiled Ruby method handles.
private static java.lang.String	COMPILED_SUPER_CLASS_NAME The pathname of the super class for compiled Ruby method handles.
private static boolean	DEBUG
private boolean	haveWarnedUser Whether we've informed the user that we've seen undefined methods; this is to avoid a flood of repetitive information.
private static java.lang.String	JAVA_SUPER_SIG The super constructor signature for Java-based method handles.
private static Logger	LOG
static int	NAME_INDEX The lvar index method name being invoked
static int	RECEIVER_INDEX The lvar index of the method-receiving object
private boolean	seenUndefinedClasses Whether this factory has seen undefined methods already.
protected java.lang.Object	syncObject An object to sync against when loading classes, to avoid dups
static int	THIS_INDEX The lvar index of "this"
static int	THREADCONTEXT_INDEX The lvar index of the passed-in ThreadContext

Fields inherited from class org.jruby.runtime.MethodFactory

CAN_LOAD_BYTECODE, COMPILED_METHOD_PARAMS

Fields inherited from interface org.objectweb.asm.Opcodes

AALOAD, AASTORE, ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEPRECATED, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_MANDATED, ACC_MODULE, ACC_NATIVE, ACC_OPEN, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STATIC_PHASE, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_TRANSITIVE, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASM4, ASM5, ASM6, ASM7_EXPERIMENTAL, ASTORE, ATHROW, BALOAD, BASTORE, BIPUSH, CALOAD, CASTORE, CHECKCAST, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DMUL, DNEG, DOUBLE, DREM, DRETURN, DSTORE, DSUB, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, F_APPEND, F_CHOP, F_FULL, F_NEW, F_SAME, F_SAME1, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FLOAT, FMUL, FNEG, FREM, FRETURN, FSTORE, FSUB, GETFIELD, GETSTATIC, GOTO, H_GETFIELD, H_GETSTATIC, H_INVOKEINTERFACE, H_INVOKESPECIAL, H_INVOKESTATIC, H_INVOKEVIRTUAL, H_NEWINVOKESPECIAL, H_PUTFIELD, H_PUTSTATIC, I2B, I2C, I2D, I2F, I2L, I2S, IADD, IALOAD, IAND, IASTORE, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, ICONST_M1, IDIV, IF_ACMPEQ, IF_ACMPNE, IF_ICMPEQ, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ICMPLT, IF_ICMPNE, IFEQ, IFGE, IFGT, IFLE, IFLT, IFNE, IFNONNULL, IFNULL, IINC, ILOAD, IMUL, INEG, INSTANCEOF, INTEGER, INVOKEDYNAMIC, INVOKEINTERFACE, INVOKESPECIAL, INVOKESTATIC, INVOKEVIRTUAL, IOR, IREM, IRETURN, ISHL, ISHR, ISTORE, ISUB, IUSHR, IXOR, JSR, L2D, L2F, L2I, LADD, LALOAD, LAND, LASTORE, LCMP, LCONST_0, LCONST_1, LDC, LDIV, LLOAD, LMUL, LNEG, LONG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSUB, LUSHR, LXOR, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, NEW, NEWARRAY, NOP, NULL, POP, POP2, PUTFIELD, PUTSTATIC, RET, RETURN, SALOAD, SASTORE, SIPUSH, SWAP, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT, TABLESWITCH, TOP, UNINITIALIZED_THIS, V_PREVIEW_EXPERIMENTAL, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6, V1_7, V1_8, V10, V11, V9

Constructor Summary

Constructors

Constructor and Description
InvocationMethodFactory(java.lang.ClassLoader classLoader) Construct a new InvocationMethodFactory using the specified classloader to load code.

Method Summary

Modifier and Type	Method and Description
private void	addAnnotatedMethodInvoker(org.objectweb.asm.ClassWriter cw, java.lang.String callName, java.lang.String superClass, java.util.List<JavaMethodDescriptor> descs)
private SkinnyMethodAdapter	beginMethod(org.objectweb.asm.ClassWriter cw, java.lang.String methodName, int specificArity, boolean block)
private void	checkArity(JRubyMethod jrubyMethod, SkinnyMethodAdapter method, int specificArity) Emit code to check the arity of a call to a Java-based method.
private void	createAnnotatedMethodInvocation(JavaMethodDescriptor desc, SkinnyMethodAdapter method, java.lang.String superClass, int specificArity, boolean block)
private org.objectweb.asm.ClassWriter	createBlockCtor(java.lang.String namePath, java.lang.String classname)
private org.objectweb.asm.ClassWriter	createBlockCtor19(java.lang.String namePath, java.lang.String classname)
private org.objectweb.asm.ClassWriter	createCompiledCtor(java.lang.String namePath, java.lang.String shortPath, java.lang.String sup)
private org.objectweb.asm.ClassWriter	createJavaMethodCtor(java.lang.String namePath, java.lang.String sup, java.lang.String parameterDesc)
private java.lang.Class	determineSuperclass(InvocationMethodFactory.DescriptorInfo info)
protected java.lang.Class	endCall(org.objectweb.asm.ClassWriter cw, java.lang.String name)
protected byte[]	endCallOffline(org.objectweb.asm.ClassWriter cw)
protected java.lang.Class	endCallWithBytes(byte[] classBytes, java.lang.String name)
protected java.lang.Class	endClass(org.objectweb.asm.ClassWriter cw, java.lang.String name)
protected byte[]	endClassOffline(org.objectweb.asm.ClassWriter cw)
protected java.lang.Class	endClassWithBytes(byte[] code, java.lang.String name)
DynamicMethod	getAnnotatedMethod(RubyModule implementationClass, JavaMethodDescriptor desc) Use code generation to provide a method handle based on an annotated Java method.
DynamicMethod	getAnnotatedMethod(RubyModule implementationClass, java.util.List<JavaMethodDescriptor> descs) Use code generation to provide a method handle based on an annotated Java method.
java.lang.Class	getAnnotatedMethodClass(java.util.List<JavaMethodDescriptor> descs) Use code generation to provide a method handle based on an annotated Java method.
CompiledBlockCallback	getBlockCallback(java.lang.String method, java.lang.String file, int line, java.lang.Object scriptObject) Get a CompiledBlockCallback for the specified block
CompiledBlockCallback19	getBlockCallback19(java.lang.String method, java.lang.String file, int line, java.lang.Object scriptObject) Get a CompiledBlockCallback for the specified block
byte[]	getBlockCallback19Offline(java.lang.String method, java.lang.String file, int line, java.lang.String classname) Get a CompiledBlockCallback for the specified block, returning the bytes but not loading the class.
static java.lang.String	getBlockCallbackName(java.lang.String typePathString, java.lang.String method)
byte[]	getBlockCallbackOffline(java.lang.String method, java.lang.String file, int line, java.lang.String classname) Get a CompiledBlockCallback for the specified block, returning the bytes but not loading the class.
static java.lang.String	getCompiledCallbackName(java.lang.String typePath, java.lang.String method)
DynamicMethod	getCompiledMethod(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) Use code generation to provide a method handle for a compiled Ruby method.
DynamicMethod	getCompiledMethodLazily(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) Use code generation to provide a method handle for a compiled Ruby method.
byte[]	getCompiledMethodOffline(java.lang.String RubyName, java.lang.String method, java.lang.String className, java.lang.String invokerPath, Arity arity, StaticScope scope, CallConfiguration callConfig, java.lang.String filename, int line) Use code generation to provide a method handle for a compiled Ruby method.
static java.lang.String	getPostMethod(CallConfiguration callConfig)
private java.lang.String	getPreMethod(CallConfiguration callConfig)
private java.lang.String	getPreSignature(CallConfiguration callConfig)
private void	invokeCallConfigPost(SkinnyMethodAdapter mv, java.lang.String superClass, CallConfiguration callConfig)
private void	invokeCallConfigPre(SkinnyMethodAdapter mv, java.lang.String superClass, int specificArity, boolean block, CallConfiguration callConfig)
private void	invokeCCallTrace(SkinnyMethodAdapter method, int traceBoolIndex)
private void	invokeCReturnTrace(SkinnyMethodAdapter method, int traceBoolIndex)
private void	invokeTraceCompiledPost(SkinnyMethodAdapter mv, java.lang.String superClass, int traceBoolIndex)
private void	invokeTraceCompiledPre(SkinnyMethodAdapter mv, java.lang.String superClass, int traceBoolIndex, java.lang.String filename, int line)
private void	loadArguments(SkinnyMethodAdapter mv, JavaMethodDescriptor desc, int specificArity)
private void	loadArgumentWithCast(SkinnyMethodAdapter mv, int argNumber, java.lang.Class coerceType)
private void	loadBlock(SkinnyMethodAdapter mv, int specificArity, boolean getsBlock) load the block argument from the correct position.
private void	loadBlockForPre(SkinnyMethodAdapter mv, int specificArity, boolean getsBlock) load block argument for pre() call.
private void	loadReceiver(java.lang.String typePath, JavaMethodDescriptor desc, SkinnyMethodAdapter mv)
void	prepareAnnotatedMethod(RubyModule implementationClass, JavaMethod javaMethod, JavaMethodDescriptor desc) Use code generation to provide a method handle based on an annotated Java method.
private void	prepareForPre(SkinnyMethodAdapter mv, int specificArity, boolean block, CallConfiguration callConfig)
private SkinnyMethodAdapter	startBlockCall(org.objectweb.asm.ClassWriter cw)
private SkinnyMethodAdapter	startBlockCall19(org.objectweb.asm.ClassWriter cw)
private java.lang.Class	tryBlockCallback19Class(java.lang.String name, java.lang.Class expectedInterface)
private java.lang.Class	tryBlockCallbackClass(java.lang.String name, java.lang.Class expectedSuperclass)
private java.lang.Class	tryClass(java.lang.String name, java.lang.Class targetClass, java.lang.Class expectedSuperclass)

Methods inherited from class org.jruby.runtime.MethodFactory

createFactory

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final Logger LOG

DEBUG

private static final boolean DEBUG

See Also:

Constant Field Values

COMPILED_SUPER_CLASS

private static final java.lang.Class COMPILED_SUPER_CLASS

The class used for the super class of compiled Ruby method handles.

COMPILED_SUPER_CLASS_NAME

private static final java.lang.String COMPILED_SUPER_CLASS_NAME

The pathname of the super class for compiled Ruby method handles.

COMPILED_BLOCK_SUPER_CLASS

private static final java.lang.Class<CompiledBlockCallback> COMPILED_BLOCK_SUPER_CLASS

The class used for the super class of compiled Ruby block handles.

COMPILED_BLOCK_SUPER_CLASS_NAME

private static final java.lang.String COMPILED_BLOCK_SUPER_CLASS_NAME

The pathname of the super class for compiled Ruby block handles.

COMPILED_BLOCK_19_INTERFACE

public static final java.lang.Class<CompiledBlockCallback19> COMPILED_BLOCK_19_INTERFACE

The interface used for compiled Ruby 1.9+ block handles.

COMPILED_BLOCK_19_INTERFACE_NAME

public static final java.lang.String COMPILED_BLOCK_19_INTERFACE_NAME

The pathname of the interface for compiled Ruby block handles.

COMPILED_CALL_SIG

private static final java.lang.String COMPILED_CALL_SIG

The outward call signature for compiled Ruby method handles.

COMPILED_CALL_SIG_BLOCK

private static final java.lang.String COMPILED_CALL_SIG_BLOCK

The outward call signature for compiled Ruby method handles.

COMPILED_CALL_SIG_ZERO_BLOCK

private static final java.lang.String COMPILED_CALL_SIG_ZERO_BLOCK

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_ZERO

private static final java.lang.String COMPILED_CALL_SIG_ZERO

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_ONE_BLOCK

private static final java.lang.String COMPILED_CALL_SIG_ONE_BLOCK

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_ONE

private static final java.lang.String COMPILED_CALL_SIG_ONE

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_TWO_BLOCK

private static final java.lang.String COMPILED_CALL_SIG_TWO_BLOCK

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_TWO

private static final java.lang.String COMPILED_CALL_SIG_TWO

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_THREE_BLOCK

private static final java.lang.String COMPILED_CALL_SIG_THREE_BLOCK

The outward arity-zero call-with-block signature for compiled Ruby method handles.

COMPILED_CALL_SIG_THREE

private static final java.lang.String COMPILED_CALL_SIG_THREE

The outward arity-zero call-with-block signature for compiled Ruby method handles.

BLOCK_CALL_SIG

private static final java.lang.String BLOCK_CALL_SIG

BLOCK_CALL_SIG19

private static final java.lang.String BLOCK_CALL_SIG19

JAVA_SUPER_SIG

private static final java.lang.String JAVA_SUPER_SIG

The super constructor signature for Java-based method handles.

THIS_INDEX

public static final int THIS_INDEX

The lvar index of "this"

See Also:

Constant Field Values

THREADCONTEXT_INDEX

public static final int THREADCONTEXT_INDEX

The lvar index of the passed-in ThreadContext

See Also:

Constant Field Values

RECEIVER_INDEX

public static final int RECEIVER_INDEX

The lvar index of the method-receiving object

See Also:

Constant Field Values

CLASS_INDEX

public static final int CLASS_INDEX

The lvar index of the RubyClass being invoked against

See Also:

Constant Field Values

NAME_INDEX

public static final int NAME_INDEX

The lvar index method name being invoked

See Also:

Constant Field Values

ARGS_INDEX

public static final int ARGS_INDEX

The lvar index of the method args on the call

See Also:

Constant Field Values

BLOCK_INDEX

public static final int BLOCK_INDEX

The lvar index of the passed-in Block on the call

See Also:

Constant Field Values

classLoader

protected final JRubyClassLoader classLoader

The classloader to use for code loading

syncObject

protected final java.lang.Object syncObject

An object to sync against when loading classes, to avoid dups

seenUndefinedClasses

private boolean seenUndefinedClasses

Whether this factory has seen undefined methods already. This is used to detect likely method handle collisions when we expect to create a new handle for each call.

haveWarnedUser

private boolean haveWarnedUser

Whether we've informed the user that we've seen undefined methods; this is to avoid a flood of repetitive information.

Constructor Detail

InvocationMethodFactory

public InvocationMethodFactory(java.lang.ClassLoader classLoader)

Construct a new InvocationMethodFactory using the specified classloader to load code. If the target classloader is not an instance of JRubyClassLoader, it will be wrapped with one.

Parameters:

classLoader - The classloader to use, or to wrap if it is not a JRubyClassLoader instance.

Method Detail

getCompiledMethodLazily

public DynamicMethod getCompiledMethodLazily(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)

Use code generation 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

arity - The Arity 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.Arity, 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)

getCompiledCallbackName

public static java.lang.String getCompiledCallbackName(java.lang.String typePath,
                                                       java.lang.String method)

getCompiledMethod

public DynamicMethod getCompiledMethod(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)

Use code generation 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

arity - The Arity 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.Arity, 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)

getCompiledMethodOffline

public byte[] getCompiledMethodOffline(java.lang.String RubyName,
                                       java.lang.String method,
                                       java.lang.String className,
                                       java.lang.String invokerPath,
                                       Arity arity,
                                       StaticScope scope,
                                       CallConfiguration callConfig,
                                       java.lang.String filename,
                                       int line)

Use code generation to provide a method handle for a compiled Ruby method.

Overrides:

getCompiledMethodOffline in class MethodFactory

Parameters:

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

method - The name of the method

className - The path-like (with / instead of .) name of the class

invokerPath - The path-line name of the invoker to generate

arity - The Arity of the method

scope - The methods static scoping information.

callConfig - The call configuration to use for this method.

Returns:

See Also:

MethodFactory.getCompiledMethod(org.jruby.RubyModule, java.lang.String, java.lang.String, org.jruby.runtime.Arity, 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)

getAnnotatedMethod

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

Use code generation 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>)

getAnnotatedMethodClass

public java.lang.Class getAnnotatedMethodClass(java.util.List<JavaMethodDescriptor> descs)
                                        throws java.lang.Exception

Use code generation to provide a method handle based on an annotated Java method. Return the resulting generated or loaded class.

Throws:

java.lang.Exception

See Also:

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

determineSuperclass

private java.lang.Class determineSuperclass(InvocationMethodFactory.DescriptorInfo info)

getAnnotatedMethod

public DynamicMethod getAnnotatedMethod(RubyModule implementationClass,
                                        JavaMethodDescriptor desc)

Use code generation 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>)

getBlockCallbackName

public static java.lang.String getBlockCallbackName(java.lang.String typePathString,
                                                    java.lang.String method)

getBlockCallback

public CompiledBlockCallback getBlockCallback(java.lang.String method,
                                              java.lang.String file,
                                              int line,
                                              java.lang.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

getBlockCallbackOffline

public byte[] getBlockCallbackOffline(java.lang.String method,
                                      java.lang.String file,
                                      int line,
                                      java.lang.String classname)

Description copied from class: MethodFactory

Get a CompiledBlockCallback for the specified block, returning the bytes but not loading the class. This is used for offline generation of the callback class file.

Overrides:

getBlockCallbackOffline in class MethodFactory

Parameters:

method - The name of the method

classname - The /-based name of the class containing the method

Returns:

The bytes of the class

getBlockCallback19

public CompiledBlockCallback19 getBlockCallback19(java.lang.String method,
                                                  java.lang.String file,
                                                  int line,
                                                  java.lang.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

getBlockCallback19Offline

public byte[] getBlockCallback19Offline(java.lang.String method,
                                        java.lang.String file,
                                        int line,
                                        java.lang.String classname)

Description copied from class: MethodFactory

Get a CompiledBlockCallback for the specified block, returning the bytes but not loading the class. This is used for offline generation of the callback class file. This version generates a 1.9-compatible callback.

Overrides:

getBlockCallback19Offline in class MethodFactory

Parameters:

method - The name of the method

classname - The /-based name of the class containing the method

Returns:

The bytes of the class

startBlockCall

private SkinnyMethodAdapter startBlockCall(org.objectweb.asm.ClassWriter cw)

startBlockCall19

private SkinnyMethodAdapter startBlockCall19(org.objectweb.asm.ClassWriter cw)

createBlockCtor

private org.objectweb.asm.ClassWriter createBlockCtor(java.lang.String namePath,
                                                      java.lang.String classname)

createBlockCtor19

private org.objectweb.asm.ClassWriter createBlockCtor19(java.lang.String namePath,
                                                        java.lang.String classname)

prepareAnnotatedMethod

public void prepareAnnotatedMethod(RubyModule implementationClass,
                                   JavaMethod javaMethod,
                                   JavaMethodDescriptor desc)

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

See Also:

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

checkArity

private void checkArity(JRubyMethod jrubyMethod,
                        SkinnyMethodAdapter method,
                        int specificArity)

Emit code to check the arity of a call to a Java-based method.

Parameters:

jrubyMethod - The annotation of the called method

method - The code generator for the handle being created

createCompiledCtor

private org.objectweb.asm.ClassWriter createCompiledCtor(java.lang.String namePath,
                                                         java.lang.String shortPath,
                                                         java.lang.String sup)

createJavaMethodCtor

private org.objectweb.asm.ClassWriter createJavaMethodCtor(java.lang.String namePath,
                                                           java.lang.String sup,
                                                           java.lang.String parameterDesc)
                                                    throws java.lang.Exception

Throws:

java.lang.Exception

invokeCallConfigPre

private void invokeCallConfigPre(SkinnyMethodAdapter mv,
                                 java.lang.String superClass,
                                 int specificArity,
                                 boolean block,
                                 CallConfiguration callConfig)

invokeCallConfigPost

private void invokeCallConfigPost(SkinnyMethodAdapter mv,
                                  java.lang.String superClass,
                                  CallConfiguration callConfig)

prepareForPre

private void prepareForPre(SkinnyMethodAdapter mv,
                           int specificArity,
                           boolean block,
                           CallConfiguration callConfig)

getPreMethod

private java.lang.String getPreMethod(CallConfiguration callConfig)

getPreSignature

private java.lang.String getPreSignature(CallConfiguration callConfig)

getPostMethod

public static java.lang.String getPostMethod(CallConfiguration callConfig)

loadArguments

private void loadArguments(SkinnyMethodAdapter mv,
                           JavaMethodDescriptor desc,
                           int specificArity)

loadArgumentWithCast

private void loadArgumentWithCast(SkinnyMethodAdapter mv,
                                  int argNumber,
                                  java.lang.Class coerceType)

loadBlockForPre

private void loadBlockForPre(SkinnyMethodAdapter mv,
                             int specificArity,
                             boolean getsBlock)

load block argument for pre() call. Since we have fixed-arity call paths we need calculate where the last var holding the block is. is we don't have a block we setup NULL_BLOCK as part of our null pattern strategy (we do not allow null in any field which accepts block).

loadBlock

private void loadBlock(SkinnyMethodAdapter mv,
                       int specificArity,
                       boolean getsBlock)

load the block argument from the correct position. Since we have fixed- arity call paths we need to calculate where the last var holding the block is. If we don't have a block then this does nothing.

loadReceiver

private void loadReceiver(java.lang.String typePath,
                          JavaMethodDescriptor desc,
                          SkinnyMethodAdapter mv)

tryClass

private java.lang.Class tryClass(java.lang.String name,
                                 java.lang.Class targetClass,
                                 java.lang.Class expectedSuperclass)

tryBlockCallbackClass

private java.lang.Class tryBlockCallbackClass(java.lang.String name,
                                              java.lang.Class expectedSuperclass)

tryBlockCallback19Class

private java.lang.Class tryBlockCallback19Class(java.lang.String name,
                                                java.lang.Class expectedInterface)

endCall

protected java.lang.Class endCall(org.objectweb.asm.ClassWriter cw,
                                  java.lang.String name)

endCallWithBytes

protected java.lang.Class endCallWithBytes(byte[] classBytes,
                                           java.lang.String name)

endCallOffline

protected byte[] endCallOffline(org.objectweb.asm.ClassWriter cw)

endClass

protected java.lang.Class endClass(org.objectweb.asm.ClassWriter cw,
                                   java.lang.String name)

endClassWithBytes

protected java.lang.Class endClassWithBytes(byte[] code,
                                            java.lang.String name)

endClassOffline

protected byte[] endClassOffline(org.objectweb.asm.ClassWriter cw)

beginMethod

private SkinnyMethodAdapter beginMethod(org.objectweb.asm.ClassWriter cw,
                                        java.lang.String methodName,
                                        int specificArity,
                                        boolean block)

addAnnotatedMethodInvoker

private void addAnnotatedMethodInvoker(org.objectweb.asm.ClassWriter cw,
                                       java.lang.String callName,
                                       java.lang.String superClass,
                                       java.util.List<JavaMethodDescriptor> descs)

createAnnotatedMethodInvocation

private void createAnnotatedMethodInvocation(JavaMethodDescriptor desc,
                                             SkinnyMethodAdapter method,
                                             java.lang.String superClass,
                                             int specificArity,
                                             boolean block)

invokeCCallTrace

private void invokeCCallTrace(SkinnyMethodAdapter method,
                              int traceBoolIndex)

invokeCReturnTrace

private void invokeCReturnTrace(SkinnyMethodAdapter method,
                                int traceBoolIndex)

invokeTraceCompiledPre

private void invokeTraceCompiledPre(SkinnyMethodAdapter mv,
                                    java.lang.String superClass,
                                    int traceBoolIndex,
                                    java.lang.String filename,
                                    int line)

invokeTraceCompiledPost

private void invokeTraceCompiledPost(SkinnyMethodAdapter mv,
                                     java.lang.String superClass,
                                     int traceBoolIndex)