uk.ac.starlink.util.gui.ErrorDialog

All Implemented Interfaces:: ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class ErrorDialog extends JDialog

Utility class for displaying an error dialogue to the user. Calling the static showError method pops up a modal dialogue which informs the user what went wrong. As initially displayed this just contains the message or name of the exception plus optionally some additional lines of text, but a button is provided which can display the full stack trace.

Since:

23 Feb 2005

Author:

Mark Taylor (Starlink)

See Also:

Nested Class Summary

Nested classes/interfaces inherited from class JDialog
JDialog.AccessibleJDialog

Nested classes/interfaces inherited from class Dialog
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Nested classes/interfaces inherited from class Window
Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Field Summary

Fields inherited from class JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class Dialog
DEFAULT_MODALITY_TYPE

Fields inherited from class Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Fields inherited from interface WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
Constructor Summary

Constructors

Constructor

Description

ErrorDialog(Frame frame, Throwable error, String title, String[] message)

Constructor.
Method Summary

Modifier and Type

Method

Description

static void

main(String[] args)

static void

showError(Component parent, String title, Throwable error)

Pops up a modal dialogue displaying information about an error.

static void

showError(Component parent, String title, Throwable error, String message)

Pops up a modal dialogue displaying information about an error with an additional single-line message.

static void

showError(Component parent, String title, Throwable error, String[] message)

Pops up a modal dialogue displaying information about an error with an additional multi-line message.

static void

showError(Component parent, Throwable error)

Pops up a modal dialogue displaying information about an error.

Methods inherited from class JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Methods inherited from class Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront

Methods inherited from class Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details
- ErrorDialog
  
  public ErrorDialog(Frame frame, Throwable error, String title, String[] message)
  
  Constructor.
  
  Parameters:
  
  frame - frame which will own the dialogue
  
  error - throwable to be displayed
  
  title - dialogue window title
  
  message - additional text, one line per element
Method Details
- showError
  
  public static void showError(Component parent, String title, Throwable error, String[] message)
  
  Pops up a modal dialogue displaying information about an error with an additional multi-line message.
  
  Parameters:
  
  parent - parent component
  
  title - title of the dialogue window
  
  error - the throwable to be displayed
  
  message - an array of one or more strings providing additional information about the error. Each string is displayed as a line.
- showError
  
  public static void showError(Component parent, String title, Throwable error, String message)
  
  Pops up a modal dialogue displaying information about an error with an additional single-line message.
  
  Parameters:
  
  parent - parent component
  
  title - title of the dialogue window
  
  error - the throwable to be displayed
  
  message - one-line message text
- showError
  
  public static void showError(Component parent, String title, Throwable error)
  
  Pops up a modal dialogue displaying information about an error.
  
  Parameters:
  
  parent - parent component
  
  title - title of the dialogue window
  
  error - the throwable to be displayed
- showError
  
  public static void showError(Component parent, Throwable error)
  
  Pops up a modal dialogue displaying information about an error.
  
  Parameters:
  
  parent - parent component
  
  error - the throwable to be displayed
- main
  
  public static void main(String[] args)

Class ErrorDialog

Nested Class Summary

Nested classes/interfaces inherited from class JDialog

Nested classes/interfaces inherited from class Dialog

Nested classes/interfaces inherited from class Window

Nested classes/interfaces inherited from class Container

Nested classes/interfaces inherited from class Component

Field Summary

Fields inherited from class JDialog

Fields inherited from class Dialog

Fields inherited from class Component

Fields inherited from interface ImageObserver

Fields inherited from interface WindowConstants

Constructor Summary

Method Summary

Methods inherited from class JDialog

Methods inherited from class Dialog

Methods inherited from class Window

Methods inherited from class Container

Methods inherited from class Component

Methods inherited from class Object

Constructor Details

ErrorDialog

Method Details

showError

showError

showError

showError

main