org.jruby.ir.targets

Class IRBytecodeAdapter

java.lang.Object

org.jruby.ir.targets.IRBytecodeAdapter

Direct Known Subclasses:

IRBytecodeAdapter6

public abstract class IRBytecodeAdapter
extends java.lang.Object

Author:

headius

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IRBytecodeAdapter.BlockPassType

Field Summary

Fields

Modifier and Type	Field and Description
SkinnyMethodAdapter	adapter
int	ipc
static int	MAX_ARGUMENTS
protected com.headius.invokebinder.Signature	signature

Constructor Summary

Constructors

Constructor and Description
IRBytecodeAdapter(SkinnyMethodAdapter adapter, com.headius.invokebinder.Signature signature, org.jruby.ir.targets.ClassData classData)

Method Summary

Modifier and Type	Method and Description
abstract void	array(int length) Construct an Array from elements on stack.
void	bfalse(org.objectweb.asm.Label label)
void	branchIfNil(org.objectweb.asm.Label label) Branch to label if value at top of stack is nil stack: obj to check for nilness
void	branchIfTruthy(org.objectweb.asm.Label target)
void	btrue(org.objectweb.asm.Label label)
static void	cacheCallSite(SkinnyMethodAdapter method, java.lang.String className, java.lang.String siteName, java.lang.String scopeFieldName, CallBase call) Utility to lazily construct and cache a call site object.
abstract void	callEqq(EQQInstr call) Perform a === call appropriate for a case/when statement.
abstract void	checkpoint() Perform a thread event checkpoint.
void	endMethod()
org.jruby.ir.targets.ClassData	getClassData()
abstract void	getField(java.lang.String name) Load instance variable from self.
abstract void	getGlobalVariable(java.lang.String name, java.lang.String file, int line) Retrieve a global variable with the given name.
java.lang.String	getUniqueSiteName(java.lang.String name)
void	goTo(org.objectweb.asm.Label label)
abstract void	hash(int length) Construct a Hash from elements on stack.
abstract void	inheritanceSearchConst(java.lang.String name, boolean noPrivateConsts) Lookup a constant from a given class or module.
abstract void	invokeArrayDeref(java.lang.String file, int line, CallBase call) Invoke the array dereferencing method ([]) on an object other than self.
abstract void	invokeClassSuper(java.lang.String file, int line, java.lang.String name, int arity, boolean hasClosure, boolean[] splatmap) Invoke a superclass method from a class context.
void	invokeHelper(java.lang.String name, java.lang.Class... x)
void	invokeHelper(java.lang.String name, java.lang.String sig)
abstract void	invokeInstanceSuper(java.lang.String file, int line, java.lang.String name, int arity, boolean hasClosure, boolean[] splatmap) Invoke a superclass method from an instance context.
void	invokeIRHelper(java.lang.String name, java.lang.String sig)
abstract void	invokeOther(java.lang.String file, int line, java.lang.String scopeFieldName, CallBase call, int arity) Invoke a method on an object other than self.
abstract void	invokeOtherOneFixnum(java.lang.String file, int line, CallBase call, long fixnum) Invoke a fixnum-receiving method on an object other than self.
abstract void	invokeOtherOneFloat(java.lang.String file, int line, CallBase call, double flote) Invoke a float-receiving method on an object other than self.
abstract void	invokeSelf(java.lang.String file, int line, java.lang.String scopeFieldName, CallBase call, int arity) Invoke a method on self.
void	invokeStatic(org.objectweb.asm.Type type, org.objectweb.asm.commons.Method method)
abstract void	invokeUnresolvedSuper(java.lang.String file, int line, java.lang.String name, int arity, boolean hasClosure, boolean[] splatmap) Invoke a superclass method from an unresolved context.
void	invokeVirtual(org.objectweb.asm.Type type, org.objectweb.asm.commons.Method method)
abstract void	invokeZSuper(java.lang.String file, int line, java.lang.String name, int arity, boolean hasClosure, boolean[] splatmap) Invoke a superclass method from a zsuper in a block.
abstract void	kwargsHash(int length) Construct a Hash based on keyword arguments pasesd to this method, for use in zsuper Stack required: context, kwargs hash to dup, remaining elements of hash
abstract void	lexicalSearchConst(java.lang.String name) Lookup a constant from a lexical scope.
void	loadArgs()
void	loadBlock()
void	loadContext()
void	loadFrameClass()
void	loadFrameName()
void	loadLocal(int i)
abstract void	loadRuntime() Push the JRuby runtime on the stack.
void	loadSelf()
void	loadSelfBlock()
void	loadStaticScope()
void	mark(org.objectweb.asm.Label label)
org.objectweb.asm.Label	newLabel()
int	newLocal(java.lang.String name, org.objectweb.asm.Type type)
void	poll()
abstract void	prepareBlock(org.objectweb.asm.Handle handle, Signature signature, java.lang.String className) Prepare a block for a subsequent call.
abstract void	pushBignum(java.math.BigInteger bigint) Load a Bignum onto the stack.
abstract void	pushBoolean(boolean b) Load a boolean onto the stack.
abstract void	pushByteList(ByteList bl) Stack required: none
abstract void	pushDRegexp(java.lang.Runnable callback, RegexpOptions options, int arity) Build a dynamic regexp.
abstract void	pushEncoding(org.jcodings.Encoding encoding) Push an encoding on the stack.
abstract void	pushFixnum(long l) Stack required: none
abstract void	pushFloat(double d) Stack required: none
abstract void	pushFrozenString(ByteList bl, int cr, java.lang.String path, int line) Stack required: none
void	pushHandle(org.objectweb.asm.Handle handle)
abstract void	pushNil() Load nil onto the stack.
void	pushObjectClass()
abstract void	pushRegexp(ByteList source, int options) Build and save a literal regular expression.
abstract void	pushString(ByteList bl, int cr) Stack required: none
abstract void	pushSymbol(ByteList bytes) Push a symbol on the stack.
abstract void	pushSymbolProc(java.lang.String id) Push a Symbol.to_proc on the stack.
void	pushUndefined()
abstract void	putField(java.lang.String name) Store instance variable into self.
void	returnValue()
abstract void	searchConst(java.lang.String name, boolean noPrivateConsts) Lookup a constant from current context.
abstract void	searchModuleForConst(java.lang.String name, boolean noPrivateConsts, boolean callConstMissing) Lookup a constant from current module.
abstract void	setGlobalVariable(java.lang.String name, java.lang.String file, int line) Set the global variable with the given name to the value on stack.
void	startMethod()
void	storeArgs()
void	storeLocal(int i)
void	storeSelf()
abstract void	yield(boolean unwrap) Yield argument list to a block.
abstract void	yieldSpecific() Yield to a block.
abstract void	yieldValues(int arity) Yield a number of flat arguments to a block.

