Home

Contribute

Source code


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

package org.eclipse.debug.core.model;

/**********************************************************************
Copyright (c) 2000, 2002 IBM Corp.  All rights reserved.
This file is made available under the terms of the Common Public License v1.0
which accompanies this distribution, and is available at
http://www.eclipse.org/legal/cpl-v10.html
**********************************************************************/

import org.eclipse.debug.core.DebugException;

/**
 * Provides the ability to perform a filtered step. Implementations must be non-
 * blocking. Filter implementation is debug model specific and may not be
 * supported by all debug models.
 * <p>
 * Clients may implement this interface.
 * </p>
 * @since 2.1
 */
public interface IFilteredStep extends IStep {
	/**
	 * Returns whether this element can currently perform a filtered step into.
	 *
	 * @return whether this element can currently perform a filtered step into
	 */
	public boolean canStepWithFilters();
	/**
	 * Steps into the current statement, generating <code>RESUME</code>
	 * and <code>SUSPEND</code> events for the associated thread, applying step
	 * filters, as applicable for the associated thread. Can only be called when
	 * the associated thread is suspended. Implementations must implement
	 * stepping as 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>
	 */
	public void stepWithFilters() throws DebugException;
}