dip.gui.dialog
Class ErrorDialog

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Dialog
                  javax.swing.JDialog
                      dip.gui.dialog.XDialog
                          dip.gui.dialog.HeaderDialog
                              dip.gui.dialog.TextViewer
                                  dip.gui.dialog.ErrorDialog

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable, javax.swing.WindowConstants

public class ErrorDialog

extends TextViewer

Various error dialogs, which use HTML templates to display errors.

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class dip.gui.dialog.TextViewer

TextViewer.AcceptListener, TextViewer.TVRunnable

Nested classes inherited from class dip.gui.dialog.HeaderDialog

HeaderDialog.GradientXJEditorPane

Nested classes inherited from class javax.swing.JDialog

javax.swing.JDialog.AccessibleJDialog

Nested classes inherited from class java.awt.Dialog

java.awt.Dialog.AccessibleAWTDialog

Nested classes inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class dip.gui.dialog.TextViewer

CONTENT_HTML, CONTENT_PLAIN, tvFont

Fields inherited from class dip.gui.dialog.HeaderDialog

ACTION_ACCEPT, ACTION_CANCEL, ACTION_CLOSE, ACTION_OK, BTN_BAR_BETWEEN, BTN_BAR_EDGE, header

Fields inherited from class dip.gui.dialog.XDialog

TEXT_ACCEPT, TEXT_CANCEL, TEXT_CLOSE, TEXT_OK

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Method Summary

static void	displayFatal(javax.swing.JFrame parent, java.lang.Throwable e) This should be used whenever a FATAL error occurs.
static void	displayFileIO(javax.swing.JFrame parent, java.lang.Exception e, java.lang.String fileName) This should be used whenever a FILE error occurs.
static void	displayGeneral(javax.swing.JFrame parent, java.lang.Exception e) This should be used whenever a GENERAL error occurs.
static void	displayNetIO(javax.swing.JFrame parent, java.io.IOException e, java.lang.String connection) This should be used whenever a NETWORK error occurs.
static void	displaySerious(javax.swing.JFrame parent, java.lang.Throwable e) This should be used whenever a SERIOUS error occurs.
static void	displayVariantNotAvailable(javax.swing.JFrame parent, World.VariantInfo vi) This should be used whenever a Variant is not available.
static void	displayVariantVersionMismatch(javax.swing.JFrame parent, World.VariantInfo vi, float availableVersion) This should be used whenever there is a Variant version mismatch.

Methods inherited from class dip.gui.dialog.TextViewer

close, displayDialog, filterExportedText, filterHTML, getEditorPane, getFileName, getText, lazyLoadDisplayDialog, saveContents, setAcceptListener, setContentType, setEditable, setFont, setHighlightable, setHorizontalScrollBarPolicy, setText

Methods inherited from class dip.gui.dialog.HeaderDialog

addSingleButton, addToButtonPanel, addTwoButtons, close, createDefaultContentBorder, getButton, getContentPane, getDefaultButton, getReturnedActionCommand, isCloseOrCancel, isOKorAccept, makeAcceptButton, makeButton, makeCancelButton, makeCloseButton, makeGlue, makeOKButton, makeSpacer, setContentPane, setDefaultButton, setDefaultCloseButton, setHeaderText, setHeaderVisible, setSeparatorVisible

Methods inherited from class dip.gui.dialog.XDialog

createRootPane, dialogInit, setDefaultCloseOperation, setHelpID

Methods inherited from class javax.swing.JDialog

addImpl, getAccessibleContext, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update

Methods inherited from class java.awt.Dialog

addNotify, dispose, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationRelativeTo, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setFocusTraversalKeys, setFocusTraversalPolicy, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.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, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, 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, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

displaySerious

public static void displaySerious(javax.swing.JFrame parent,
                                  java.lang.Throwable e)

This should be used whenever a SERIOUS error occurs.

A Serious error is defined as an error from which may be irrecoverable, but gives the user a chance to continue working in the program if possible. The user may also quit the program from this dialog.

displayFatal

public static void displayFatal(javax.swing.JFrame parent,
                                java.lang.Throwable e)

This should be used whenever a FATAL error occurs.

A Fatal error is defined as an error from which recovery is impossible. The only option is to exit the program, with error code 1.

displayFileIO

public static void displayFileIO(javax.swing.JFrame parent,
                                 java.lang.Exception e,
                                 java.lang.String fileName)

This should be used whenever a FILE error occurs.

A File error is any error (not nescessarily an IOException) that occurs when reading, writing, or processing a file.

Special handling exists FileNotFoundException, which is common and not a program issue.

displayNetIO

public static void displayNetIO(javax.swing.JFrame parent,
                                java.io.IOException e,
                                java.lang.String connection)

This should be used whenever a NETWORK error occurs.

Network errors are all assumed to be IOException instances or subclasses. The connection parameter may be null, or, if specified, the connection text (URL or IP address, for example).

Special handling exists for an UnknownHostException.

displayGeneral

public static void displayGeneral(javax.swing.JFrame parent,
                                  java.lang.Exception e)

This should be used whenever a GENERAL error occurs.

A General error is an error that does not fit any of the other categories.

displayVariantVersionMismatch

public static void displayVariantVersionMismatch(javax.swing.JFrame parent,
                                                 World.VariantInfo vi,
                                                 float availableVersion)

This should be used whenever there is a Variant version mismatch.

displayVariantNotAvailable

public static void displayVariantNotAvailable(javax.swing.JFrame parent,
                                              World.VariantInfo vi)

This should be used whenever a Variant is not available.