Status Handlers

Identifier:

org.eclipse.debug.core.statusHandlers

Description:

This extension point provides a mechanism for separating the generation and resolution of an error. The interaction between the source of the error and the resolution is client-defined. It is a client responsibility to look up and delegate to status handlers when an error condition occurs.

Configuration Markup:

<!ELEMENT extension (statusHandler*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

<!ELEMENT statusHandler EMPTY>

<!ATTLIST statusHandler

id CDATA #REQUIRED

class CDATA #REQUIRED

plugin CDATA #REQUIRED

code CDATA #REQUIRED>

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.

Examples:

The following is an example of a status handler extension point:


 <extension point="org.eclipse.debug.core.statusHandlers">
  <statusHandler
   id="com.example.ExampleIdentifier"
   class="com.example.ExampleStatusHandler"
   plugin="com.example.ExamplePluginId"
   code="123">
  </statusHandler>
 </extension>

In the example above, the specified status handler will be registered for to handle status objects with a plug-in identifier of com.example.ExamplePluginId and a status code of 123.

API Information:

Value of the attribute class must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.core.IStatusHandler.

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-v20.html/ SPDX-License-Identifier: EPL-2.0