equal
deleted
inserted
replaced
23 * questions. |
23 * questions. |
24 */ |
24 */ |
25 |
25 |
26 package com.sun.jdi; |
26 package com.sun.jdi; |
27 |
27 |
28 import java.util.List; |
28 import com.sun.jdi.event.BreakpointEvent; |
|
29 import com.sun.jdi.event.ExceptionEvent; |
|
30 import com.sun.jdi.request.EventRequestManager; |
29 |
31 |
30 /** |
32 /** |
31 * A point within the executing code of the target VM. |
33 * A point within the executing code of the target VM. |
32 * Locations are used to identify the current position of |
34 * Locations are used to identify the current position of |
33 * a suspended thread (analogous to an instruction pointer or |
35 * a suspended thread (analogous to an instruction pointer or |
73 * that originates as Java programming language source, there |
75 * that originates as Java programming language source, there |
74 * will be only one stratum (<code>"Java"</code>) and it will be |
76 * will be only one stratum (<code>"Java"</code>) and it will be |
75 * returned as the default. To determine the available strata |
77 * returned as the default. To determine the available strata |
76 * use {@link ReferenceType#availableStrata()}. |
78 * use {@link ReferenceType#availableStrata()}. |
77 * |
79 * |
78 * @see com.sun.jdi.request.EventRequestManager |
80 * @see EventRequestManager |
79 * @see StackFrame |
81 * @see StackFrame |
80 * @see com.sun.jdi.event.BreakpointEvent |
82 * @see BreakpointEvent |
81 * @see com.sun.jdi.event.ExceptionEvent |
83 * @see ExceptionEvent |
82 * @see Locatable |
84 * @see Locatable |
83 * |
85 * |
84 * @author Robert Field |
86 * @author Robert Field |
85 * @author Gordon Hirsch |
87 * @author Gordon Hirsch |
86 * @author James McIlree |
88 * @author James McIlree |
126 * @throws AbsentInformationException if the source name is not |
128 * @throws AbsentInformationException if the source name is not |
127 * known |
129 * known |
128 */ |
130 */ |
129 String sourceName() throws AbsentInformationException; |
131 String sourceName() throws AbsentInformationException; |
130 |
132 |
131 |
|
132 /** |
133 /** |
133 * Gets an identifing name for the source corresponding to |
134 * Gets an identifing name for the source corresponding to |
134 * this location. Interpretation of this string is the |
135 * this location. Interpretation of this string is the |
135 * responsibility of the source repository mechanism. |
136 * responsibility of the source repository mechanism. |
136 * <P> |
137 * <P> |
152 * @throws AbsentInformationException if the source name is not |
153 * @throws AbsentInformationException if the source name is not |
153 * known |
154 * known |
154 * |
155 * |
155 * @since 1.4 |
156 * @since 1.4 |
156 */ |
157 */ |
157 String sourceName(String stratum) |
158 String sourceName(String stratum) throws AbsentInformationException; |
158 throws AbsentInformationException; |
|
159 |
159 |
160 /** |
160 /** |
161 * Gets the path to the source corresponding to this |
161 * Gets the path to the source corresponding to this |
162 * location. |
162 * location. |
163 * <P> |
163 * <P> |
170 * |
170 * |
171 * @throws AbsentInformationException if the source name is not |
171 * @throws AbsentInformationException if the source name is not |
172 * known |
172 * known |
173 */ |
173 */ |
174 String sourcePath() throws AbsentInformationException; |
174 String sourcePath() throws AbsentInformationException; |
175 |
|
176 |
175 |
177 /** |
176 /** |
178 * Gets the path to the source corresponding to this |
177 * Gets the path to the source corresponding to this |
179 * location. Interpretation of this string is the |
178 * location. Interpretation of this string is the |
180 * responsibility of the source repository mechanism. |
179 * responsibility of the source repository mechanism. |
204 * @throws AbsentInformationException if the source name is not |
203 * @throws AbsentInformationException if the source name is not |
205 * known |
204 * known |
206 * |
205 * |
207 * @since 1.4 |
206 * @since 1.4 |
208 */ |
207 */ |
209 String sourcePath(String stratum) |
208 String sourcePath(String stratum) throws AbsentInformationException; |
210 throws AbsentInformationException; |
|
211 |
209 |
212 /** |
210 /** |
213 * Gets the line number of this Location. |
211 * Gets the line number of this Location. |
214 * <P> |
212 * <P> |
215 * This method is equivalent to |
213 * This method is equivalent to |