SafeHandler (Net4j Utilities Documentation)

java.lang.Object

org.eclipse.core.commands.common.EventManager

org.eclipse.core.commands.AbstractHandler

org.eclipse.net4j.util.ui.handlers.SafeHandler

All Implemented Interfaces:: IHandler, IHandler2

Direct Known Subclasses:: LongRunningHandler

public abstract class SafeHandler extends AbstractHandler

Since:: 3.4
Author:: Eike Stepper, Christian W. Damus (CEA LIST)

Constructor Summary

Constructors

Constructor

Description

SafeHandler()
Method Summary

Modifier and Type

Method

Description

Object

execute(ExecutionEvent event)

protected void

extractEventDetails(ExecutionEvent event)

Extracts details from the event that we may need later, for example on a background thread when the original execution context is no longer valid.

Command

getCommand()

ISelection

getSelection()

protected String

getText()

protected abstract Object

safeExecute(ExecutionEvent event)

void

setEnabled(Object evaluationContext)

protected boolean

updateSelection(ISelection selection)

Methods inherited from class org.eclipse.core.commands.AbstractHandler
addHandlerListener, dispose, fireHandlerChanged, hasListeners, isEnabled, isHandled, removeHandlerListener, setBaseEnabled

Methods inherited from class org.eclipse.core.commands.common.EventManager
addListenerObject, clearListeners, getListeners, isListenerAttached, removeListenerObject

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.eclipse.core.commands.IHandler
getHandlerLabel

Constructor Details
- SafeHandler
  
  public SafeHandler()
Method Details
- getCommand
  
  public Command getCommand()
- getSelection
  
  public ISelection getSelection()
- execute
  
  public Object execute(ExecutionEvent event) throws ExecutionException
  
  Throws:
  
  ExecutionException
- setEnabled
  
  public void setEnabled(Object evaluationContext)
  
  Specified by:
  
  setEnabled in interface IHandler2
  
  Overrides:
  
  setEnabled in class AbstractHandler
- extractEventDetails
  
  protected void extractEventDetails(ExecutionEvent event)
  
  Extracts details from the event that we may need later, for example on a background thread when the original execution context is no longer valid.
- safeExecute
  
  protected abstract Object safeExecute(ExecutionEvent event) throws Exception
  
  Throws:
  
  Exception
- getText
  
  protected String getText()
- updateSelection
  
  protected boolean updateSelection(ISelection selection)