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 } |