Mercurial > hg > graal-jvmci-8
annotate jvmci/jdk.vm.ci.code/src/jdk/vm/ci/code/BytecodePosition.java @ 24234:ea6f94ab283b default tip
Added tag jvmci-0.36 for changeset 8128b98d4736
| author | Gilles Duboscq <gilles.m.duboscq@oracle.com> |
|---|---|
| date | Mon, 18 Sep 2017 18:49:45 +0200 |
| parents | c968119ee980 |
| children |
| rev | line source |
|---|---|
| 22054 | 1 /* |
| 2 * Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved. | |
| 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
| 4 * | |
| 5 * This code is free software; you can redistribute it and/or modify it | |
| 6 * under the terms of the GNU General Public License version 2 only, as | |
| 7 * published by the Free Software Foundation. | |
| 8 * | |
| 9 * This code is distributed in the hope that it will be useful, but WITHOUT | |
| 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 12 * version 2 for more details (a copy is included in the LICENSE file that | |
| 13 * accompanied this code). | |
| 14 * | |
| 15 * You should have received a copy of the GNU General Public License version | |
| 16 * 2 along with this work; if not, write to the Free Software Foundation, | |
| 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. | |
| 18 * | |
| 19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA | |
| 20 * or visit www.oracle.com if you need additional information or have any | |
| 21 * questions. | |
| 22 */ | |
|
22672
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
23 package jdk.vm.ci.code; |
| 22054 | 24 |
|
22569
ec96f33a101d
updated imports to be explicit and added checkstyle rule to forbid * imports
Doug Simon <doug.simon@oracle.com>
parents:
22054
diff
changeset
|
25 import java.util.Objects; |
| 22054 | 26 |
|
22672
1bbd4a7c274b
Rename jdk.internal.jvmci to jdk.vm.ci
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22569
diff
changeset
|
27 import jdk.vm.ci.meta.ResolvedJavaMethod; |
| 22054 | 28 |
| 29 /** | |
| 30 * Represents a code position, that is, a chain of inlined methods with bytecode locations, that is | |
| 31 * communicated from the compiler to the runtime system. A code position can be used by the runtime | |
| 32 * system to reconstruct a source-level stack trace for exceptions and to create | |
| 33 * {@linkplain BytecodeFrame frames} for deoptimization. | |
| 34 */ | |
| 35 public class BytecodePosition { | |
| 36 | |
| 37 private final BytecodePosition caller; | |
| 38 private final ResolvedJavaMethod method; | |
| 39 private final int bci; | |
| 40 | |
| 41 /** | |
| 42 * Constructs a new object representing a given parent/caller, a given method, and a given BCI. | |
| 43 * | |
| 44 * @param caller the parent position | |
| 45 * @param method the method | |
|
23770
c968119ee980
improved documentation of BytecodePosition API
Doug Simon <doug.simon@oracle.com>
parents:
23768
diff
changeset
|
46 * @param bci a BCI such that {@code method.codeSize() == 0 || bci < method.getCodeSize()}. That |
|
c968119ee980
improved documentation of BytecodePosition API
Doug Simon <doug.simon@oracle.com>
parents:
23768
diff
changeset
|
47 * is, if code size is 0 then allow any value, otherwise the bci must be less than |
|
c968119ee980
improved documentation of BytecodePosition API
Doug Simon <doug.simon@oracle.com>
parents:
23768
diff
changeset
|
48 * the code size. |
| 22054 | 49 */ |
| 50 public BytecodePosition(BytecodePosition caller, ResolvedJavaMethod method, int bci) { | |
| 51 assert method != null; | |
| 52 this.caller = caller; | |
| 53 this.method = method; | |
| 54 this.bci = bci; | |
|
23768
be0d95e99204
illegal bci in BytecodePosition causes IllegalArgumentException
Doug Simon <doug.simon@oracle.com>
parents:
23756
diff
changeset
|
55 int codeSize = method.getCodeSize(); |
|
be0d95e99204
illegal bci in BytecodePosition causes IllegalArgumentException
Doug Simon <doug.simon@oracle.com>
parents:
23756
diff
changeset
|
56 if (codeSize != 0 && bci >= codeSize) { |
|
be0d95e99204
illegal bci in BytecodePosition causes IllegalArgumentException
Doug Simon <doug.simon@oracle.com>
parents:
23756
diff
changeset
|
57 throw new IllegalArgumentException(String.format("bci %d is out of range for %s %d bytes", bci, method.format("%H.%n(%p)"), codeSize)); |
|
23756
d64936a16a13
Disallow too large bci in BytecodePosition
Tom Rodriguez <tom.rodriguez@oracle.com>
parents:
22672
diff
changeset
|
58 } |
| 22054 | 59 } |
| 60 | |
| 61 /** | |
| 62 * Converts this code position to a string representation. | |
| 63 * | |
| 64 * @return a string representation of this code position | |
| 65 */ | |
| 66 @Override | |
| 67 public String toString() { | |
| 68 return CodeUtil.append(new StringBuilder(100), this).toString(); | |
| 69 } | |
| 70 | |
| 71 /** | |
| 72 * Deep equality test. | |
| 73 */ | |
| 74 @Override | |
| 75 public boolean equals(Object obj) { | |
| 76 if (obj == this) { | |
| 77 return true; | |
| 78 } | |
| 79 if (obj != null && getClass() == obj.getClass()) { | |
| 80 BytecodePosition that = (BytecodePosition) obj; | |
| 81 if (this.bci == that.bci && Objects.equals(this.getMethod(), that.getMethod()) && Objects.equals(this.caller, that.caller)) { | |
| 82 return true; | |
| 83 } | |
| 84 } | |
| 85 return false; | |
| 86 } | |
| 87 | |
| 88 @Override | |
| 89 public int hashCode() { | |
| 90 return getBCI(); | |
| 91 } | |
| 92 | |
| 93 /** | |
| 94 * @return The location within the method, as a bytecode index. The constant {@code -1} may be | |
| 95 * used to indicate the location is unknown, for example within code synthesized by the | |
| 96 * compiler. | |
| 97 */ | |
| 98 public int getBCI() { | |
| 99 return bci; | |
| 100 } | |
| 101 | |
| 102 /** | |
| 103 * @return The runtime interface method for this position. | |
| 104 */ | |
| 105 public ResolvedJavaMethod getMethod() { | |
| 106 return method; | |
| 107 } | |
| 108 | |
| 109 /** | |
| 110 * The position where this position has been called, {@code null} if none. | |
| 111 */ | |
| 112 public BytecodePosition getCaller() { | |
| 113 return caller; | |
| 114 } | |
| 115 | |
| 116 /** | |
| 117 * Adds a caller to the current position returning the new position. | |
| 118 */ | |
| 119 public BytecodePosition addCaller(BytecodePosition link) { | |
| 120 if (getCaller() == null) { | |
| 121 return new BytecodePosition(link, getMethod(), getBCI()); | |
| 122 } else { | |
| 123 return new BytecodePosition(getCaller().addCaller(link), getMethod(), getBCI()); | |
| 124 } | |
| 125 } | |
| 126 } |