blob: 4a31a6da2a98111699b685905317e030f2b6609b (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
package org.eclipse.debug.core.model;
/*
* Licensed Materials - Property of IBM,
* WebSphere Studio Workbench
* (c) Copyright IBM Corp 2000
*/
import org.eclipse.debug.core.DebugException;
/**
* Provides the ability to step into, over, and return
* from the current statement in a thread.
* <p>
* Clients may implement this interface.
* </p>
* <p>
* <b>Note:</b> This class/interface is part of an interim API that is still under development and expected to
* change significantly before reaching stability. It is being made available at this early stage to solicit feedback
* from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
* (repeatedly) as the API evolves.
* </p>
*/
public interface IStep {
/**
* Returns whether this element can currently perform a step into.
*
* @return whether this element can currently perform a step into
*/
boolean canStepInto();
/**
* Returns whether this element can currently perform a step over.
*
* @return whether this element can currently perform a step over
*/
boolean canStepOver();
/**
* Returns whether this element can currently perform a step return.
*
* @return whether this element can currently perform a step return
*/
boolean canStepReturn();
/**
* Returns whether this element is currently stepping.
* <p>
* For example, a thread is considered to be stepping
* after the <code>stepOver</code> call until the step over is completed,
* a breakpoint is reached, an exception is thrown, or the thread or is
* terminated.
* </p>
*
* @return whether this element is currently stepping
*/
public boolean isStepping();
/**
* Steps into the current statement, generating <code>RESUME</code>
* and <code>SUSPEND</code> events for this thread. Can only be called
* when this thread is suspended. Implementations may choose to implement
* stepping as blocking or non-blocking.
*
* @exception DebugException on failure. Reasons include:<ul>
* <li>TARGET_REQUEST_FAILED - The request failed in the target</li>
* <li>NOT_SUPPORTED - The capability is not supported by the target</li>
* </ul>
*/
void stepInto() throws DebugException;
/**
* Steps over the current statement, generating <code>RESUME</code>
* and <code>SUSPEND</code> events for this thread. Can only be called
* when this thread is suspended. Implementations may choose to implement
* stepping as blocking or non-blocking.
*
* @exception DebugException on failure. Reasons include:<ul>
* <li>TARGET_REQUEST_FAILED - The request failed in the target</li>
* <li>NOT_SUPPORTED - The capability is not supported by the target</li>
* </ul>
*/
void stepOver() throws DebugException;
/**
* Steps to the next return statement in the current scope,
* generating <code>RESUME</code> and <code>SUSPEND</code> events for
* this thread. Can only be called when this thread is suspended.
* Implementations may choose to implement stepping as blocking or non-blocking.
*
* @exception DebugException on failure. Reasons include:<ul>
* <li>TARGET_REQUEST_FAILED - The request failed in the target</li>
* <li>NOT_SUPPORTED - The capability is not supported by the target</li>
* </ul>
*/
void stepReturn() throws DebugException;
}
|
