Mercurial > hg > truffle
view truffle/com.oracle.truffle.sl/src/com/oracle/truffle/sl/runtime/SLContext.java @ 21997:c07e64ecb528
Update SL copyright headers to use UPL
author | Gilles Duboscq <gilles.m.duboscq@oracle.com> |
---|---|
date | Thu, 16 Jul 2015 15:50:46 +0200 |
parents | 9c8c0937da41 |
children | 5bc7f7b867ab |
line wrap: on
line source
/* * Copyright (c) 2012, 2014, 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.sl.runtime; import java.io.*; import com.oracle.truffle.api.*; import com.oracle.truffle.api.dsl.*; import com.oracle.truffle.api.frame.*; import com.oracle.truffle.api.nodes.*; import com.oracle.truffle.api.object.*; import com.oracle.truffle.api.source.*; import com.oracle.truffle.sl.builtins.*; import com.oracle.truffle.sl.nodes.*; import com.oracle.truffle.sl.nodes.local.*; import com.oracle.truffle.sl.parser.*; /** * The run-time state of SL during execution. One context is instantiated before any source code is * parsed, and this context is passed around to all methods that need access to it. For example, the * context is used during {@link SLNodeFactory parsing} and by {@link SLBuiltinNode#getContext() * builtin functions}. * <p> * It would be an error to have two different context instances during the execution of one script. * However, if two separate scripts run in one Java VM at the same time, they have a different * context. Therefore, the context is not a singleton. */ public final class SLContext extends ExecutionContext { private static final Layout LAYOUT = Layout.createLayout(); private final BufferedReader input; private final PrintWriter output; private final SLFunctionRegistry functionRegistry; private final Shape emptyShape; public SLContext(BufferedReader input, PrintWriter output) { this.input = input; this.output = output; this.functionRegistry = new SLFunctionRegistry(); installBuiltins(); this.emptyShape = LAYOUT.createShape(new ObjectType()); } /** * Returns the default input, i.e., the source for the {@link SLReadlnBuiltin}. To allow unit * testing, we do not use {@link System#in} directly. */ public BufferedReader getInput() { return input; } /** * The default default, i.e., the output for the {@link SLPrintlnBuiltin}. To allow unit * testing, we do not use {@link System#out} directly. */ public PrintWriter getOutput() { return output; } /** * Returns the registry of all functions that are currently defined. */ public SLFunctionRegistry getFunctionRegistry() { return functionRegistry; } /** * Adds all builtin functions to the {@link SLFunctionRegistry}. This method lists all * {@link SLBuiltinNode builtin implementation classes}. */ private void installBuiltins() { installBuiltin(SLReadlnBuiltinFactory.getInstance()); installBuiltin(SLPrintlnBuiltinFactory.getInstance()); installBuiltin(SLNanoTimeBuiltinFactory.getInstance()); installBuiltin(SLDefineFunctionBuiltinFactory.getInstance()); installBuiltin(SLStackTraceBuiltinFactory.getInstance()); installBuiltin(SLHelloEqualsWorldBuiltinFactory.getInstance()); installBuiltin(SLAssertTrueBuiltinFactory.getInstance()); installBuiltin(SLAssertFalseBuiltinFactory.getInstance()); installBuiltin(SLNewObjectBuiltinFactory.getInstance()); } public void installBuiltin(NodeFactory<? extends SLBuiltinNode> factory) { /* * The builtin node factory is a class that is automatically generated by the Truffle DSL. * The signature returned by the factory reflects the signature of the @Specialization * methods in the builtin classes. */ int argumentCount = factory.getExecutionSignature().size(); SLExpressionNode[] argumentNodes = new SLExpressionNode[argumentCount]; /* * Builtin functions are like normal functions, i.e., the arguments are passed in as an * Object[] array encapsulated in SLArguments. A SLReadArgumentNode extracts a parameter * from this array. */ for (int i = 0; i < argumentCount; i++) { argumentNodes[i] = new SLReadArgumentNode(null, i); } /* Instantiate the builtin node. This node performs the actual functionality. */ SLBuiltinNode builtinBodyNode = factory.createNode(argumentNodes, this); /* The name of the builtin function is specified via an annotation on the node class. */ String name = lookupNodeInfo(builtinBodyNode.getClass()).shortName(); /* Wrap the builtin in a RootNode. Truffle requires all AST to start with a RootNode. */ SLRootNode rootNode = new SLRootNode(this, new FrameDescriptor(), builtinBodyNode, name); /* Register the builtin function in our function registry. */ getFunctionRegistry().register(name, rootNode); } public static NodeInfo lookupNodeInfo(Class<?> clazz) { if (clazz == null) { return null; } NodeInfo info = clazz.getAnnotation(NodeInfo.class); if (info != null) { return info; } else { return lookupNodeInfo(clazz.getSuperclass()); } } /** * Evaluate a source, causing any definitions to be registered (but not executed). * * @param source The {@link Source} to parse. */ public void evalSource(Source source) { Parser.parseSL(this, source); } public DynamicObject createObject() { return LAYOUT.newInstance(emptyShape); } public static boolean isSLObject(Object value) { return LAYOUT.getType().isInstance(value); } public static DynamicObject castSLObject(Object value) { return LAYOUT.getType().cast(value); } }