org.eclipse.debug.core.model
Interface IProcess

All Superinterfaces:

IAdaptable, ITerminate

public interface IProcess

extends IAdaptable, ITerminate

A process represents a program running in normal (non-debug) mode. Processes support setting and getting of client defined attributes. This way, clients can annotate a process with any extra information important to them. For example, classpath annotations, or command line arguments used to launch the process may be important to a client.

Clients may implement this interface, however, the debug plug-in provides an implementation of this interface for a java.lang.Process.

See Also:

DebugPlugin.newProcess(ILaunch, Process, String)

Method Summary

String	getAttribute(String key) Returns the value of a client defined attribute.
int	getExitValue() Returns the exit value of this process.
String	getLabel() Returns a human-readable label for this process.
ILaunch	getLaunch() Returns the launch this element originated from.
IStreamsProxy	getStreamsProxy() Returns a proxy to the standard input, output, and error streams for this process, or null if not supported.
void	setAttribute(String key, String value) Sets the value of a client defined attribute.

Methods inherited from interface org.eclipse.core.runtime.IAdaptable

getAdapter

Methods inherited from interface org.eclipse.debug.core.model.ITerminate

canTerminate, isTerminated, terminate

Method Detail

getLabel

public String getLabel()

Returns a human-readable label for this process.

Returns:

a label for this process

getLaunch

public ILaunch getLaunch()

Returns the launch this element originated from.

Returns:

the launch this process is contained in

getStreamsProxy

public IStreamsProxy getStreamsProxy()

Returns a proxy to the standard input, output, and error streams for this process, or null if not supported.

Returns:

a streams proxy, or null if not supported

setAttribute

public void setAttribute(String key,
                         String value)

Sets the value of a client defined attribute.

Parameters:

key - the attribute key

value - the attribute value

getAttribute

public String getAttribute(String key)

Returns the value of a client defined attribute.

Parameters:

key - the attribute key

Returns:

value the String attribute value, or null if undefined

getExitValue

public int getExitValue()
                 throws DebugException

Returns the exit value of this process. Conventionally, 0 indicates normal termination.

Returns:

the exit value of this process

Throws:

DebugException - if this process has not yet terminated