Methods inherited from class java.lang.Object

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

Field Detail

MAX_ARGUMENTS

public static final int MAX_ARGUMENTS

See Also:

Constant Field Values

adapter

public SkinnyMethodAdapter adapter

signature

protected final com.headius.invokebinder.Signature signature

ipc

public int ipc

Constructor Detail

IRBytecodeAdapter

public IRBytecodeAdapter(SkinnyMethodAdapter adapter,
                         com.headius.invokebinder.Signature signature,
                         org.jruby.ir.targets.ClassData classData)

Method Detail

cacheCallSite

public static void cacheCallSite(SkinnyMethodAdapter method,
                                 java.lang.String className,
                                 java.lang.String siteName,
                                 java.lang.String scopeFieldName,
                                 CallBase call)

Utility to lazily construct and cache a call site object.

Parameters:

method - the SkinnyMethodAdapter to that's generating the containing method body

className - the name of the class in which the field will reside

siteName - the unique name of the site, used for the field

call - of we are making a callsite for.

getUniqueSiteName

public java.lang.String getUniqueSiteName(java.lang.String name)

getClassData

public org.jruby.ir.targets.ClassData getClassData()

startMethod

public void startMethod()

endMethod

public void endMethod()

loadLocal

public void loadLocal(int i)

loadContext

public void loadContext()

loadSelfBlock

public void loadSelfBlock()

loadStaticScope

public void loadStaticScope()

loadSelf

public void loadSelf()

loadArgs

public void loadArgs()

loadBlock

public void loadBlock()

loadFrameClass

public void loadFrameClass()

loadFrameName

public void loadFrameName()

storeSelf

public void storeSelf()

storeArgs

public void storeArgs()

storeLocal

public void storeLocal(int i)

invokeVirtual

public void invokeVirtual(org.objectweb.asm.Type type,
                          org.objectweb.asm.commons.Method method)

invokeStatic

public void invokeStatic(org.objectweb.asm.Type type,
                         org.objectweb.asm.commons.Method method)

invokeHelper

public void invokeHelper(java.lang.String name,
                         java.lang.String sig)

invokeHelper

public void invokeHelper(java.lang.String name,
                         java.lang.Class... x)

invokeIRHelper

public void invokeIRHelper(java.lang.String name,
                           java.lang.String sig)

goTo

public void goTo(org.objectweb.asm.Label label)

branchIfTruthy

public void branchIfTruthy(org.objectweb.asm.Label target)

branchIfNil

public void branchIfNil(org.objectweb.asm.Label label)

Branch to label if value at top of stack is nil stack: obj to check for nilness

bfalse

