package org.jruby.ir.interpreter;
import java.util.EnumSet;
import java.util.List;
import java.util.Stack;
import java.util.concurrent.Callable;
import org.jruby.RubySymbol;
import org.jruby.ir.IRFlags;
import org.jruby.ir.IRMetaClassBody;
import org.jruby.ir.IRScope;
import org.jruby.ir.instructions.ExceptionRegionEndMarkerInstr;
import org.jruby.ir.instructions.ExceptionRegionStartMarkerInstr;
import org.jruby.ir.instructions.Instr;
import org.jruby.ir.instructions.LabelInstr;
import org.jruby.ir.representations.CFG;
import org.jruby.parser.StaticScope;
import org.jruby.runtime.DynamicScope;
import org.jruby.runtime.Helpers;
import org.jruby.runtime.ThreadContext;
public class InterpreterContext {
private final static Instr[] NO_INSTRUCTIONS = new Instr[0];
private final static InterpreterEngine DEFAULT_INTERPRETER = new InterpreterEngine();
private final static InterpreterEngine STARTUP_INTERPRETER = new StartupInterpreterEngine();
protected int temporaryVariableCount;
// startup interp will mark this at construction and not change but full interpreter will write it
// much later after running compiler passes. JIT will not use this field at all.
protected Instr[] instructions;
// Contains pairs of values. The first value is number of instrs in this range + number of instrs before
// this range. The second number is the rescuePC. getRescuePC(ipc) will walk this list and first odd value
// less than this value will be the rpc.
protected int[] rescueIPCs = null;
// Cached computed fields
private boolean hasExplicitCallProtocol;
private boolean pushNewDynScope;
private boolean reuseParentDynScope;
private boolean popDynScope;
private boolean receivesKeywordArguments;
private boolean metaClassBodyScope;
private InterpreterEngine engine;
public final Callable<List<Instr>> instructionsCallback;
private final IRScope scope;
public InterpreterContext(IRScope scope, List<Instr> instructions) {
this.scope = scope;
// FIXME: Hack null instructions means coming from FullInterpreterContext but this should be way cleaner
// For impl testing - engine = determineInterpreterEngine(scope);
setEngine(instructions == null ? DEFAULT_INTERPRETER : STARTUP_INTERPRETER);
this.metaClassBodyScope = scope instanceof IRMetaClassBody;
setInstructions(instructions);
this.instructionsCallback = null; // engine != null
}
public InterpreterContext(IRScope scope, Callable<List<Instr>> instructions) {
this.scope = scope;
this.metaClassBodyScope = scope instanceof IRMetaClassBody;
this.instructionsCallback = instructions;
}
public InterpreterEngine getEngine() {
if (engine == null) {
try {
setInstructions(instructionsCallback.call());
} catch (Exception e) {
Helpers.throwException(e);
}
// FIXME: Hack null instructions means coming from FullInterpreterContext but this should be way cleaner
// For impl testing - engine = determineInterpreterEngine(scope);
setEngine(instructions == null ? DEFAULT_INTERPRETER : STARTUP_INTERPRETER);
}
return engine;
}
public Instr[] getInstructions() {
if (instructions == null) {
getEngine();
}
return instructions == null ? NO_INSTRUCTIONS : instructions;
}
private void setInstructions(final List<Instr> instructions) {
this.instructions = instructions != null ? prepareBuildInstructions(instructions) : null;
}
private void retrieveFlags() {
this.temporaryVariableCount = scope.getTemporaryVariablesCount();
this.hasExplicitCallProtocol = scope.getFlags().contains(IRFlags.HAS_EXPLICIT_CALL_PROTOCOL);
// FIXME: Centralize this out of InterpreterContext
this.reuseParentDynScope = scope.getFlags().contains(IRFlags.REUSE_PARENT_DYNSCOPE);
this.pushNewDynScope = !scope.getFlags().contains(IRFlags.DYNSCOPE_ELIMINATED) && !reuseParentDynScope;
this.popDynScope = this.pushNewDynScope || this.reuseParentDynScope;
this.receivesKeywordArguments = scope.getFlags().contains(IRFlags.RECEIVES_KEYWORD_ARGS);
}
private Instr[] prepareBuildInstructions(List<Instr> instructions) {
int length = instructions.size();
Instr[] linearizedInstrArray = instructions.toArray(new Instr[length]);
for (int ipc = 0; ipc < length; ipc++) {
Instr i = linearizedInstrArray[ipc];
if (i instanceof LabelInstr) ((LabelInstr) i).getLabel().setTargetPC(ipc + 1);
}
Stack<Integer> markers = new Stack();
rescueIPCs = new int[length];
int rpc = -1;
for (int ipc = 0; ipc < length; ipc++) {
Instr i = linearizedInstrArray[ipc];
if (i instanceof ExceptionRegionStartMarkerInstr) {
rpc = ((ExceptionRegionStartMarkerInstr) i).getFirstRescueBlockLabel().getTargetPC();
markers.push(rpc);
} else if (i instanceof ExceptionRegionEndMarkerInstr) {
markers.pop();
rpc = markers.isEmpty() ? -1 : markers.peek().intValue();
}
rescueIPCs[ipc] = rpc;
}
return linearizedInstrArray;
}
public int[] getRescueIPCs() {
return rescueIPCs;
}
public int getRequiredArgsCount() {
return getStaticScope().getSignature().required();
}
public IRScope getScope() {
return scope;
}
Is the build complete? For startup builds, which this class represents, we finish build in the constructor
so it is always complete. For FullInterpreterContext this is more complicated (see javadocs there for more
info).
/**
* Is the build complete? For startup builds, which this class represents, we finish build in the constructor
* so it is always complete. For FullInterpreterContext this is more complicated (see javadocs there for more
* info).
*/
public boolean buildComplete() {
return true;
}
public CFG getCFG() {
return null;
}
public Object[] allocateTemporaryVariables() {
return temporaryVariableCount > 0 ? new Object[temporaryVariableCount] : null;
}
public boolean[] allocateTemporaryBooleanVariables() {
return null;
}
public long[] allocateTemporaryFixnumVariables() {
return null;
}
public double[] allocateTemporaryFloatVariables() {
return null;
}
public StaticScope getStaticScope() {
return scope.getStaticScope();
}
public String getFileName() {
return scope.getFile();
}
public RubySymbol getName() {
return scope.getManager().getRuntime().newSymbol(scope.getId());
}
public void computeScopeFlagsFromInstructions() {
for (Instr instr : getInstructions()) {
instr.computeScopeFlags(scope);
}
}
Get a new dynamic scope. Note: This only works for method scopes (ClosureIC will throw).
/**
* Get a new dynamic scope. Note: This only works for method scopes (ClosureIC will throw).
*/
public DynamicScope newDynamicScope(ThreadContext context) {
// Add a parent-link to current dynscope to support non-local returns cheaply. This doesn't
// affect variable scoping since local variables will all have the right scope depth.
if (metaClassBodyScope) return DynamicScope.newDynamicScope(getStaticScope(), context.getCurrentScope());
return DynamicScope.newDynamicScope(getStaticScope());
}
public boolean hasExplicitCallProtocol() {
return hasExplicitCallProtocol;
}
public boolean pushNewDynScope() {
return pushNewDynScope;
}
public boolean reuseParentDynScope() {
return reuseParentDynScope;
}
public boolean popDynScope() {
return popDynScope;
}
public boolean receivesKeywordArguments() {
return receivesKeywordArguments;
}
@Override
public String toString() {
StringBuilder buf = new StringBuilder();
buf.append(getFileName()).append(':').append(scope.getLine());
if (getName() != null) buf.append(' ').append(getName()).append("\n");
if (instructions == null) {
buf.append(" No Instructions. Full Build before linearizeInstr?");
} else {
buf.append(toStringInstrs()).append("\n");
}
return buf.toString();
}
public String toStringInstrs() {
StringBuilder b = new StringBuilder();
int length = instructions.length;
for (int i = 0; i < length; i++) {
if (i > 0) b.append("\n");
b.append(" ").append(i).append('\t').append(instructions[i]);
}
/* ENEBO: I this this is too much output espectially for ic and not fic
Collection<IRClosure> nestedClosures = scope.getClosures();
if (nestedClosures != null && !nestedClosures.isEmpty()) {
b.append("\n\n------ Closures encountered in this scope ------\n");
for (IRClosure c: nestedClosures)
b.append(c.toStringBody());
b.append("------------------------------------------------\n");
}*/
return b.toString();
}
public void setEngine(InterpreterEngine engine) {
this.engine = engine;
retrieveFlags();
}
public EnumSet<IRFlags> getFlags() {
return scope.getFlags();
}
}