Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.debug.core
Interface IStatusHandler


public interface IStatusHandler

A status handler registers to handle a specific status - error or otherwise. Provides a mechanism for separating core (headless) function from UI interaction. The debug plug-in provides a status handlers extension point, against which handlers can register for specific status codes - identified by plug-in identifier and plug-in specific status code. The interaction between an object requiring a status handler (source), and the status handler is defined by the source and handler.

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.

Since:
2.0
See Also:
DebugPlugin.getStatusHandler(IStatus)

Method Summary
  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.
 

Method Detail

handleStatus

Object handleStatus(
IStatus status,
                    
Object source)
                    throws 
CoreException
Notifies this status handler that the given status has been generated by the specified source object and requires resolution.

Parameters:
status - the status to handle
source - the object delegating to this status handler the given status
Returns:
an object representing the resolution of the status
Throws:
CoreException - if unable to resolve the status

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire