1 /* |
1 /* |
2 * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
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 |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
25 |
25 |
26 package com.sun.jdi; |
26 package com.sun.jdi; |
27 |
27 |
28 import java.util.List; |
28 import java.util.List; |
29 import java.util.Map; |
29 import java.util.Map; |
|
30 |
|
31 import com.sun.jdi.event.EventQueue; |
|
32 import com.sun.jdi.event.VMDisconnectEvent; |
30 |
33 |
31 /** |
34 /** |
32 * The state of one method invocation on a thread's call stack. |
35 * The state of one method invocation on a thread's call stack. |
33 * As a thread executes, stack frames are pushed and popped from |
36 * As a thread executes, stack frames are pushed and popped from |
34 * its call stack as methods are invoked and then return. A StackFrame |
37 * its call stack as methods are invoked and then return. A StackFrame |
43 * The lifetime of a StackFrame is very limited. It is available only |
46 * The lifetime of a StackFrame is very limited. It is available only |
44 * for suspended threads and becomes invalid once its thread is resumed. |
47 * for suspended threads and becomes invalid once its thread is resumed. |
45 * <p> |
48 * <p> |
46 * Any method on <code>StackFrame</code> which |
49 * Any method on <code>StackFrame</code> which |
47 * takes <code>StackFrame</code> as an parameter may throw |
50 * takes <code>StackFrame</code> as an parameter may throw |
48 * {@link com.sun.jdi.VMDisconnectedException} if the target VM is |
51 * {@link VMDisconnectedException} if the target VM is |
49 * disconnected and the {@link com.sun.jdi.event.VMDisconnectEvent} has been or is |
52 * disconnected and the {@link VMDisconnectEvent} has been or is |
50 * available to be read from the {@link com.sun.jdi.event.EventQueue}. |
53 * available to be read from the {@link EventQueue}. |
51 * <p> |
54 * <p> |
52 * Any method on <code>StackFrame</code> which |
55 * Any method on <code>StackFrame</code> which |
53 * takes <code>StackFrame</code> as an parameter may throw |
56 * takes <code>StackFrame</code> as an parameter may throw |
54 * {@link com.sun.jdi.VMOutOfMemoryException} if the target VM has run out of memory. |
57 * {@link VMOutOfMemoryException} if the target VM has run out of memory. |
55 * |
58 * |
56 * @author Robert Field |
59 * @author Robert Field |
57 * @author Gordon Hirsch |
60 * @author Gordon Hirsch |
58 * @author James McIlree |
61 * @author James McIlree |
59 * @since 1.3 |
62 * @since 1.3 |