Class EmergencyAbortListener

java.lang.Object
org.fest.swing.core.EmergencyAbortListener
All Implemented Interfaces:
AWTEventListener, EventListener

public class EmergencyAbortListener extends Object implements AWTEventListener
Understands an escape valve for users to abort a running FEST-Swing test by pressing 'Ctrl + Shift + A'. The key combination to use to abort test is configurable through the method keyCombination(KeyPressInfo).

The following example shows to use this listener in a TestNG test:

 private EmergencyAbortListener listener;


 @BeforeMethod public void setUp() {
   // set up your test fixture.
   listener = EmergencyAbortListener.registerInToolkit();
 }

 @AfterMethod public void tearDown() {
   // clean up resources.
   listener.unregister();
 }
 

Changing the default key combination for aborting test:

 listener = EmergencyAbortListener.registerInToolkit().keyCombination(key(VK_C).modifiers(SHIFT_MASK));
 

  • Field Details

    • EVENT_MASK

      private static final long EVENT_MASK
      See Also:
    • toolkit

      private final Toolkit toolkit
    • testTerminator

      private final TestTerminator testTerminator
    • keyCode

      private int keyCode
    • modifiers

      private int modifiers
  • Constructor Details

    • EmergencyAbortListener

      EmergencyAbortListener(Toolkit toolkit)
    • EmergencyAbortListener

      EmergencyAbortListener(Toolkit toolkit, TestTerminator testTerminator)
  • Method Details

    • registerInToolkit

      public static EmergencyAbortListener registerInToolkit()
      Attaches a new instance of EmergencyAbortListener in the given Toolkit. Any other instances of EmergencyAbortListener will be removed from the Toolkit.
      Returns:
      the created listener.
    • register

      void register()
    • removePrevious

      private void removePrevious()
    • keyCombination

      public EmergencyAbortListener keyCombination(KeyPressInfo keyPressInfo)
      Sets the key combination that will terminate any FEST-Swing test. The default combination is 'Ctrl + Shift + A'.
      Parameters:
      keyPressInfo - contains information about the key code and modifiers.
      Returns:
      this listener.
      Throws:
      NullPointerException - if the KeyPressInfo is null.
    • unregister

      public void unregister()
      Removes this listener from the Toolkit this listener is attached to.
    • eventDispatched

      public void eventDispatched(AWTEvent event)
      Inspects key events for the key combination that should terminate any running FEST-Swing tests.
      Specified by:
      eventDispatched in interface AWTEventListener
      Parameters:
      event - the event to inspect.
      See Also:
    • keyCode

      int keyCode()
    • modifiers

      int modifiers()