public void bfalse(org.objectweb.asm.Label label)

btrue

public void btrue(org.objectweb.asm.Label label)

poll

public void poll()

pushObjectClass

public void pushObjectClass()

pushUndefined

public void pushUndefined()

pushHandle

public void pushHandle(org.objectweb.asm.Handle handle)

mark

public void mark(org.objectweb.asm.Label label)

returnValue

public void returnValue()

newLocal

public int newLocal(java.lang.String name,
                    org.objectweb.asm.Type type)

newLabel

public org.objectweb.asm.Label newLabel()

pushFixnum

public abstract void pushFixnum(long l)

Stack required: none

Parameters:

l - long value to push as a Fixnum

pushFloat

public abstract void pushFloat(double d)

Stack required: none

Parameters:

d - double value to push as a Float

pushString

public abstract void pushString(ByteList bl,
                                int cr)

Stack required: none

Parameters:

bl - ByteList for the String to push

pushFrozenString

public abstract void pushFrozenString(ByteList bl,
                                      int cr,
                                      java.lang.String path,
                                      int line)

Stack required: none

Parameters:

bl - ByteList for the String to push

pushByteList

public abstract void pushByteList(ByteList bl)

Stack required: none

Parameters:

bl - ByteList to push

pushRegexp

public abstract void pushRegexp(ByteList source,
                                int options)

Build and save a literal regular expression. Stack required: none

Parameters:

options - options for the regexp

pushDRegexp

public abstract void pushDRegexp(java.lang.Runnable callback,
                                 RegexpOptions options,
                                 int arity)

Build a dynamic regexp. No stack requirement. The callback must push onto this method's stack the ThreadContext and all arguments for building the dregexp, matching the given arity.

Parameters:

options - options for the regexp

arity - number of Strings passed in

pushSymbol

public abstract void pushSymbol(ByteList bytes)

Push a symbol on the stack. Stack required: none

Parameters:

bytes - the ByteList for the symbol

pushSymbolProc

public abstract void pushSymbolProc(java.lang.String id)

Push a Symbol.to_proc on the stack. Stack required: none

Parameters:

id - raw id string for the symbol.

loadRuntime

public abstract void loadRuntime()

Push the JRuby runtime on the stack. Stack required: none

pushEncoding

public abstract void pushEncoding(org.jcodings.Encoding encoding)

Push an encoding on the stack. Stack required: none

Parameters:

encoding - the encoding to push

invokeOther

public abstract void invokeOther(java.lang.String file,
                                 int line,
                                 java.lang.String scopeFieldName,
                                 CallBase call,
                                 int arity)

Invoke a method on an object other than self. Stack required: context, self, all arguments, optional block

Parameters:

call - the call to be invoked

invokeArrayDeref

public abstract void invokeArrayDeref(java.lang.String file,
                                      int line,
                                      CallBase call)

Invoke the array dereferencing method ([]) on an object other than self. If this invokes against a Hash with a frozen string, it will follow an optimized path. Stack required: context, self, target, arg0

Parameters:

file -

line -

invokeOtherOneFixnum

public abstract void invokeOtherOneFixnum(java.lang.String file,
                                          int line,
                                          CallBase call,
                                          long fixnum)

Invoke a fixnum-receiving method on an object other than self. Stack required: context, self, receiver (fixnum will be handled separately)

invokeOtherOneFloat

public abstract void invokeOtherOneFloat(java.lang.String file,
                                         int line,
                                         CallBase call,
                                         double flote)

Invoke a float-receiving method on an object other than self. Stack required: context, self, receiver (float will be handled separately)

invokeSelf

public abstract void invokeSelf(java.lang.String file,
                                int line,
                                java.lang.String scopeFieldName,
                                CallBase call,
                                int arity)

Invoke a method on self. Stack required: context, caller, self, all arguments, optional block

Parameters:

file - the filename of the script making this call

line - the line number where this call appears

call - to be invoked on self

arity - of the call.

invokeInstanceSuper

public abstract void invokeInstanceSuper(java.lang.String file,
                                         int line,
                                         java.lang.String name,
                                         int arity,
                                         boolean hasClosure,
                                         boolean[] splatmap)

Invoke a superclass method from an instance context. Stack required: context, caller, self, start class, arguments[, block]

Parameters:

file - the filename of the script making this call

line - the line number where this call appears

name - name of the method to invoke

arity - arity of the arguments on the stack

hasClosure - whether a block is passed

splatmap - a map of arguments to be splatted back into arg list

invokeClassSuper

public abstract void invokeClassSuper(java.lang.String file,
                                      int line,
                                      java.lang.String name,
                                      int arity,
                                      boolean hasClosure,
                                      boolean[] splatmap)

