nashorn/src/jdk.scripting.nashorn/share/classes/jdk/nashorn/internal/runtime/Debug.java
author lagergren
Fri, 26 Sep 2014 18:47:20 +0200
changeset 26886 18c744ab4df2
parent 25865 d38d876f1654
child 32695 9b708b92c695
permissions -rw-r--r--
8059211: Changed ArrayData.length accessor to use the protected field and fixed javadoc warnings related to this Reviewed-by: attila, hannesw
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
16147
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     1
/*
16151
97c1e756ae1e 8005663: Update copyright year to 2013
jlaskey
parents: 16147
diff changeset
     2
 * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved.
16147
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     4
 *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    10
 *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    15
 * accompanied this code).
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    16
 *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    20
 *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    23
 * questions.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    24
 */
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    25
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    26
package jdk.nashorn.internal.runtime;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    27
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    28
import static jdk.nashorn.internal.parser.TokenType.EOF;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    29
import jdk.nashorn.internal.parser.Lexer;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    30
import jdk.nashorn.internal.parser.Token;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    31
import jdk.nashorn.internal.parser.TokenStream;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    32
import jdk.nashorn.internal.parser.TokenType;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    33
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    34
/**
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    35
 * Utilities for debugging Nashorn.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    36
 *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    37
 */
16226
0e4f37e6cc40 8007915: Nashorn IR, codegen, parser packages and Context instance should be inaccessible to user code
sundar
parents: 16151
diff changeset
    38
public final class Debug {
16147
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    39
    private Debug() {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    40
    }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    41
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    42
    /**
24719
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    43
     * Return the topmost JavaScript frame in a stack trace
26886
18c744ab4df2 8059211: Changed ArrayData.length accessor to use the protected field and fixed javadoc warnings related to this
lagergren
parents: 25865
diff changeset
    44
     * @param t throwable that contains the stack trace
24719
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    45
     * @return line describing the topmost JavaScript frame
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    46
     */
26886
18c744ab4df2 8059211: Changed ArrayData.length accessor to use the protected field and fixed javadoc warnings related to this
lagergren
parents: 25865
diff changeset
    47
    public static String firstJSFrame(final Throwable t) {
18c744ab4df2 8059211: Changed ArrayData.length accessor to use the protected field and fixed javadoc warnings related to this
lagergren
parents: 25865
diff changeset
    48
        for (final StackTraceElement ste : t.getStackTrace()) {
18c744ab4df2 8059211: Changed ArrayData.length accessor to use the protected field and fixed javadoc warnings related to this
lagergren
parents: 25865
diff changeset
    49
            if (ECMAErrors.isScriptFrame(ste)) {
24719
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    50
                return ste.toString();
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    51
            }
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    52
        }
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    53
        return "<native code>";
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    54
    }
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    55
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    56
    /**
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    57
     * Return the topmost JavaScript frame from the current
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    58
     * continuation
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    59
     * @return line describing the topmost JavaScript frame
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    60
     */
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    61
    public static String firstJSFrame() {
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    62
        return firstJSFrame(new Throwable());
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    63
    }
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    64
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    65
    /**
16147
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    66
     * Return the system identity hashcode for an object as a human readable
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    67
     * string
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    68
     *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    69
     * @param x object
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    70
     * @return system identity hashcode as string
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    71
     */
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    72
    public static String id(final Object x) {
24725
7bb1f687a852 8033334: Make sure that scope depth information is maintained in the RecompilableScriptFunctionDatas, to avoid unnecessary slow proto linkage when doing on demand compilation
lagergren
parents: 24719
diff changeset
    73
        return String.format("0x%08x", System.identityHashCode(x));
16147
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    74
    }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    75
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    76
    /**
24719
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    77
     * Same as {@link Debug#id} but returns the identity hashcode as
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    78
     * an integer
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    79
     *
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    80
     * @param x object
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    81
     * @return system identity hashcode
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    82
     */
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    83
    public static int intId(final Object x) {
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    84
        return System.identityHashCode(x);
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    85
    }
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    86
f726e9d67629 8035820: Optimistic recompilation
attila
parents: 16226
diff changeset
    87
    /**
16147
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    88
     * Return a stack trace element description at a depth from where we are not
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    89
     *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    90
     * @param depth depth
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    91
     * @return stack trace element as string
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    92
     */
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    93
    public static String stackTraceElementAt(final int depth) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    94
        return new Throwable().getStackTrace()[depth + 1].toString(); // add 1 to compensate for this method
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    95
    }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    96
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    97
    /**
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    98
     * Determine caller for tracing purposes.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
    99
     * @param depth depth to trace
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   100
     * @param count max depth
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   101
     * @param ignores elements to ignore in stack trace
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   102
     * @return caller
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   103
     */
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   104
    public static String caller(final int depth, final int count, final String... ignores) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   105
        String result = "";
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   106
        final StackTraceElement[] callers = Thread.currentThread().getStackTrace();
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   107
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   108
        int c = count;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   109
loop:
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   110
        for (int i = depth + 1; i < callers.length && c != 0; i++) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   111
            final StackTraceElement element = callers[i];
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   112
            final String method = element.getMethodName();
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   113
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   114
            for (final String ignore : ignores) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   115
                if (method.compareTo(ignore) == 0) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   116
                    continue loop;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   117
                }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   118
            }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   119
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   120
            result += (method + ":" + element.getLineNumber() +
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   121
                       "                              ").substring(0, 30);
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   122
            c--;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   123
        }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   124
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   125
        return result.isEmpty() ? "<no caller>" : result;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   126
    }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   127
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   128
    /**
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   129
     * Dump a token stream to stdout
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   130
     *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   131
     * TODO: most other bugging goes to stderr, change?
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   132
     *
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   133
     * @param source the source
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   134
     * @param lexer  the lexer
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   135
     * @param stream the stream to dump
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   136
     */
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   137
    public static void dumpTokens(final Source source, final Lexer lexer, final TokenStream stream) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   138
        TokenType type;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   139
        int k = 0;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   140
        do {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   141
            while (k > stream.last()) {
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   142
                // Get more tokens.
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   143
                lexer.lexify();
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   144
            }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   145
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   146
            final long token = stream.get(k);
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   147
            type = Token.descType(token);
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   148
            System.out.println("" + k + ": " + Token.toString(source, token, true));
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   149
            k++;
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   150
        } while(type != EOF);
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   151
    }
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   152
e63b63819133 8005403: Open-source Nashorn
jlaskey
parents:
diff changeset
   153
}