public interface IStatusHandler
For example, a launch configuration delegate might encounter a timeout while launching an application. In this case the delegate could abort or, via the use of a status handler, prompt the user to continue. This allows the launcher to be implemented in a plug-in that does not require UI support, and allows another (UI) plug-in to register a handler.
A status handler extension is defined in plugin.xml.
Following is an example definition of a status handler extension.
<extension point="org.eclipse.debug.core.statusHandlers">
<statusHandler
id="com.example.ExampleIdentifier"
class="com.example.ExampleStatusHandler"
plugin="com.example.ExamplePluginId"
code="123">
</statusHandler>
</extension>
The attributes are specified as follows:
id specifies a unique identifier for this status handler.class specifies the fully qualified name of the Java class
that implements IStatusHandler.plugin plug-in identifier that corresponds to the
plug-in of the status this handler is registered for (i.e.
IStatus.getPlugin()).code specifies the status code this handler
is registered for.Clients may implement this interface.
DebugPlugin.getStatusHandler(IStatus)| Modifier and Type | Method and Description |
|---|---|
Object |
handleStatus(IStatus status,
Object source)
Notifies this status handler that the given status has been
generated by the specified source object and requires resolution.
|
Object handleStatus(IStatus status, Object source) throws CoreException
status - the status to handlesource - the object delegating to this status handler
the given statusCoreException - if unable to resolve the statusGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.