http://www.eclipse.org/platform: Debug Core (Eclipse Foundation) 
Copyright (c) 2000, 2005 IBM Corporation and others.
This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-2.0/
SPDX-License-Identifier: EPL-2.0
Contributors:
    IBM Corporation - initial API and implementation

/*******************************************************************************
 * Copyright (c) 2000, 2005 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.debug.core.model;


import org.eclipse.core.runtime.IAdaptable;
import org.eclipse.debug.core.ILaunch;


A debug element represents an artifact in a program being
debugged.


Some methods on debug elements require communication
with the target program. Such methods may throw a DebugException
with a status code of TARGET_REQUEST_FAILED
when unable to complete a request due to a failure on the target.
Methods that require communication with the target program or require
the target to be in a specific state (for example, suspended), are declared
as such.




Debug elements are language independent. However, language specific
features can be made available via the adapter mechanism provided by
IAdaptable, or by extending the debug element interfaces.
A debug model is responsible for declaring any special adapters
its debug elements implement.




Clients may implement this interface.



/**
 * A debug element represents an artifact in a program being
 * debugged.
 * <p>
 * Some methods on debug elements require communication
 * with the target program. Such methods may throw a <code>DebugException</code>
 * with a status code of <code>TARGET_REQUEST_FAILED</code>
 * when unable to complete a request due to a failure on the target.
 * Methods that require communication with the target program or require
 * the target to be in a specific state (for example, suspended), are declared
 * as such.
 * </p>
 * <p>
 * Debug elements are language independent. However, language specific
 * features can be made available via the adapter mechanism provided by
 * <code>IAdaptable</code>, or by extending the debug element interfaces.
 * A debug model is responsible for declaring any special adapters
 * its debug elements implement.
 * </p>
 * <p>
 * Clients may implement this interface.
 * </p>
 */
public interface IDebugElement extends IAdaptable {

	
Returns the unique identifier of the plug-in
this debug element originated from.

Returns:the plug-in identifier
/**
	 * Returns the unique identifier of the plug-in
	 * this debug element originated from.
	 *
	 * @return the plug-in identifier
	 */
	String getModelIdentifier();
	
Returns the debug target this element is contained in.

Returns:the debug target this element is contained in
/**
	 * Returns the debug target this element is contained in.
	 *
	 * @return the debug target this element is contained in
	 */
	IDebugTarget getDebugTarget();
	
Returns the launch this element is contained in.

Returns:the launch this element is contained in
/**
	 * Returns the launch this element is contained in.
	 *
	 * @return the launch this element is contained in
	 */
	ILaunch getLaunch();
}