/*
 * Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * The Universal Permissive License (UPL), Version 1.0
 *
 * Subject to the condition set forth below, permission is hereby granted to any
 * person obtaining a copy of this software, associated documentation and/or
 * data (collectively the "Software"), free of charge and under any and all
 * copyright rights in the Software, and any and all patent rights owned or
 * freely licensable by each licensor hereunder covering either (i) the
 * unmodified Software as contributed to or provided by such licensor, or (ii)
 * the Larger Works (as defined below), to deal in both
 *
 * (a) the Software, and
 *
 * (b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
 * one is included with the Software each a "Larger Work" to which the Software
 * is contributed by such licensors),
 *
 * without restriction, including without limitation the rights to copy, create
 * derivative works of, display, perform, and distribute the Software and make,
 * use, sell, offer for sale, import, export, have made, and have sold the
 * Software and the Larger Work(s), and to sublicense the foregoing rights on
 * either these or other terms.
 *
 * This license is subject to the following condition:
 *
 * The above copyright notice and either this complete permission notice or at a
 * minimum a reference to the UPL must be included in all copies or substantial
 * portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
package com.oracle.truffle.api.impl;

import java.io.Closeable;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.Iterator;
import java.util.Objects;
import java.util.ServiceConfigurationError;
import java.util.ServiceLoader;

import com.oracle.truffle.api.Assumption;
import com.oracle.truffle.api.CallTarget;
import com.oracle.truffle.api.CompilerDirectives;
import com.oracle.truffle.api.CompilerOptions;
import com.oracle.truffle.api.RootCallTarget;
import com.oracle.truffle.api.Truffle;
import com.oracle.truffle.api.TruffleRuntime;
import com.oracle.truffle.api.frame.Frame;
import com.oracle.truffle.api.frame.FrameDescriptor;
import com.oracle.truffle.api.frame.FrameInstance;
import com.oracle.truffle.api.frame.FrameInstanceVisitor;
import com.oracle.truffle.api.frame.MaterializedFrame;
import com.oracle.truffle.api.frame.VirtualFrame;
import com.oracle.truffle.api.nodes.DirectCallNode;
import com.oracle.truffle.api.nodes.IndirectCallNode;
import com.oracle.truffle.api.nodes.LoopNode;
import com.oracle.truffle.api.nodes.Node;
import com.oracle.truffle.api.nodes.RepeatingNode;
import com.oracle.truffle.api.nodes.RootNode;

Default implementation of the Truffle runtime if the virtual machine does not provide a better performing alternative.

This is an implementation-specific class. Do not use or instantiate it. Instead, use Truffle.getRuntime() to retrieve the current TruffleRuntime.

/** * Default implementation of the Truffle runtime if the virtual machine does not provide a better * performing alternative. * <p> * This is an implementation-specific class. Do not use or instantiate it. Instead, use * {@link Truffle#getRuntime()} to retrieve the current {@link TruffleRuntime}. */
public final class DefaultTruffleRuntime implements TruffleRuntime { private final ThreadLocal<DefaultFrameInstance> stackTraces = new ThreadLocal<>(); private final DefaultTVMCI tvmci = new DefaultTVMCI(); private final TVMCI.Test<Closeable, CallTarget> testTvmci = new TVMCI.Test<Closeable, CallTarget>() { @Override protected Closeable createTestContext(String testName) { return null; } @Override public CallTarget createTestCallTarget(Closeable testContext, RootNode testNode) { return createCallTarget(testNode); } @Override public void finishWarmup(Closeable testContext, CallTarget callTarget) { // do nothing if we have no compiler } }; public DefaultTruffleRuntime() { }
Utility method that casts the singleton TruffleRuntime.
/** * Utility method that casts the singleton {@link TruffleRuntime}. */
static DefaultTruffleRuntime getRuntime() { return (DefaultTruffleRuntime) Truffle.getRuntime(); } public DefaultTVMCI getTvmci() { return tvmci; } @Override public String getName() { return "Interpreted"; } @SuppressWarnings("deprecation") @Override public RootCallTarget createCallTarget(RootNode rootNode) { DefaultCallTarget target = new DefaultCallTarget(rootNode); DefaultRuntimeAccessor.INSTRUMENT.onLoad(target.getRootNode()); return target; } @Override public DirectCallNode createDirectCallNode(CallTarget target) { Objects.requireNonNull(target); return new DefaultDirectCallNode(target); } @Override public IndirectCallNode createIndirectCallNode() { return new DefaultIndirectCallNode(); } @Override public VirtualFrame createVirtualFrame(Object[] arguments, FrameDescriptor frameDescriptor) { return new DefaultVirtualFrame(frameDescriptor, arguments); } @Override public MaterializedFrame createMaterializedFrame(Object[] arguments) { return createMaterializedFrame(arguments, new FrameDescriptor()); } @Override public MaterializedFrame createMaterializedFrame(Object[] arguments, FrameDescriptor frameDescriptor) { return new DefaultMaterializedFrame(new DefaultVirtualFrame(frameDescriptor, arguments)); } @Override public CompilerOptions createCompilerOptions() { return new DefaultCompilerOptions(); } @Override public Assumption createAssumption() { return createAssumption(null); } @Override public Assumption createAssumption(String name) { return new DefaultAssumption(name); } @Override public <T> T iterateFrames(FrameInstanceVisitor<T> visitor) { T result = null; DefaultFrameInstance frameInstance = getThreadLocalStackTrace(); while (frameInstance != null) { result = visitor.visitFrame(frameInstance); if (result != null) { return result; } frameInstance = frameInstance.callerFrame; } return result; } @Override public FrameInstance getCallerFrame() { DefaultFrameInstance currentFrame = getThreadLocalStackTrace(); if (currentFrame != null) { return currentFrame.callerFrame; } else { return null; } } @Override public FrameInstance getCurrentFrame() { return getThreadLocalStackTrace(); } private DefaultFrameInstance getThreadLocalStackTrace() { return stackTraces.get(); } private void setThreadLocalStackTrace(DefaultFrameInstance topFrame) { stackTraces.set(topFrame); } DefaultFrameInstance pushFrame(VirtualFrame frame, CallTarget target) { DefaultFrameInstance callerFrame = getThreadLocalStackTrace(); setThreadLocalStackTrace(new DefaultFrameInstance(frame, target, null, callerFrame)); return callerFrame; } DefaultFrameInstance pushFrame(VirtualFrame frame, CallTarget target, Node parentCallNode) { DefaultFrameInstance callerFrame = getThreadLocalStackTrace(); // we need to ensure that frame instances are immutable so we need to recreate the parent // frame DefaultFrameInstance callerFrameWithCallNode = callerFrame != null ? callerFrame.withCallNode(parentCallNode) : callerFrame; setThreadLocalStackTrace(new DefaultFrameInstance(frame, target, null, callerFrameWithCallNode)); return callerFrame; } void popFrame(DefaultFrameInstance callerFrame) { setThreadLocalStackTrace(callerFrame); } @Override public <T> T getCapability(Class<T> capability) { if (capability == TVMCI.Test.class) { return capability.cast(testTvmci); } else if (capability == TVMCI.class) { return capability.cast(tvmci); } final Iterator<T> it = Loader.load(capability).iterator(); try { return it.hasNext() ? it.next() : null; } catch (ServiceConfigurationError e) { return null; } } private static final class Loader { private static final Method LOAD_METHOD; static { Method loadMethod = null; try { Class<?> servicesClass = Class.forName("jdk.vm.ci.services.Services"); loadMethod = servicesClass.getMethod("load", Class.class); } catch (ClassNotFoundException | NoSuchMethodException e) { // Services.load is not available } if (loadMethod != null) { try { try { loadMethod.invoke(null, (Object) null); } catch (InvocationTargetException e) { throw e.getTargetException(); } } catch (NullPointerException npe) { // Services.load is accessible } catch (IllegalAccessException iae) { // Services.load is not accessible. This happens on JDK 9+ when EnableJVMCI is // true (either explicitly or by default) which causes the jdk.internal.vm.ci // module to be resolved. loadMethod = null; } catch (Throwable e) { throw new InternalError(e); } } LOAD_METHOD = loadMethod; } @SuppressWarnings("unchecked") static <S> Iterable<S> load(Class<S> service) { TruffleJDKServices.addUses(service); if (LOAD_METHOD != null) { try { return (Iterable<S>) LOAD_METHOD.invoke(null, service); } catch (Exception e) { throw new InternalError(e); } } else { return ServiceLoader.load(service); } } } public void notifyTransferToInterpreter() { } public LoopNode createLoopNode(RepeatingNode repeating) { if (!(repeating instanceof Node)) { throw new IllegalArgumentException("Repeating node must be of type Node."); } return new DefaultLoopNode(repeating); } public boolean isProfilingEnabled() { return false; } static final class DefaultFrameInstance implements FrameInstance { private final CallTarget target; private final VirtualFrame frame; private final Node callNode; private final DefaultFrameInstance callerFrame; DefaultFrameInstance(VirtualFrame frame, CallTarget target, Node callNode, DefaultFrameInstance callerFrame) { this.target = target; this.frame = frame; this.callNode = callNode; this.callerFrame = callerFrame; } public Frame getFrame(FrameAccess access) { Frame localFrame = this.frame; switch (access) { case READ_ONLY: /* Verify that it is really used read only. */ return new ReadOnlyFrame(localFrame); case READ_WRITE: return localFrame; case MATERIALIZE: return localFrame.materialize(); default: throw CompilerDirectives.shouldNotReachHere(); } } public boolean isVirtualFrame() { return false; } public CallTarget getCallTarget() { return target; } public Node getCallNode() { return callNode; } DefaultFrameInstance withCallNode(Node otherCallNode) { return new DefaultFrameInstance(frame, target, otherCallNode, callerFrame); } } }