#
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.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html