truffle: truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java annotate

annotate truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java @ 22278:85a6db6624ab

Simplifying the way to obtain Language.globalObject

author	Jaroslav Tulach <jaroslav.tulach@oracle.com>
date	Tue, 06 Oct 2015 13:08:12 +0200
parents	412991d0359c
children	088b3121f5ae

rev	line source
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1 /*
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	2 * Copyright (c) 2014, 2015, Oracle and/or its affiliates. All rights reserved.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	4 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	5 * This code is free software; you can redistribute it and/or modify it
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	6 * under the terms of the GNU General Public License version 2 only, as
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	7 * published by the Free Software Foundation. Oracle designates this
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	8 * particular file as subject to the "Classpath" exception as provided
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	9 * by Oracle in the LICENSE file that accompanied this code.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	10 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	11 * This code is distributed in the hope that it will be useful, but WITHOUT
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	14 * version 2 for more details (a copy is included in the LICENSE file that
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	15 * accompanied this code).
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	16 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	17 * You should have received a copy of the GNU General Public License version
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	18 * 2 along with this work; if not, write to the Free Software Foundation,
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	20 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	22 * or visit www.oracle.com if you need additional information or have any
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	23 * questions.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	24 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	25 package com.oracle.truffle.api.vm;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	26
22157 dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	27 import java.io.Closeable;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	28 import java.io.File;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	29 import java.io.IOException;
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	30 import java.io.InputStream;
22157 dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	31 import java.io.InterruptedIOException;
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	32 import java.io.OutputStream;
22157 dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	33 import java.io.Reader;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	34 import java.io.Writer;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	35 import java.net.URI;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	36 import java.net.URL;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	37 import java.net.URLConnection;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	38 import java.nio.file.Files;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	39 import java.util.ArrayList;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	40 import java.util.Arrays;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	41 import java.util.Collections;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	42 import java.util.HashMap;
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	43 import java.util.HashSet;
22157 dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	44 import java.util.LinkedHashSet;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	45 import java.util.List;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	46 import java.util.Map;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	47 import java.util.Set;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	48 import java.util.concurrent.CountDownLatch;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	49 import java.util.concurrent.Executor;
22157 dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	50 import java.util.logging.Level;
dc83cc1f94f2 Using fully qualified imports Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22141 diff changeset	51 import java.util.logging.Logger;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	52
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	53 import com.oracle.truffle.api.CallTarget;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	54 import com.oracle.truffle.api.TruffleLanguage;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	55 import com.oracle.truffle.api.TruffleLanguage.Env;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	56 import com.oracle.truffle.api.TruffleLanguage.Registration;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	57 import com.oracle.truffle.api.debug.Debugger;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	58 import com.oracle.truffle.api.debug.ExecutionEvent;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	59 import com.oracle.truffle.api.debug.SuspendedEvent;
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	60 import com.oracle.truffle.api.frame.VirtualFrame;
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	61 import com.oracle.truffle.api.impl.Accessor;
22215 d3bdaa91bc82 Truffle/Instrumentation: method signature on TruffleLanguage for getting each language's "default" ASTProber Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22214 diff changeset	62 import com.oracle.truffle.api.instrument.Instrumenter;
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	63 import com.oracle.truffle.api.instrument.Probe;
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	64 import com.oracle.truffle.api.interop.ForeignAccess;
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	65 import com.oracle.truffle.api.interop.TruffleObject;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	66 import com.oracle.truffle.api.interop.java.JavaInterop;
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	67 import com.oracle.truffle.api.nodes.Node;
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	68 import com.oracle.truffle.api.source.Source;
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	69
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	70 /**
22171 41c5f430ce37 Using buildNew as that more directly indicates the use of Builder pattern Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22170 diff changeset	71 * Gate way into the world of {@link TruffleLanguage Truffle languages}. {@link #buildNew()
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	72 * Instantiate} your own portal into the isolated, multi language system with all the registered
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	73 * languages ready for your use. A {@link PolyglotEngine} runs inside of a <em>JVM</em>, there can
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	74 * however be multiple instances (some would say tenants) of {@link PolyglotEngine} running next to
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	75 * each other in a single <em>JVM</em> with a complete mutual isolation. There is 1:N mapping
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	76 * between <em>JVM</em> and {@link PolyglotEngine}.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	77 * <p>
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	78 * It would not be correct to think of a {@link PolyglotEngine} as a runtime for a single
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	79 * {@link TruffleLanguage Truffle language} (Ruby, Python, R, C, JavaScript, etc.) either.
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	80 * {@link PolyglotEngine} can host as many of Truffle languages as {@link Registration registered on
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	81 * a class path} of your <em>JVM</em> application. {@link PolyglotEngine} orchestrates these
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	82 * languages, manages exchange of objects and calls among them. While it may happen that there is
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	83 * just one activated language inside of a {@link PolyglotEngine}, the greatest strength of
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	84 * {@link PolyglotEngine} is in inter-operability between all Truffle languages. There is 1:N
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	85 * mapping between {@link PolyglotEngine} and {@link TruffleLanguage Truffle language
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	86 * implementations}.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	87 * <p>
22171 41c5f430ce37 Using buildNew as that more directly indicates the use of Builder pattern Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22170 diff changeset	88 * Use {@link #buildNew()} to create new isolated portal ready for execution of various languages.
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	89 * All the languages in a single portal see each other exported global symbols and can cooperate.
22171 41c5f430ce37 Using buildNew as that more directly indicates the use of Builder pattern Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22170 diff changeset	90 * Use {@link #buildNew()} multiple times to create different, isolated portal environment
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	91 * completely separated from each other.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	92 * <p>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	93 * Once instantiated use {@link #eval(java.net.URI)} with a reference to a file or URL or directly
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	94 * pass code snippet into the virtual machine via {@link #eval(java.lang.String, java.lang.String)}.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	95 * Support for individual languages is initialized on demand - e.g. once a file of certain MIME type
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	96 * is about to be processed, its appropriate engine (if found), is initialized. Once an engine gets
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	97 * initialized, it remains so, until the virtual machine isn't garbage collected.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	98 * <p>
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	99 * The engine is single-threaded and tries to enforce that. It records the thread it has been
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	100 * {@link Builder#build() created} by and checks that all subsequent calls are coming from the same
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	101 * thread. There is 1:1 mapping between {@link PolyglotEngine} and a thread that can tell it what to
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	102 * do.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	103 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	104 @SuppressWarnings("rawtypes")
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	105 public class PolyglotEngine {
796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	106 static final Logger LOG = Logger.getLogger(PolyglotEngine.class.getName());
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	107 private static final SPIAccessor SPI = new SPIAccessor();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	108 private final Thread initThread;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	109 private final Executor executor;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	110 private final Map<String, Language> langs;
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	111 private final InputStream in;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	112 private final OutputStream err;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	113 private final OutputStream out;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	114 private final EventConsumer<?>[] handlers;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	115 private final Map<String, Object> globals;
22214 3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	116 private final Instrumenter instrumenter;
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	117 private final Debugger debugger;
22183 1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	118 private boolean disposed;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	119
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	120 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	121 * Private & temporary only constructor.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	122 */
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	123 PolyglotEngine() {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	124 this.initThread = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	125 this.in = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	126 this.err = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	127 this.out = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	128 this.langs = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	129 this.handlers = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	130 this.globals = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	131 this.executor = null;
22214 3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	132 this.instrumenter = null;
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	133 this.debugger = null;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	134 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	135
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	136 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	137 * Real constructor used from the builder.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	138 */
22174 0bcfe8c6088f The central API to invoke various programs is now PolyglotEngine - a polyglot-ready enhancement of JDK's ScriptEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 22173 diff changeset	139 PolyglotEngine(Executor executor, Map<String, Object> globals, OutputStream out, OutputStream err, InputStream in, EventConsumer<?>[] handlers) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	140 this.executor = executor;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	141 this.out = out;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	142 this.err = err;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	143 this.in = in;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	144 this.handlers = handlers;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	145 this.initThread = Thread.currentThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	146 this.globals = new HashMap<>(globals);
22220 20380d1d41f2 Truffle/Instrumentation: second merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22219 diff changeset	147 this.instrumenter = SPI.createInstrumenter(this);
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	148 this.debugger = SPI.createDebugger(this, this.instrumenter);
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	149 Map<String, Language> map = new HashMap<>();
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	150 /* We want to create a language instance but per LanguageCache and not per mime type. */
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	151 Set<LanguageCache> uniqueCaches = new HashSet<>(LanguageCache.languages().values());
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	152 for (LanguageCache languageCache : uniqueCaches) {
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	153 Language newLanguage = new Language(languageCache);
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	154 for (String mimeType : newLanguage.getMimeTypes()) {
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	155 map.put(mimeType, newLanguage);
7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	156 }
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	157 }
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	158 this.langs = map;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	159 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	160
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	161 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	162 * Creation of new Truffle virtual machine. Use the {@link Builder} methods to configure your
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	163 * virtual machine and then create one using {@link Builder#build()}:
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	164 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	165 * <pre>
22171 41c5f430ce37 Using buildNew as that more directly indicates the use of Builder pattern Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22170 diff changeset	166 * {@link PolyglotEngine} vm = {@link PolyglotEngine}.{@link PolyglotEngine#buildNew() buildNew()}
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	167 * .{@link Builder#setOut(java.io.OutputStream) setOut}({@link OutputStream yourOutput})
22212 71ec6de11cea fix a few typos Andreas Woess <andreas.woess@oracle.com> parents: 22209 diff changeset	168 * .{@link Builder#setErr(java.io.OutputStream) setErr}({@link OutputStream yourOutput})
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	169 * .{@link Builder#setIn(java.io.InputStream) setIn}({@link InputStream yourInput})
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	170 * .{@link Builder#build() build()};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	171 * </pre>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	172 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	173 * It searches for {@link Registration languages registered} in the system class loader and
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	174 * makes them available for later evaluation via
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	175 * {@link #eval(java.lang.String, java.lang.String)} methods.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	176 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	177 * @return new, isolated virtual machine with pre-registered languages
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	178 */
22171 41c5f430ce37 Using buildNew as that more directly indicates the use of Builder pattern Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22170 diff changeset	179 public static PolyglotEngine.Builder buildNew() {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	180 // making Builder non-static inner class is a
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	181 // nasty trick to avoid the Builder class to appear
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	182 // in Javadoc next to PolyglotEngine class
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	183 PolyglotEngine vm = new PolyglotEngine();
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	184 return vm.new Builder();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	185 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	186
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	187 /**
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	188 * Builder for a new {@link PolyglotEngine}. Call various configuration methods in a chain and
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	189 * at the end create new {@link PolyglotEngine virtual machine}:
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	190 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	191 * <pre>
22171 41c5f430ce37 Using buildNew as that more directly indicates the use of Builder pattern Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22170 diff changeset	192 * {@link PolyglotEngine} vm = {@link PolyglotEngine}.{@link PolyglotEngine#buildNew() buildNew()}
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	193 * .{@link Builder#setOut(java.io.OutputStream) setOut}({@link OutputStream yourOutput})
22212 71ec6de11cea fix a few typos Andreas Woess <andreas.woess@oracle.com> parents: 22209 diff changeset	194 * .{@link Builder#setErr(java.io.OutputStream) setErr}({@link OutputStream yourOutput})
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	195 * .{@link Builder#setIn(java.io.InputStream) setIn}({@link InputStream yourInput})
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	196 * .{@link Builder#build() build()};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	197 * </pre>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	198 */
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	199 public class Builder {
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	200 private OutputStream out;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	201 private OutputStream err;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	202 private InputStream in;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	203 private final List<EventConsumer<?>> handlers = new ArrayList<>();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	204 private final Map<String, Object> globals = new HashMap<>();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	205 private Executor executor;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	206
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	207 Builder() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	208 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	209
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	210 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	211 * Changes the default output for languages running in <em>to be created</em>
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	212 * {@link PolyglotEngine virtual machine}. The default is to use {@link System#out}.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	213 *
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	214 * @param os the stream to use as output
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	215 * @return instance of this builder
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	216 */
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	217 public Builder setOut(OutputStream os) {
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	218 out = os;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	219 return this;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	220 }
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	221
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	222 /**
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	223 * @deprecated does nothing
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	224 */
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	225 @Deprecated
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	226 @SuppressWarnings("unused")
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	227 public Builder stdOut(Writer w) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	228 return this;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	229 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	230
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	231 /**
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	232 * Changes the error output for languages running in <em>to be created</em>
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	233 * {@link PolyglotEngine virtual machine}. The default is to use {@link System#err}.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	234 *
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	235 * @param os the stream to use as output
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	236 * @return instance of this builder
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	237 */
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	238 public Builder setErr(OutputStream os) {
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	239 err = os;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	240 return this;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	241 }
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	242
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	243 /**
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	244 * @deprecated does nothing
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	245 */
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	246 @Deprecated
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	247 @SuppressWarnings("unused")
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	248 public Builder stdErr(Writer w) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	249 return this;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	250 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	251
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	252 /**
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	253 * Changes the default input for languages running in <em>to be created</em>
22174 0bcfe8c6088f The central API to invoke various programs is now PolyglotEngine - a polyglot-ready enhancement of JDK's ScriptEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 22173 diff changeset	254 * {@link PolyglotEngine virtual machine}. The default is to use {@link System#in}.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	255 *
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	256 * @param is the stream to use as input
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	257 * @return instance of this builder
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	258 */
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	259 public Builder setIn(InputStream is) {
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	260 in = is;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	261 return this;
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	262 }
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	263
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	264 /**
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	265 * @deprecated does nothing
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	266 */
67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	267 @Deprecated
22167 0480c4873a4a Fixing Javadoc, imports and adding suppression to methods that are being deprecated Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22165 diff changeset	268 @SuppressWarnings("unused")
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	269 public Builder stdIn(Reader r) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	270 return this;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	271 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	272
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	273 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	274 * Registers another instance of {@link EventConsumer} into the to be created
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	275 * {@link PolyglotEngine}.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	276 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	277 * @param handler the handler to register
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	278 * @return instance of this builder
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	279 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	280 public Builder onEvent(EventConsumer<?> handler) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	281 handler.getClass();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	282 handlers.add(handler);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	283 return this;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	284 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	285
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	286 /**
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	287 * Adds global named symbol into the configuration of to-be-built {@link PolyglotEngine}.
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	288 * This symbol will be accessible to all languages via
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	289 * {@link Env#importSymbol(java.lang.String)} and will take precedence over
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	290 * {@link TruffleLanguage#findExportedSymbol symbols exported by languages itself}. Repeated
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	291 * use of <code>globalSymbol</code> is possible; later definition of the same name overrides
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	292 * the previous one.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	293 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	294 * @param name name of the symbol to register
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	295 * @param obj value of the object - expected to be primitive wrapper, {@link String} or
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	296 * <code>TruffleObject</code> for mutual inter-operability
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	297 * @return instance of this builder
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	298 * @see PolyglotEngine#findGlobalSymbol(java.lang.String)
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	299 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	300 public Builder globalSymbol(String name, Object obj) {
22196 364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	301 final Object truffleReady;
364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	302 if (obj instanceof Number \|\| obj instanceof String \|\| obj instanceof Character \|\| obj instanceof Boolean) {
364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	303 truffleReady = obj;
364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	304 } else {
364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	305 truffleReady = JavaInterop.asTruffleObject(obj);
364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	306 }
364e3f024643 Java objects passed into globalSymbol should be converted into something that Truffle languages can understand - e.g. TruffleObject instances. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22194 diff changeset	307 globals.put(name, truffleReady);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	308 return this;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	309 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	310
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	311 /**
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	312 * Provides own executor for running {@link PolyglotEngine} scripts. By default
796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	313 * {@link PolyglotEngine#eval(com.oracle.truffle.api.source.Source)} and
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	314 * {@link Value#invoke(java.lang.Object, java.lang.Object[])} are executed synchronously in
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	315 * the calling thread. Sometimes, however it is more beneficial to run them asynchronously -
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	316 * the easiest way to do so is to provide own executor when configuring the {
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	317 * {@link #executor(java.util.concurrent.Executor) the builder}. The executor is expected to
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	318 * execute all {@link Runnable runnables} passed into its
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	319 * {@link Executor#execute(java.lang.Runnable)} method in the order they arrive and in a
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	320 * single (yet arbitrary) thread.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	321 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	322 * @param executor the executor to use for internal execution inside the {@link #build() to
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	323 * be created} {@link PolyglotEngine}
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	324 * @return instance of this builder
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	325 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	326 @SuppressWarnings("hiding")
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	327 public Builder executor(Executor executor) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	328 this.executor = executor;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	329 return this;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	330 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	331
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	332 /**
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	333 * Creates the {@link PolyglotEngine Truffle virtual machine}. The configuration is taken
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	334 * from values passed into configuration methods in this class.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	335 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	336 * @return new, isolated virtual machine with pre-registered languages
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	337 */
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	338 public PolyglotEngine build() {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	339 if (out == null) {
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	340 out = System.out;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	341 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	342 if (err == null) {
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	343 err = System.err;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	344 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	345 if (in == null) {
22165 67f75f61c974 Certain languages (like FastR) prefer access to raw byte streams. Offering it. One always has an option to wrap Input and Output Streams into character based Readers and Writers Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22157 diff changeset	346 in = System.in;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	347 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	348 Executor nonNullExecutor = executor != null ? executor : new Executor() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	349 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	350 public void execute(Runnable command) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	351 command.run();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	352 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	353 };
22266 0d36601f233e Merge revised Instrumentation framework into the Polyglot API Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22261 22200 diff changeset	354 return new PolyglotEngine(nonNullExecutor, globals, out, err, in, handlers.toArray(new EventConsumer[0]));
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	355 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	356 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	357
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	358 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	359 * Descriptions of languages supported in this Truffle virtual machine.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	360 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	361 * @return an immutable map with keys being MIME types and values the {@link Language
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	362 * descriptions} of associated languages
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	363 */
22169 307a4ed5430e Two more changes to guarantee better compatibility with TruffleVM Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22168 diff changeset	364 public Map<String, ? extends Language> getLanguages() {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	365 return Collections.unmodifiableMap(langs);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	366 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	367
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	368 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	369 * Evaluates file located on a given URL. Is equivalent to loading the content of a file and
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	370 * executing it via {@link #eval(java.lang.String, java.lang.String)} with a MIME type guess
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	371 * based on the file's extension and/or content.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	372 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	373 * @param location the location of a file to execute
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	374 * @return result of a processing the file, possibly <code>null</code>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	375 * @throws IOException exception to signal I/O problems or problems with processing the file's
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	376 * content
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	377 * @deprecated use {@link #eval(com.oracle.truffle.api.source.Source)}
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	378 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	379 @Deprecated
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	380 public Object eval(URI location) throws IOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	381 checkThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	382 Source s;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	383 String mimeType;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	384 if (location.getScheme().equals("file")) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	385 File file = new File(location);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	386 s = Source.fromFileName(file.getPath(), true);
22209 dcee887614b1 Removing hardcoded MIME types in the source. Each language is supposed to register its own FileTypeDetector as SL did in cf19259edf87. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22200 diff changeset	387 mimeType = Files.probeContentType(file.toPath());
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	388 } else {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	389 URL url = location.toURL();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	390 s = Source.fromURL(url, location.toString());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	391 URLConnection conn = url.openConnection();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	392 mimeType = conn.getContentType();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	393 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	394 Language l = langs.get(mimeType);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	395 if (l == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	396 throw new IOException("No language for " + location + " with MIME type " + mimeType + " found. Supported types: " + langs.keySet());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	397 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	398 return eval(l, s).get();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	399 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	400
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	401 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	402 * Evaluates code snippet. Chooses a language registered for a given MIME type (throws
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	403 * {@link IOException} if there is none). And passes the specified code to it for execution.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	404 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	405 * @param mimeType MIME type of the code snippet - chooses the right language
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	406 * @param reader the source of code snippet to execute
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	407 * @return result of an execution, possibly <code>null</code>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	408 * @throws IOException thrown to signal errors while processing the code
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	409 * @deprecated use {@link #eval(com.oracle.truffle.api.source.Source)}
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	410 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	411 @Deprecated
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	412 public Object eval(String mimeType, Reader reader) throws IOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	413 checkThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	414 Language l = langs.get(mimeType);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	415 if (l == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	416 throw new IOException("No language for MIME type " + mimeType + " found. Supported types: " + langs.keySet());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	417 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	418 return eval(l, Source.fromReader(reader, mimeType)).get();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	419 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	420
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	421 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	422 * Evaluates code snippet. Chooses a language registered for a given MIME type (throws
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	423 * {@link IOException} if there is none). And passes the specified code to it for execution.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	424 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	425 * @param mimeType MIME type of the code snippet - chooses the right language
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	426 * @param code the code snippet to execute
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	427 * @return result of an execution, possibly <code>null</code>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	428 * @throws IOException thrown to signal errors while processing the code
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	429 * @deprecated use {@link #eval(com.oracle.truffle.api.source.Source)}
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	430 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	431 @Deprecated
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	432 public Object eval(String mimeType, String code) throws IOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	433 checkThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	434 Language l = langs.get(mimeType);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	435 if (l == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	436 throw new IOException("No language for MIME type " + mimeType + " found. Supported types: " + langs.keySet());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	437 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	438 return eval(l, Source.fromText(code, mimeType)).get();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	439 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	440
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	441 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	442 * Evaluates provided source. Chooses language registered for a particular
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	443 * {@link Source#getMimeType() MIME type} (throws {@link IOException} if there is none). The
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	444 * language is then allowed to parse and execute the source.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	445 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	446 * @param source code snippet to execute
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	447 * @return a {@link Value} object that holds result of an execution, never <code>null</code>
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	448 * @throws IOException thrown to signal errors while processing the code
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	449 */
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	450 public Value eval(Source source) throws IOException {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	451 String mimeType = source.getMimeType();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	452 checkThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	453 Language l = langs.get(mimeType);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	454 if (l == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	455 throw new IOException("No language for MIME type " + mimeType + " found. Supported types: " + langs.keySet());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	456 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	457 return eval(l, source);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	458 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	459
22183 1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	460 /**
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	461 * Dispose instance of this engine. A user can explicitly
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	462 * {@link TruffleLanguage#disposeContext(java.lang.Object) dispose all resources} allocated by
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	463 * the languages active in this engine, when it is known the system is not going to be used in
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	464 * the future.
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	465 * <p>
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	466 * Calling any other method of this class after the dispose has been done yields an
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	467 * {@link IllegalStateException}.
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	468 */
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	469 public void dispose() {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	470 checkThread();
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	471 disposed = true;
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	472 executor.execute(new Runnable() {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	473 @Override
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	474 public void run() {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	475 for (Language language : getLanguages().values()) {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	476 TruffleLanguage<?> impl = language.getImpl(false);
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	477 if (impl != null) {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	478 try {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	479 SPI.dispose(impl, language.getEnv(true));
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	480 } catch (Exception \| Error ex) {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	481 LOG.log(Level.SEVERE, "Error disposing " + impl, ex);
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	482 }
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	483 }
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	484 }
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	485 }
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	486 });
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	487 }
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	488
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	489 private Value eval(final Language l, final Source s) throws IOException {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	490 final Object[] result = {null, null};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	491 final CountDownLatch ready = new CountDownLatch(1);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	492 final TruffleLanguage[] lang = {null};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	493 executor.execute(new Runnable() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	494 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	495 public void run() {
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	496 evalImpl(lang, s, result, l, ready);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	497 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	498 });
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	499 exceptionCheck(result);
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	500 return createValue(lang[0], result, ready);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	501 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	502
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	503 Value createValue(TruffleLanguage lang, Object[] result, CountDownLatch ready) {
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	504 return new Value(lang, result, ready);
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	505 }
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	506
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	507 Language createLanguage(Map.Entry<String, LanguageCache> en) {
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	508 return new Language(en.getValue());
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	509 }
ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	510
22132 19205292b0c7 Suppressing "try" lints Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22129 diff changeset	511 @SuppressWarnings("try")
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	512 private void evalImpl(TruffleLanguage<?>[] fillLang, Source s, Object[] result, Language l, CountDownLatch ready) {
22275 141fe31da7a2 Avoiding check for current stack depth on the initialization of debugger. Only when debugger is suspended the real check is needed. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22274 diff changeset	513 try (Closeable d = SPI.executionStart(this, -1, debugger, s)) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	514 TruffleLanguage<?> langImpl = l.getImpl(true);
22133 c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	515 fillLang[0] = langImpl;
c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	516 result[0] = SPI.eval(langImpl, s);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	517 } catch (IOException ex) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	518 result[1] = ex;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	519 } finally {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	520 ready.countDown();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	521 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	522 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	523
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	524 @SuppressWarnings("try")
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	525 final Object invokeForeign(final Node foreignNode, final VirtualFrame frame, final TruffleObject receiver) throws IOException {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	526 final Object[] res = {null, null};
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	527 executor.execute(new Runnable() {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	528 @Override
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	529 public void run() {
22275 141fe31da7a2 Avoiding check for current stack depth on the initialization of debugger. Only when debugger is suspended the real check is needed. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22274 diff changeset	530 try (final Closeable c = SPI.executionStart(PolyglotEngine.this, -1, debugger, null)) {
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	531 res[0] = ForeignAccess.execute(foreignNode, frame, receiver, ForeignAccess.getArguments(frame).toArray());
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	532 } catch (IOException ex) {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	533 res[1] = ex;
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	534 } catch (Throwable ex) {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	535 res[1] = ex;
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	536 }
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	537 }
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	538 });
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	539 exceptionCheck(res);
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	540 if (res[0] instanceof TruffleObject) {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	541 return new EngineTruffleObject(this, (TruffleObject) res[0]);
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	542 } else {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	543 return res[0];
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	544 }
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	545 }
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	546
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	547 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	548 * Looks global symbol provided by one of initialized languages up. First of all execute your
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	549 * program via one of your {@link #eval(java.lang.String, java.lang.String)} and then look
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	550 * expected symbol up using this method.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	551 * <p>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	552 * The names of the symbols are language dependent, but for example the Java language bindings
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	553 * follow the specification for method references:
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	554 * <ul>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	555 * <li>"java.lang.Exception::new" is a reference to constructor of {@link Exception}
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	556 * <li>"java.lang.Integer::valueOf" is a reference to static method in {@link Integer} class
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	557 * </ul>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	558 * Once an symbol is obtained, it remembers values for fast access and is ready for being
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	559 * invoked.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	560 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	561 * @param globalName the name of the symbol to find
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	562 * @return found symbol or <code>null</code> if it has not been found
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	563 */
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	564 public Value findGlobalSymbol(final String globalName) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	565 checkThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	566 final TruffleLanguage<?>[] lang = {null};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	567 final Object[] obj = {globals.get(globalName), null};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	568 final CountDownLatch ready = new CountDownLatch(1);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	569 if (obj[0] == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	570 executor.execute(new Runnable() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	571 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	572 public void run() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	573 findGlobalSymbolImpl(obj, globalName, lang, ready);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	574 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	575 });
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	576 try {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	577 ready.await();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	578 } catch (InterruptedException ex) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	579 LOG.log(Level.SEVERE, null, ex);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	580 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	581 } else {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	582 ready.countDown();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	583 }
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	584 return obj[0] == null ? null : createValue(lang[0], obj, ready);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	585 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	586
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	587 private void findGlobalSymbolImpl(Object[] obj, String globalName, TruffleLanguage<?>[] lang, CountDownLatch ready) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	588 if (obj[0] == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	589 for (Language dl : langs.values()) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	590 TruffleLanguage.Env env = dl.getEnv(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	591 if (env == null) {
22133 c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	592 continue;
c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	593 }
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	594 obj[0] = SPI.findExportedSymbol(env, globalName, true);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	595 if (obj[0] != null) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	596 lang[0] = dl.getImpl(true);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	597 break;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	598 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	599 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	600 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	601 if (obj[0] == null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	602 for (Language dl : langs.values()) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	603 TruffleLanguage.Env env = dl.getEnv(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	604 if (env == null) {
22133 c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	605 continue;
c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	606 }
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	607 obj[0] = SPI.findExportedSymbol(env, globalName, true);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	608 if (obj[0] != null) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	609 lang[0] = dl.getImpl(true);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	610 break;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	611 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	612 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	613 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	614 ready.countDown();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	615 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	616
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	617 private void checkThread() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	618 if (initThread != Thread.currentThread()) {
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	619 throw new IllegalStateException("PolyglotEngine created on " + initThread.getName() + " but used on " + Thread.currentThread().getName());
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	620 }
22183 1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	621 if (disposed) {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	622 throw new IllegalStateException("Engine has already been disposed");
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	623 }
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	624 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	625
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	626 @SuppressWarnings("unchecked")
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	627 void dispatch(Object ev) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	628 Class type = ev.getClass();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	629 if (type == SuspendedEvent.class) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	630 dispatchSuspendedEvent((SuspendedEvent) ev);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	631 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	632 if (type == ExecutionEvent.class) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	633 dispatchExecutionEvent((ExecutionEvent) ev);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	634 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	635 dispatch(type, ev);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	636 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	637
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	638 @SuppressWarnings("unused")
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	639 void dispatchSuspendedEvent(SuspendedEvent event) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	640 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	641
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	642 @SuppressWarnings("unused")
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	643 void dispatchExecutionEvent(ExecutionEvent event) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	644 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	645
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	646 @SuppressWarnings("unchecked")
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	647 <Event> void dispatch(Class<Event> type, Event event) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	648 for (EventConsumer handler : handlers) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	649 if (handler.type == type) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	650 handler.on(event);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	651 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	652 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	653 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	654
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	655 static void exceptionCheck(Object[] result) throws RuntimeException, IOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	656 if (result[1] instanceof IOException) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	657 throw (IOException) result[1];
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	658 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	659 if (result[1] instanceof RuntimeException) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	660 throw (RuntimeException) result[1];
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	661 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	662 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	663
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	664 /**
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	665 * A future value wrapper. A user level wrapper around values returned by evaluation of various
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	666 * {@link PolyglotEngine} functions like
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	667 * {@link PolyglotEngine#findGlobalSymbol(java.lang.String)} and
22212 71ec6de11cea fix a few typos Andreas Woess <andreas.woess@oracle.com> parents: 22209 diff changeset	668 * {@link PolyglotEngine#eval(com.oracle.truffle.api.source.Source)} or a value returned by
71ec6de11cea fix a few typos Andreas Woess <andreas.woess@oracle.com> parents: 22209 diff changeset	669 * {@link #invoke(java.lang.Object, java.lang.Object...) a subsequent execution}. In case the
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	670 * {@link PolyglotEngine} has been initialized for
22212 71ec6de11cea fix a few typos Andreas Woess <andreas.woess@oracle.com> parents: 22209 diff changeset	671 * {@link Builder#executor(java.util.concurrent.Executor) asynchronous execution}, the
71ec6de11cea fix a few typos Andreas Woess <andreas.woess@oracle.com> parents: 22209 diff changeset	672 * {@link Value} represents a future - i.e., it is returned immediately, leaving the execution
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	673 * running on behind.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	674 */
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	675 public class Value {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	676 private final TruffleLanguage<?> language;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	677 private final Object[] result;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	678 private final CountDownLatch ready;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	679 private CallTarget target;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	680
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	681 Value(TruffleLanguage<?> language, Object[] result, CountDownLatch ready) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	682 this.language = language;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	683 this.result = result;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	684 this.ready = ready;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	685 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	686
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	687 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	688 * Obtains the object represented by this symbol. The <em>raw</em> object can either be a
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	689 * wrapper about primitive type (e.g. {@link Number}, {@link String}, {@link Character},
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	690 * {@link Boolean}) or a <em>TruffleObject</em> representing more complex object from a
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	691 * language. The method can return <code>null</code>.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	692 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	693 * @return the object or <code>null</code>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	694 * @throws IOException in case it is not possible to obtain the value of the object
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	695 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	696 public Object get() throws IOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	697 waitForSymbol();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	698 exceptionCheck(result);
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	699 if (result[0] instanceof TruffleObject) {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	700 return new EngineTruffleObject(PolyglotEngine.this, (TruffleObject) result[0]);
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	701 } else {
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	702 return result[0];
7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	703 }
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	704 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	705
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	706 /**
22135 e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	707 * Obtains Java view of the object represented by this symbol. The method basically
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	708 * delegates to
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	709 * {@link JavaInterop#asJavaObject(java.lang.Class, com.oracle.truffle.api.interop.TruffleObject)}
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	710 * just handles primitive types as well.
22194 7afb5e5cc3ca Fix use just one language instance per LanguageCache instead of one per mime-type. Christian Humer <christian.humer@oracle.com> parents: 22186 diff changeset	711 *
22135 e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	712 * @param <T> the type of the view one wants to obtain
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	713 * @param representation the class of the view interface (it has to be an interface)
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	714 * @return instance of the view wrapping the object of this symbol
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	715 * @throws IOException in case it is not possible to obtain the value of the object
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	716 * @throws ClassCastException if the value cannot be converted to desired view
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	717 */
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	718 public <T> T as(Class<T> representation) throws IOException {
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	719 Object obj = get();
22274 371045b1312d Be able to extract the original type of TruffleObject from PolyglotEngine.Value via its as method. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22268 diff changeset	720 if (obj instanceof EngineTruffleObject) {
371045b1312d Be able to extract the original type of TruffleObject from PolyglotEngine.Value via its as method. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22268 diff changeset	721 EngineTruffleObject eto = (EngineTruffleObject) obj;
371045b1312d Be able to extract the original type of TruffleObject from PolyglotEngine.Value via its as method. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22268 diff changeset	722 if (representation.isInstance(eto.getDelegate())) {
371045b1312d Be able to extract the original type of TruffleObject from PolyglotEngine.Value via its as method. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22268 diff changeset	723 return representation.cast(eto.getDelegate());
371045b1312d Be able to extract the original type of TruffleObject from PolyglotEngine.Value via its as method. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22268 diff changeset	724 }
371045b1312d Be able to extract the original type of TruffleObject from PolyglotEngine.Value via its as method. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22268 diff changeset	725 }
22135 e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	726 if (representation.isInstance(obj)) {
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	727 return representation.cast(obj);
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	728 }
22200 7abcbeb12d08 Creating a TruffleObject that knows its PolyglotEngine and wrapping all values returned from the engine by it, so it is always clear into which engine context an object belongs. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22196 diff changeset	729 return JavaInterop.asJavaObject(representation, (TruffleObject) obj);
22135 e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	730 }
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	731
e70b20f4bb00 Implementing API for Java/Truffle interop. Based around JavaInterop.asJavaObject and JavaInterop.asTruffleObject methods. Connected to TruffleVM via Symbol.as(Class) wrapper. Verified by extended TCK. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22133 diff changeset	732 /**
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	733 * Invokes the symbol. If the symbol represents a function, then it should be invoked with
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	734 * provided arguments. If the symbol represents a field, then first argument (if provided)
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	735 * should set the value to the field; the return value should be the actual value of the
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	736 * field when the <code>invoke</code> method returns.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	737 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	738 * @param thiz this/self in language that support such concept; use <code>null</code> to let
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	739 * the language use default this/self or ignore the value
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	740 * @param args arguments to pass when invoking the symbol
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	741 * @return symbol wrapper around the value returned by invoking the symbol, never
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	742 * <code>null</code>
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	743 * @throws IOException signals problem during execution
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	744 */
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	745 public Value invoke(final Object thiz, final Object... args) throws IOException {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	746 get();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	747 final CountDownLatch done = new CountDownLatch(1);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	748 final Object[] res = {null, null};
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	749 executor.execute(new Runnable() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	750 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	751 public void run() {
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	752 invokeImpl(thiz, args, res, done);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	753 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	754 });
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	755 exceptionCheck(res);
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	756 return createValue(language, res, done);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	757 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	758
22132 19205292b0c7 Suppressing "try" lints Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22129 diff changeset	759 @SuppressWarnings("try")
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	760 private void invokeImpl(Object thiz, Object[] args, Object[] res, CountDownLatch done) {
22275 141fe31da7a2 Avoiding check for current stack depth on the initialization of debugger. Only when debugger is suspended the real check is needed. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22274 diff changeset	761 try (final Closeable c = SPI.executionStart(PolyglotEngine.this, -1, debugger, null)) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	762 List<Object> arr = new ArrayList<>();
22179 ee9ae440f1eb Testing behavior of invoke when calling asTruffleFunction Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22174 diff changeset	763 if (thiz == null) {
ee9ae440f1eb Testing behavior of invoke when calling asTruffleFunction Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22174 diff changeset	764 if (language != null) {
ee9ae440f1eb Testing behavior of invoke when calling asTruffleFunction Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22174 diff changeset	765 Object global = SPI.languageGlobal(SPI.findLanguage(PolyglotEngine.this, language.getClass()));
ee9ae440f1eb Testing behavior of invoke when calling asTruffleFunction Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22174 diff changeset	766 if (global != null) {
ee9ae440f1eb Testing behavior of invoke when calling asTruffleFunction Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22174 diff changeset	767 arr.add(global);
ee9ae440f1eb Testing behavior of invoke when calling asTruffleFunction Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22174 diff changeset	768 }
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	769 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	770 } else {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	771 arr.add(thiz);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	772 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	773 arr.addAll(Arrays.asList(args));
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	774 for (;;) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	775 try {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	776 if (target == null) {
22129 0589cc5cab30 TruffleVM can now depend on api.interop and thus there is no need for indirection between SymbolInvoker and its Impl. Enough to do direct calls. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22128 diff changeset	777 target = SymbolInvokerImpl.createCallTarget(language, result[0], arr.toArray());
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	778 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	779 res[0] = target.call(arr.toArray());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	780 break;
22129 0589cc5cab30 TruffleVM can now depend on api.interop and thus there is no need for indirection between SymbolInvoker and its Impl. Enough to do direct calls. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22128 diff changeset	781 } catch (ArgumentsMishmashException ex) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	782 target = null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	783 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	784 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	785 } catch (IOException ex) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	786 res[1] = ex;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	787 } catch (RuntimeException ex) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	788 res[1] = ex;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	789 } finally {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	790 done.countDown();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	791 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	792 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	793
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	794 private void waitForSymbol() throws InterruptedIOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	795 checkThread();
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	796 try {
22278 85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	797 if (ready != null) {
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	798 ready.await();
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	799 }
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	800 } catch (InterruptedException ex) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	801 throw (InterruptedIOException) new InterruptedIOException(ex.getMessage()).initCause(ex);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	802 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	803 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	804 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	805
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	806 /**
22172 b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	807 * Description of a language registered in {@link PolyglotEngine Truffle virtual machine}.
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	808 * Languages are registered by {@link Registration} annotation which stores necessary
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	809 * information into a descriptor inside of the language's JAR file. When a new
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	810 * {@link PolyglotEngine} is created, it reads all available descriptors and creates
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	811 * {@link Language} objects to represent them. One can obtain a {@link #getName() name} or list
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	812 * of supported {@link #getMimeTypes() MIME types} for each language. The actual language
b31dcacfc8ff Replacing more TruffleVM references in comments with the new PolyglotEngine name Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22171 diff changeset	813 * implementation is not initialized until
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	814 * {@link PolyglotEngine#eval(java.lang.String, java.lang.String) a code is evaluated} in it.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	815 */
22168 ffadd23c63c8 Introducing Portaal into the isolated world of each and any TruffleLanguage. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22137 diff changeset	816 public class Language {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	817 private final LanguageCache info;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	818 private TruffleLanguage.Env env;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	819
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	820 Language(LanguageCache info) {
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	821 this.info = info;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	822 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	823
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	824 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	825 * MIME types recognized by the language.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	826 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	827 * @return returns immutable set of recognized MIME types
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	828 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	829 public Set<String> getMimeTypes() {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	830 return info.getMimeTypes();
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	831 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	832
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	833 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	834 * Human readable name of the language. Think of C, Ruby, JS, etc.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	835 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	836 * @return string giving the language a name
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	837 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	838 public String getName() {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	839 return info.getName();
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	840 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	841
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	842 /**
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	843 * Name of the language version.
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	844 *
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	845 * @return string specifying the language version
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	846 */
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	847 public String getVersion() {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	848 return info.getVersion();
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	849 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	850
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	851 /**
22278 85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	852 * Evaluates provided source. Ignores the particular {@link Source#getMimeType() MIME type}
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	853 * and forces evaluation in the context of <code>this</code> language.
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	854 *
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	855 * @param source code snippet to execute
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	856 * @return a {@link Value} object that holds result of an execution, never <code>null</code>
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	857 * @throws IOException thrown to signal errors while processing the code
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	858 */
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	859 public Value eval(Source source) throws IOException {
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	860 checkThread();
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	861 return PolyglotEngine.this.eval(this, source);
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	862 }
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	863
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	864 /**
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	865 * Returns value representing global object of the language.
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	866 * <p>
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	867 * The object is expected to be <code>TruffleObject</code> (e.g. a native object from the
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	868 * other language) but technically it can be one of Java primitive wrappers ({@link Integer}, {@link Double}, {@link Short}, etc.).
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	869 *
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	870 * @return the global object or <code>null</code> if the language does not support such
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	871 * concept
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	872 */
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	873 public Value getGlobalObject() {
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	874 checkThread();
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	875
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	876 Object[] res = {SPI.languageGlobal(getEnv(true)), null};
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	877 return res[0] == null ? null : new Value(info.getImpl(true), res, null);
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	878 }
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	879
85a6db6624ab Simplifying the way to obtain Language.globalObject Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22277 diff changeset	880 /**
22277 412991d0359c Deprecating method that does trivial, and not I18Ned, concatenation of other values. Just concatenate the values yourself. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22275 diff changeset	881 * @deprecated concatenate {@link #getName()} and {@link #getVersion()} the way you want.
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	882 */
22277 412991d0359c Deprecating method that does trivial, and not I18Ned, concatenation of other values. Just concatenate the values yourself. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22275 diff changeset	883 @Deprecated
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	884 public String getShortName() {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	885 return getName() + "(" + getVersion() + ")";
22133 c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	886 }
c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	887
c334865b9d42 Make sure TruffleLanguage.createEnv is only called when Accessor.CURRENT_VM is known Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22132 diff changeset	888 TruffleLanguage<?> getImpl(boolean create) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	889 getEnv(create);
22219 1c0f490984d5 Merge with f47b601edbc626dcfe8b3636933b4834c89f7779 Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22157 22217 diff changeset	890 TruffleLanguage<?> impl = info.getImpl(false);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	891 return impl;
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	892 }
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	893
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	894 TruffleLanguage.Env getEnv(boolean create) {
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	895 if (env == null && create) {
22266 0d36601f233e Merge revised Instrumentation framework into the Polyglot API Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22261 22200 diff changeset	896 env = SPI.attachEnv(PolyglotEngine.this, info.getImpl(true), out, err, in, instrumenter);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	897 }
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	898 return env;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	899 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	900
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	901 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	902 public String toString() {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	903 return "[" + getShortName() + " for " + getMimeTypes() + "]";
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	904 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	905 } // end of Language
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	906
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	907 //
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	908 // Accessor helper methods
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	909 //
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	910
22214 3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	911 TruffleLanguage<?> findLanguage(Class<? extends TruffleLanguage> languageClazz) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	912 for (Map.Entry<String, Language> entrySet : langs.entrySet()) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	913 Language languageDescription = entrySet.getValue();
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	914 final TruffleLanguage<?> impl = languageDescription.getImpl(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	915 if (languageClazz.isInstance(impl)) {
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	916 return impl;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	917 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	918 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	919 throw new IllegalStateException("Cannot find language " + languageClazz + " among " + langs);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	920 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	921
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	922 TruffleLanguage<?> findLanguage(Probe probe) {
22219 1c0f490984d5 Merge with f47b601edbc626dcfe8b3636933b4834c89f7779 Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22157 22217 diff changeset	923 return findLanguage(SPI.findLanguage(probe));
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	924 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	925
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	926 Env findEnv(Class<? extends TruffleLanguage> languageClazz) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	927 for (Map.Entry<String, Language> entrySet : langs.entrySet()) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	928 Language languageDescription = entrySet.getValue();
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	929 Env env = languageDescription.getEnv(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	930 if (env != null && languageClazz.isInstance(languageDescription.getImpl(false))) {
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	931 return env;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	932 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	933 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	934 throw new IllegalStateException("Cannot find language " + languageClazz + " among " + langs);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	935 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	936
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	937 private static class SPIAccessor extends Accessor {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	938 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	939 public Object importSymbol(Object vmObj, TruffleLanguage<?> ownLang, String globalName) {
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	940 PolyglotEngine vm = (PolyglotEngine) vmObj;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	941 Object g = vm.globals.get(globalName);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	942 if (g != null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	943 return g;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	944 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	945 Set<Language> uniqueLang = new LinkedHashSet<>(vm.langs.values());
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	946 for (Language dl : uniqueLang) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	947 TruffleLanguage<?> l = dl.getImpl(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	948 TruffleLanguage.Env env = dl.getEnv(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	949 if (l == ownLang \|\| l == null \|\| env == null) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	950 continue;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	951 }
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	952 Object obj = SPI.findExportedSymbol(env, globalName, true);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	953 if (obj != null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	954 return obj;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	955 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	956 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	957 for (Language dl : uniqueLang) {
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	958 TruffleLanguage<?> l = dl.getImpl(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	959 TruffleLanguage.Env env = dl.getEnv(false);
1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	960 if (l == ownLang \|\| l == null \|\| env == null) {
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	961 continue;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	962 }
22137 1957c49a979d (Re)Introducing LanguageCache - e.g. data that hold the essential static information about Truffle languages. Pre-initializing the data if AOT property is specified. Use mx -J-Dcom.oracle.truffle.aot=true unittest to validate proper behavior of AOT mode. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22135 diff changeset	963 Object obj = SPI.findExportedSymbol(env, globalName, false);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	964 if (obj != null) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	965 return obj;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	966 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	967 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	968 return null;
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	969 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	970
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	971 @Override
22237 c4e7737981d3 Truffle/Instrumentation: make the Instrumenter available to language implementations via Env.getInstrumenter() Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22232 diff changeset	972 protected Env attachEnv(Object obj, TruffleLanguage<?> language, OutputStream stdOut, OutputStream stdErr, InputStream stdIn, Instrumenter instrumenter) {
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	973 PolyglotEngine vm = (PolyglotEngine) obj;
22237 c4e7737981d3 Truffle/Instrumentation: make the Instrumenter available to language implementations via Env.getInstrumenter() Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22232 diff changeset	974 return super.attachEnv(vm, language, stdOut, stdErr, stdIn, instrumenter);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	975 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	976
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	977 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	978 public Object eval(TruffleLanguage<?> l, Source s) throws IOException {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	979 return super.eval(l, s);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	980 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	981
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	982 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	983 public Object findExportedSymbol(TruffleLanguage.Env env, String globalName, boolean onlyExplicit) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	984 return super.findExportedSymbol(env, globalName, onlyExplicit);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	985 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	986
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	987 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	988 protected Object languageGlobal(TruffleLanguage.Env env) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	989 return super.languageGlobal(env);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	990 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	991
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	992 @Override
22220 20380d1d41f2 Truffle/Instrumentation: second merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22219 diff changeset	993 protected Instrumenter createInstrumenter(Object vm) {
20380d1d41f2 Truffle/Instrumentation: second merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22219 diff changeset	994 return super.createInstrumenter(vm);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	995 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	996
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	997 @Override
22238 cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	998 protected Debugger createDebugger(Object vm, Instrumenter instrumenter) {
cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	999 return super.createDebugger(vm, instrumenter);
cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	1000 }
cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	1001
cccb1ac700bd Team/Instrumentation: the TruflfeVM Debugger is now created eagerly at VM "build" time Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22237 diff changeset	1002 @Override
22214 3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	1003 protected Instrumenter getInstrumenter(Object obj) {
22266 0d36601f233e Merge revised Instrumentation framework into the Polyglot API Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22261 22200 diff changeset	1004 final PolyglotEngine vm = (PolyglotEngine) obj;
22214 3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	1005 return vm.instrumenter;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1006 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1007
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1008 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1009 protected Class<? extends TruffleLanguage> findLanguage(Probe probe) {
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1010 return super.findLanguage(probe);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1011 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1012
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1013 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1014 protected Env findLanguage(Object obj, Class<? extends TruffleLanguage> languageClass) {
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	1015 PolyglotEngine vm = (PolyglotEngine) obj;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1016 return vm.findEnv(languageClass);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1017 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1018
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1019 @Override
22268 b56fe0d3b560 Merge with acfea340b19199faaa44bd5e103c716c17ea2b21 Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22266 22212 diff changeset	1020 protected TruffleLanguage<?> findLanguageImpl(Object obj, Class<? extends TruffleLanguage> languageClazz) {
22266 0d36601f233e Merge revised Instrumentation framework into the Polyglot API Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22261 22200 diff changeset	1021 final PolyglotEngine vm = (PolyglotEngine) obj;
22214 3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	1022 return vm.findLanguage(languageClazz);
3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	1023 }
3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	1024
3aad794eec0e Truffle/Instrumentation: first large merge of instrumentation code into the TruffleVM framework Michael Van De Vanter <michael.van.de.vanter@oracle.com> parents: 22135 diff changeset	1025 @Override
22275 141fe31da7a2 Avoiding check for current stack depth on the initialization of debugger. Only when debugger is suspended the real check is needed. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22274 diff changeset	1026 protected Closeable executionStart(Object obj, int currentDepth, Debugger debugger, Source s) {
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	1027 PolyglotEngine vm = (PolyglotEngine) obj;
22275 141fe31da7a2 Avoiding check for current stack depth on the initialization of debugger. Only when debugger is suspended the real check is needed. Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22274 diff changeset	1028 return super.executionStart(vm, -1, debugger, s);
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1029 }
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1030
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1031 @Override
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1032 protected void dispatchEvent(Object obj, Object event) {
22170 796f0fef110e Renaming to PolyglotEngine Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22169 diff changeset	1033 PolyglotEngine vm = (PolyglotEngine) obj;
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1034 vm.dispatch(event);
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1035 }
22183 1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	1036
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	1037 @Override
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	1038 protected void dispose(TruffleLanguage<?> impl, TruffleLanguage.Env env) {
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	1039 super.dispose(impl, env);
1421041175a7 Adding dispose() and TruffleLanguage.disposeContext to allow user request and languages explicitly free the resources Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: 22167 diff changeset	1040 }
22128 f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1041 } // end of SPIAccessor
f879b1fe3773 Separating the TruffleVM into its own project makes it possible to cleanup various system parts interations Jaroslav Tulach <jaroslav.tulach@oracle.com> parents: diff changeset	1042 }

Mercurial > hg > truffle

annotate truffle/com.oracle.truffle.api.vm/src/com/oracle/truffle/api/vm/PolyglotEngine.java @ 22278:85a6db6624ab