src/jdk/nashorn/api/scripting/NashornScriptEngineFactory.java

Thu, 14 Mar 2013 14:49:55 +0100

author
lagergren
date
Thu, 14 Mar 2013 14:49:55 +0100
changeset 139
390d44ba90cf
parent 136
c54e218333be
child 196
222a72df2f42
permissions
-rw-r--r--

8009982: Lazy execution bugfix. Added lazy sunspider unit test. Added mandreel to compile-octane test. Fixed warnings
Reviewed-by: sundar, jlaskey

jlaskey@3 1 /*
jlaskey@7 2 * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved.
jlaskey@3 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jlaskey@3 4 *
jlaskey@3 5 * This code is free software; you can redistribute it and/or modify it
jlaskey@3 6 * under the terms of the GNU General Public License version 2 only, as
jlaskey@3 7 * published by the Free Software Foundation. Oracle designates this
jlaskey@3 8 * particular file as subject to the "Classpath" exception as provided
jlaskey@3 9 * by Oracle in the LICENSE file that accompanied this code.
jlaskey@3 10 *
jlaskey@3 11 * This code is distributed in the hope that it will be useful, but WITHOUT
jlaskey@3 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jlaskey@3 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
jlaskey@3 14 * version 2 for more details (a copy is included in the LICENSE file that
jlaskey@3 15 * accompanied this code).
jlaskey@3 16 *
jlaskey@3 17 * You should have received a copy of the GNU General Public License version
jlaskey@3 18 * 2 along with this work; if not, write to the Free Software Foundation,
jlaskey@3 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jlaskey@3 20 *
jlaskey@3 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
jlaskey@3 22 * or visit www.oracle.com if you need additional information or have any
jlaskey@3 23 * questions.
jlaskey@3 24 */
jlaskey@3 25
jlaskey@3 26 package jdk.nashorn.api.scripting;
jlaskey@3 27
jlaskey@3 28 import java.util.Arrays;
jlaskey@3 29 import java.util.Collections;
jlaskey@3 30 import java.util.List;
jlaskey@3 31 import javax.script.ScriptEngine;
jlaskey@3 32 import javax.script.ScriptEngineFactory;
jlaskey@3 33 import jdk.nashorn.internal.runtime.Version;
sundar@53 34 import sun.reflect.Reflection;
jlaskey@3 35
jlaskey@3 36 /**
jlaskey@3 37 * JSR-223 compliant script engine factory for Nashorn. The engine answers for:
jlaskey@3 38 * <ul>
jlaskey@3 39 * <li>names {@code "nashorn"}, {@code "Nashorn"}, {@code "js"}, {@code "JS"}, {@code "JavaScript"},
jlaskey@3 40 * {@code "javascript"}, {@code "ECMAScript"}, and {@code "ecmascript"};</li>
jlaskey@3 41 * <li>MIME types {@code "application/javascript"}, {@code "application/ecmascript"}, {@code "text/javascript"}, and
jlaskey@3 42 * {@code "text/ecmascript"};</li>
jlaskey@3 43 * <li>as well as for the extension {@code "js"}.</li>
jlaskey@3 44 * </ul>
jlaskey@3 45 * Programs executing in engines created using {@link #getScriptEngine(String[])} will have the passed arguments
jlaskey@3 46 * accessible as a global variable named {@code "arguments"}.
jlaskey@3 47 */
jlaskey@3 48 public final class NashornScriptEngineFactory implements ScriptEngineFactory {
jlaskey@3 49 @Override
jlaskey@3 50 public String getEngineName() {
jlaskey@3 51 return (String) getParameter(ScriptEngine.ENGINE);
jlaskey@3 52 }
jlaskey@3 53
jlaskey@3 54 @Override
jlaskey@3 55 public String getEngineVersion() {
jlaskey@3 56 return (String) getParameter(ScriptEngine.ENGINE_VERSION);
jlaskey@3 57 }
jlaskey@3 58
jlaskey@3 59 @Override
jlaskey@3 60 public List<String> getExtensions() {
jlaskey@3 61 return Collections.unmodifiableList(extensions);
jlaskey@3 62 }
jlaskey@3 63
jlaskey@3 64 @Override
jlaskey@3 65 public String getLanguageName() {
jlaskey@3 66 return (String) getParameter(ScriptEngine.LANGUAGE);
jlaskey@3 67 }
jlaskey@3 68
jlaskey@3 69 @Override
jlaskey@3 70 public String getLanguageVersion() {
jlaskey@3 71 return (String) getParameter(ScriptEngine.LANGUAGE_VERSION);
jlaskey@3 72 }
jlaskey@3 73
jlaskey@3 74 @Override
jlaskey@3 75 public String getMethodCallSyntax(final String obj, final String method, final String... args) {
jlaskey@3 76 final StringBuilder sb = new StringBuilder().append(obj).append('.').append(method).append('(');
jlaskey@3 77 final int len = args.length;
jlaskey@3 78
jlaskey@3 79 if (len > 0) {
jlaskey@3 80 sb.append(args[0]);
jlaskey@3 81 }
jlaskey@3 82 for (int i = 1; i < len; i++) {
jlaskey@3 83 sb.append(',').append(args[i]);
jlaskey@3 84 }
jlaskey@3 85 sb.append(')');
jlaskey@3 86
jlaskey@3 87 return sb.toString();
jlaskey@3 88 }
jlaskey@3 89
jlaskey@3 90 @Override
jlaskey@3 91 public List<String> getMimeTypes() {
jlaskey@3 92 return Collections.unmodifiableList(mimeTypes);
jlaskey@3 93 }
jlaskey@3 94
jlaskey@3 95 @Override
jlaskey@3 96 public List<String> getNames() {
jlaskey@3 97 return Collections.unmodifiableList(names);
jlaskey@3 98 }
jlaskey@3 99
jlaskey@3 100 @Override
jlaskey@3 101 public String getOutputStatement(final String toDisplay) {
jlaskey@3 102 return "print(" + toDisplay + ")";
jlaskey@3 103 }
jlaskey@3 104
jlaskey@3 105 @Override
jlaskey@3 106 public Object getParameter(final String key) {
jlaskey@3 107 switch (key) {
jlaskey@3 108 case ScriptEngine.NAME:
jlaskey@3 109 return "javascript";
jlaskey@3 110 case ScriptEngine.ENGINE:
jlaskey@3 111 return "Oracle Nashorn";
jlaskey@3 112 case ScriptEngine.ENGINE_VERSION:
jlaskey@3 113 return Version.version();
jlaskey@3 114 case ScriptEngine.LANGUAGE:
jlaskey@3 115 return "ECMAScript";
jlaskey@3 116 case ScriptEngine.LANGUAGE_VERSION:
jlaskey@3 117 return "ECMA - 262 Edition 5.1";
jlaskey@3 118 case "THREADING":
jlaskey@3 119 // The engine implementation is not thread-safe. Can't be
jlaskey@3 120 // used to execute scripts concurrently on multiple threads.
jlaskey@3 121 return null;
jlaskey@3 122 default:
jlaskey@3 123 throw new IllegalArgumentException("Invalid key");
jlaskey@3 124 }
jlaskey@3 125 }
jlaskey@3 126
jlaskey@3 127 @Override
jlaskey@3 128 public String getProgram(final String... statements) {
jlaskey@3 129 final StringBuilder sb = new StringBuilder();
jlaskey@3 130
jlaskey@3 131 for (final String statement : statements) {
jlaskey@3 132 sb.append(statement).append(';');
jlaskey@3 133 }
jlaskey@3 134
jlaskey@3 135 return sb.toString();
jlaskey@3 136 }
jlaskey@3 137
jlaskey@3 138 @Override
jlaskey@3 139 public ScriptEngine getScriptEngine() {
sundar@53 140 return new NashornScriptEngine(this, getAppClassLoader());
jlaskey@3 141 }
jlaskey@3 142
jlaskey@3 143 /**
sundar@55 144 * Create a new Script engine initialized by given class loader.
sundar@55 145 *
sundar@55 146 * @param appLoader class loader to be used as script "app" class loader.
sundar@55 147 * @return newly created script engine.
sundar@55 148 */
sundar@55 149 public ScriptEngine getScriptEngine(final ClassLoader appLoader) {
sundar@136 150 checkConfigPermission();
sundar@55 151 return new NashornScriptEngine(this, appLoader);
sundar@55 152 }
sundar@55 153
sundar@55 154 /**
jlaskey@3 155 * Create a new Script engine initialized by given arguments.
jlaskey@3 156 *
jlaskey@3 157 * @param args arguments array passed to script engine.
jlaskey@3 158 * @return newly created script engine.
jlaskey@3 159 */
jlaskey@3 160 public ScriptEngine getScriptEngine(final String[] args) {
sundar@136 161 checkConfigPermission();
sundar@53 162 return new NashornScriptEngine(this, args, getAppClassLoader());
jlaskey@3 163 }
jlaskey@3 164
sundar@55 165 /**
sundar@55 166 * Create a new Script engine initialized by given arguments.
sundar@55 167 *
sundar@55 168 * @param args arguments array passed to script engine.
sundar@55 169 * @param appLoader class loader to be used as script "app" class loader.
sundar@55 170 * @return newly created script engine.
sundar@55 171 */
sundar@55 172 public ScriptEngine getScriptEngine(final String[] args, final ClassLoader appLoader) {
sundar@136 173 checkConfigPermission();
sundar@55 174 return new NashornScriptEngine(this, args, appLoader);
sundar@55 175 }
sundar@55 176
jlaskey@3 177 // -- Internals only below this point
jlaskey@3 178
lagergren@139 179 private static void checkConfigPermission() {
sundar@136 180 final SecurityManager sm = System.getSecurityManager();
sundar@136 181 if (sm != null) {
sundar@136 182 sm.checkPermission(new RuntimePermission("nashorn.setConfig"));
sundar@136 183 }
sundar@136 184 }
sundar@136 185
jlaskey@3 186 private static final List<String> names;
jlaskey@3 187 private static final List<String> mimeTypes;
jlaskey@3 188 private static final List<String> extensions;
jlaskey@3 189
jlaskey@3 190 static {
jlaskey@3 191 names = immutableList(
jlaskey@3 192 "nashorn", "Nashorn",
jlaskey@3 193 "js", "JS",
jlaskey@3 194 "JavaScript", "javascript",
jlaskey@3 195 "ECMAScript", "ecmascript"
jlaskey@3 196 );
jlaskey@3 197
jlaskey@3 198 mimeTypes = immutableList(
jlaskey@3 199 "application/javascript",
jlaskey@3 200 "application/ecmascript",
jlaskey@3 201 "text/javascript",
jlaskey@3 202 "text/ecmascript"
jlaskey@3 203 );
jlaskey@3 204
jlaskey@3 205 extensions = immutableList("js");
jlaskey@3 206 }
jlaskey@3 207
jlaskey@3 208 private static List<String> immutableList(final String... elements) {
jlaskey@3 209 return Collections.unmodifiableList(Arrays.asList(elements));
jlaskey@3 210 }
sundar@53 211
sundar@53 212 private static ClassLoader getAppClassLoader() {
sundar@53 213 if (System.getSecurityManager() == null) {
sundar@55 214 return Thread.currentThread().getContextClassLoader();
sundar@53 215 }
sundar@53 216
sundar@53 217 // Try to determine the caller class loader. Use that if it can be
sundar@53 218 // found. If not, use the class loader of nashorn itself as the
sundar@53 219 // "application" class loader for scripts.
sundar@53 220
sundar@53 221 // User could have called ScriptEngineFactory.getScriptEngine()
sundar@53 222 //
sundar@53 223 // <caller>
sundar@53 224 // <factory.getScriptEngine()>
sundar@53 225 // <factory.getAppClassLoader()>
sundar@53 226 // <Reflection.getCallerClass()>
sundar@53 227 //
sundar@53 228 // or used one of the getEngineByABC methods of ScriptEngineManager.
sundar@53 229 //
sundar@53 230 // <caller>
sundar@53 231 // <ScriptEngineManager.getEngineByName()>
sundar@53 232 // <factory.getScriptEngine()>
sundar@53 233 // <factory.getAppClassLoader()>
sundar@53 234 // <Reflection.getCallerClass()>
sundar@53 235
sundar@53 236 // So, stack depth is 3 or 4 (recall it is zero based). We try
sundar@53 237 // stack depths 3, 4 and look for non-bootstrap caller.
sundar@53 238 Class<?> caller = null;
sundar@53 239 for (int depth = 3; depth < 5; depth++) {
sundar@53 240 caller = Reflection.getCallerClass(depth);
sundar@53 241 if (caller != null && caller.getClassLoader() != null) {
sundar@53 242 // found a non-bootstrap caller
sundar@53 243 break;
sundar@53 244 }
sundar@53 245 }
sundar@53 246
sundar@53 247 final ClassLoader ccl = (caller == null)? null : caller.getClassLoader();
sundar@53 248 // if caller loader is null, then use nashorn's own loader
sundar@53 249 return (ccl == null)? NashornScriptEngineFactory.class.getClassLoader() : ccl;
sundar@53 250 }
jlaskey@3 251 }

mercurial