--- old/src/jdk.scripting.nashorn/share/classes/jdk/nashorn/internal/runtime/ECMAErrors.java 2020-04-15 18:49:46.000000000 +0530 +++ /dev/null 2020-04-15 18:49:46.000000000 +0530 @@ -1,412 +0,0 @@ -/* - * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. Oracle designates this - * particular file as subject to the "Classpath" exception as provided - * by Oracle in the LICENSE file that accompanied this code. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ - -package jdk.nashorn.internal.runtime; - -import java.text.MessageFormat; -import java.util.Locale; -import java.util.ResourceBundle; -import jdk.nashorn.internal.codegen.CompilerConstants; -import jdk.nashorn.internal.objects.Global; -import jdk.nashorn.internal.scripts.JS; - -/** - * Helper class to throw various standard "ECMA error" exceptions such as Error, ReferenceError, TypeError etc. - */ -public final class ECMAErrors { - private static final String MESSAGES_RESOURCE = "jdk.nashorn.internal.runtime.resources.Messages"; - - private static final ResourceBundle MESSAGES_BUNDLE; - static { - MESSAGES_BUNDLE = ResourceBundle.getBundle(MESSAGES_RESOURCE, Locale.getDefault()); - } - - /** We assume that compiler generates script classes into the known package. */ - private static final String scriptPackage; - static { - final String name = JS.class.getName(); - scriptPackage = name.substring(0, name.lastIndexOf('.')); - } - - private ECMAErrors() { - } - - private static ECMAException error(final Object thrown, final Throwable cause) { - return new ECMAException(thrown, cause); - } - - /** - * Error dispatch mechanism. - * Create a {@link ParserException} as the correct JavaScript error - * - * @param e {@code ParserException} for error dispatcher - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException asEcmaException(final ParserException e) { - return asEcmaException(Context.getGlobal(), e); - } - - /** - * Error dispatch mechanism. - * Create a {@link ParserException} as the correct JavaScript error - * - * @param global global scope object - * @param e {@code ParserException} for error dispatcher - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException asEcmaException(final Global global, final ParserException e) { - final JSErrorType errorType = e.getErrorType(); - assert errorType != null : "error type for " + e + " was null"; - - final Global globalObj = global; - final String msg = e.getMessage(); - - // translate to ECMAScript Error object using error type - switch (errorType) { - case ERROR: - return error(globalObj.newError(msg), e); - case EVAL_ERROR: - return error(globalObj.newEvalError(msg), e); - case RANGE_ERROR: - return error(globalObj.newRangeError(msg), e); - case REFERENCE_ERROR: - return error(globalObj.newReferenceError(msg), e); - case SYNTAX_ERROR: - return error(globalObj.newSyntaxError(msg), e); - case TYPE_ERROR: - return error(globalObj.newTypeError(msg), e); - case URI_ERROR: - return error(globalObj.newURIError(msg), e); - default: - // should not happen - perhaps unknown error type? - throw new AssertionError(e.getMessage()); - } - } - - /** - * Create a syntax error (ECMA 15.11.6.4) - * - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException syntaxError(final String msgId, final String... args) { - return syntaxError(Context.getGlobal(), msgId, args); - } - - /** - * Create a syntax error (ECMA 15.11.6.4) - * - * @param global global scope object - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException syntaxError(final Global global, final String msgId, final String... args) { - return syntaxError(global, null, msgId, args); - } - - /** - * Create a syntax error (ECMA 15.11.6.4) - * - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException syntaxError(final Throwable cause, final String msgId, final String... args) { - return syntaxError(Context.getGlobal(), cause, msgId, args); - } - - /** - * Create a syntax error (ECMA 15.11.6.4) - * - * @param global global scope object - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException syntaxError(final Global global, final Throwable cause, final String msgId, final String... args) { - final String msg = getMessage("syntax.error." + msgId, args); - return error(global.newSyntaxError(msg), cause); - } - - /** - * Create a type error (ECMA 15.11.6.5) - * - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException typeError(final String msgId, final String... args) { - return typeError(Context.getGlobal(), msgId, args); - } - - /** - * Create a type error (ECMA 15.11.6.5) - * - * @param global global scope object - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException typeError(final Global global, final String msgId, final String... args) { - return typeError(global, null, msgId, args); - } - - /** - * Create a type error (ECMA 15.11.6.5) - * - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException typeError(final Throwable cause, final String msgId, final String... args) { - return typeError(Context.getGlobal(), cause, msgId, args); - } - - /** - * Create a type error (ECMA 15.11.6.5) - * - * @param global global scope object - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException typeError(final Global global, final Throwable cause, final String msgId, final String... args) { - final String msg = getMessage("type.error." + msgId, args); - return error(global.newTypeError(msg), cause); - } - - /** - * Create a range error (ECMA 15.11.6.2) - * - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException rangeError(final String msgId, final String... args) { - return rangeError(Context.getGlobal(), msgId, args); - } - - /** - * Create a range error (ECMA 15.11.6.2) - * - * @param global global scope object - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException rangeError(final Global global, final String msgId, final String... args) { - return rangeError(global, null, msgId, args); - } - - /** - * Create a range error (ECMA 15.11.6.2) - * - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException rangeError(final Throwable cause, final String msgId, final String... args) { - return rangeError(Context.getGlobal(), cause, msgId, args); - } - - /** - * Create a range error (ECMA 15.11.6.2) - * - * @param global global scope object - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException rangeError(final Global global, final Throwable cause, final String msgId, final String... args) { - final String msg = getMessage("range.error." + msgId, args); - return error(global.newRangeError(msg), cause); - } - - /** - * Create a reference error (ECMA 15.11.6.3) - * - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException referenceError(final String msgId, final String... args) { - return referenceError(Context.getGlobal(), msgId, args); - } - - /** - * Create a reference error (ECMA 15.11.6.3) - * - * @param global global scope object - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException referenceError(final Global global, final String msgId, final String... args) { - return referenceError(global, null, msgId, args); - } - - /** - * Create a reference error (ECMA 15.11.6.3) - * - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException referenceError(final Throwable cause, final String msgId, final String... args) { - return referenceError(Context.getGlobal(), cause, msgId, args); - } - - /** - * Create a reference error (ECMA 15.11.6.3) - * - * @param global global scope object - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException referenceError(final Global global, final Throwable cause, final String msgId, final String... args) { - final String msg = getMessage("reference.error." + msgId, args); - return error(global.newReferenceError(msg), cause); - } - - /** - * Create a URI error (ECMA 15.11.6.6) - * - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException uriError(final String msgId, final String... args) { - return uriError(Context.getGlobal(), msgId, args); - } - - /** - * Create a URI error (ECMA 15.11.6.6) - * - * @param global global scope object - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException uriError(final Global global, final String msgId, final String... args) { - return uriError(global, null, msgId, args); - } - - /** - * Create a URI error (ECMA 15.11.6.6) - * - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException uriError(final Throwable cause, final String msgId, final String... args) { - return uriError(Context.getGlobal(), cause, msgId, args); - } - - /** - * Create a URI error (ECMA 15.11.6.6) - * - * @param global global scope object - * @param cause native Java {@code Throwable} that is the cause of error - * @param msgId resource tag for error message - * @param args arguments to resource - * - * @return the resulting {@link ECMAException} - */ - public static ECMAException uriError(final Global global, final Throwable cause, final String msgId, final String... args) { - final String msg = getMessage("uri.error." + msgId, args); - return error(global.newURIError(msg), cause); - } - - /** - * Get the exception message by placing the args in the resource defined - * by the resource tag. This is visible to, e.g. the {@link jdk.nashorn.internal.parser.Parser} - * can use it to generate compile time messages with the correct locale - * - * @param msgId the resource tag (message id) - * @param args arguments to error string - * - * @return the filled out error string - */ - public static String getMessage(final String msgId, final String... args) { - try { - return new MessageFormat(MESSAGES_BUNDLE.getString(msgId)).format(args); - } catch (final java.util.MissingResourceException e) { - throw new RuntimeException("no message resource found for message id: "+ msgId); - } - } - - - /** - * Check if a stack trace element is in JavaScript - * - * @param frame frame - * - * @return true if frame is in the script - */ - public static boolean isScriptFrame(final StackTraceElement frame) { - final String className = frame.getClassName(); - - // Look for script package in class name (into which compiler puts generated code) - if (className.startsWith(scriptPackage) && !CompilerConstants.isInternalMethodName(frame.getMethodName())) { - final String source = frame.getFileName(); - // Make sure that it is not some Java code that Nashorn has in that package! - return source != null && !source.endsWith(".java"); - } - return false; - } -}