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

Field Summary

Fields

Modifier and Type	Field and Description
static int	ARGS_INDEX The lvar index of the method args on the call
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 ClassDefiningJRubyClassLoader	classLoader The classloader to use for code loading
static int	NAME_INDEX The lvar index method name being invoked
static int	RECEIVER_INDEX The lvar index of the method-receiving object
protected 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 interface org.objectweb.asm.Opcodes

AALOAD, AASTORE, ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEPRECATED, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_MANDATED, ACC_NATIVE, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASM4, ASM5, 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, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6, V1_7, V1_8

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
protected Class	endClass(org.objectweb.asm.ClassWriter cw, 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, List<JavaMethodDescriptor> descs) Use code generation to provide a method handle based on an annotated Java method.
Class	getAnnotatedMethodClass(List<JavaMethodDescriptor> descs) Use code generation to provide a method handle based on an annotated Java method.
static String	getPostMethod(CallConfiguration callConfig)
protected boolean	safeFixedSignature(Signature signature)

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

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 ClassDefiningJRubyClassLoader classLoader

The classloader to use for code loading

syncObject

protected final Object syncObject

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

Constructor Detail

InvocationMethodFactory

public InvocationMethodFactory(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

safeFixedSignature

protected boolean safeFixedSignature(Signature signature)

getAnnotatedMethod

public DynamicMethod getAnnotatedMethod(RubyModule implementationClass,
                               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 Class getAnnotatedMethodClass(List<JavaMethodDescriptor> descs)
                              throws Exception

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

Throws:

Exception

See Also:

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

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

getPostMethod

public static String getPostMethod(CallConfiguration callConfig)

endClass

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