Invoke a superclass method from a class context. Stack required: context, caller, self, start class, arguments[, block]

Parameters:

file - the filename of the script making this call

line - the line number where this call appears

name - name of the method to invoke

arity - arity of the arguments on the stack

hasClosure - whether a block is passed

splatmap - a map of arguments to be splatted back into arg list

invokeUnresolvedSuper

public abstract void invokeUnresolvedSuper(java.lang.String file,
                                           int line,
                                           java.lang.String name,
                                           int arity,
                                           boolean hasClosure,
                                           boolean[] splatmap)

Invoke a superclass method from an unresolved context. Stack required: context, caller, self, arguments[, block]

Parameters:

file - the filename of the script making this call

line - the line number where this call appears

name - name of the method to invoke

arity - arity of the arguments on the stack

hasClosure - whether a block is passed

splatmap - a map of arguments to be splatted back into arg list

invokeZSuper

public abstract void invokeZSuper(java.lang.String file,
                                  int line,
                                  java.lang.String name,
                                  int arity,
                                  boolean hasClosure,
                                  boolean[] splatmap)

Invoke a superclass method from a zsuper in a block. Stack required: context, caller, self, arguments[, block]

Parameters:

file - the filename of the script making this call

line - the line number where this call appears

name - name of the method to invoke

arity - arity of the arguments on the stack

hasClosure - whether a block is passed

splatmap - a map of arguments to be splatted back into arg list

searchConst

public abstract void searchConst(java.lang.String name,
                                 boolean noPrivateConsts)

Lookup a constant from current context. Stack required: context, static scope

Parameters:

name - name of the constant

noPrivateConsts - whether to ignore private constants

searchModuleForConst

public abstract void searchModuleForConst(java.lang.String name,
                                          boolean noPrivateConsts,
                                          boolean callConstMissing)

Lookup a constant from current module. Stack required: context, static scope

Parameters:

name - name of the constant

noPrivateConsts - whether to ignore private constants

inheritanceSearchConst

public abstract void inheritanceSearchConst(java.lang.String name,
                                            boolean noPrivateConsts)

Lookup a constant from a given class or module. Stack required: context, module

Parameters:

name - name of the constant

noPrivateConsts - whether to ignore private constants

lexicalSearchConst

public abstract void lexicalSearchConst(java.lang.String name)

Lookup a constant from a lexical scope. Stack required: context, static scope

Parameters:

name - name of the constant

pushNil

public abstract void pushNil()

Load nil onto the stack. Stack required: none

pushBoolean

public abstract void pushBoolean(boolean b)

Load a boolean onto the stack. Stack required: none

Parameters:

b - the boolean to push

pushBignum

public abstract void pushBignum(java.math.BigInteger bigint)

Load a Bignum onto the stack. Stack required: none

Parameters:

bigint - the value of the Bignum to push

putField

public abstract void putField(java.lang.String name)

Store instance variable into self. Stack required: self, value Stack result: empty

Parameters:

name - name of variable to store

getField

public abstract void getField(java.lang.String name)

Load instance variable from self. Stack required: self Stack result: value from self

Parameters:

name - name of variable to load

array

public abstract void array(int length)

Construct an Array from elements on stack. Stack required: all elements of array

Parameters:

length - number of elements

hash

public abstract void hash(int length)

Construct a Hash from elements on stack. Stack required: context, all elements of hash

Parameters:

length - number of element pairs

kwargsHash

public abstract void kwargsHash(int length)

Construct a Hash based on keyword arguments pasesd to this method, for use in zsuper Stack required: context, kwargs hash to dup, remaining elements of hash

Parameters:

length - number of element pairs

checkpoint

public abstract void checkpoint()

Perform a thread event checkpoint. Stack required: none

getGlobalVariable

public abstract void getGlobalVariable(java.lang.String name,
                                       java.lang.String file,
                                       int line)

Retrieve a global variable with the given name. Stack required: none

setGlobalVariable

public abstract void setGlobalVariable(java.lang.String name,
                                       java.lang.String file,
                                       int line)

Set the global variable with the given name to the value on stack. Stack required: the new value

yield

public abstract void yield(boolean unwrap)

Yield argument list to a block. Stack required: context, block, argument

yieldSpecific

public abstract void yieldSpecific()

Yield to a block. Stack required: context, block

yieldValues

public abstract void yieldValues(int arity)

Yield a number of flat arguments to a block. Stack required: context, block

prepareBlock

public abstract void prepareBlock(org.objectweb.asm.Handle handle,
                                  Signature signature,
                                  java.lang.String className)

Prepare a block for a subsequent call. Stack required: context, self, dynamicScope

callEqq

public abstract void callEqq(EQQInstr call)

Perform a === call appropriate for a case/when statement. Stack required: context, case value, when value