jas2.util

Class Application

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

jas2.util.Application

All Implemented Interfaces:

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

Direct Known Subclasses:

JavaAnalysisStudio

public abstract class Application
extends javax.swing.JPanel

This class is meant to provide access from all packages to certain general-purpose items of the application, such as the UserProperties objects that the application uses, and the JFrame that the application is in. It allows classes from all packages to show help topics. However, getting the actual topics themselves is the responsibility of a class which subclasses Application.

See Also:

UserProperties, JFrame, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.BaselineResizeBehavior

Field Summary

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
Application() Creates an instance of the Application.

Method Summary

Modifier and Type	Method and Description
void	addHelpLocation(java.lang.Class base, java.lang.String s) Add a Help location to the Vector of locations to look in for the helpset.
void	addHelpLocation(java.lang.String s)
void	addHelpLocation(java.net.URL url)
void	error(java.lang.String s) Parents an error box to the application's frame.
void	error(java.lang.String s, java.lang.String helpTopic) Parents an error box to the application's frame, and contains a button that opens a given help page.
void	error(java.lang.String s, java.lang.Throwable t) Parents an error box to the application's frame and displays a Throwable object's stack trace.
void	error(java.lang.String s, java.lang.Throwable t, java.lang.String helpTopic) Parents an error box to the application's frame, displays a Throwable object's stace trace, and contains a button that opens a given help page.
static Application	getApplication() Returns the application.
CommandTargetManager	getCommandManager()
javax.swing.JFrame	getFrame() Returns the parent JFrame.
GetOptions	getGetOptions() Get the GetOptions object that will be used to parse the command line arguments
UserProperties	getUserProperties() Returns the UserProperties object.
void	showHelpContents() Shows the table of contents for the help system.
void	showHelpIndex() Shows the index for the help system.
void	showHelpSearch() Opens a search window for the help system.
void	showHelpTopic(java.lang.String helpTopicTarget)
void	showHelpTopic(java.lang.String helpTopicTarget, java.awt.Window owner) Shows the specified JavaHelp topic with the TOC visible

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

Application

public Application()

Creates an instance of the Application. This constructor may only be called once in an application.

Method Detail

addHelpLocation

public void addHelpLocation(java.lang.Class base,
                            java.lang.String s)

Add a Help location to the Vector of locations to look in for the helpset. At the time of writing, this was a one-element Vector, but we're being flexible :-)

addHelpLocation

public void addHelpLocation(java.net.URL url)

addHelpLocation

public void addHelpLocation(java.lang.String s)

getApplication

public static final Application getApplication()

Returns the application.

getUserProperties

public final UserProperties getUserProperties()

Returns the UserProperties object.

getFrame

public final javax.swing.JFrame getFrame()

Returns the parent JFrame.

See Also:

JFrame

showHelpContents

public final void showHelpContents()

Shows the table of contents for the help system.

showHelpIndex

public final void showHelpIndex()

Shows the index for the help system.

showHelpSearch

public final void showHelpSearch()

Opens a search window for the help system.

error

public final void error(java.lang.String s,
                        java.lang.Throwable t)

Parents an error box to the application's frame and displays a Throwable object's stack trace.

Parameters:

s - an error message

t - the Exception or Error that caused the error

See Also:

ErrorBox

error

public final void error(java.lang.String s)

Parents an error box to the application's frame.

Parameters:

s - an error message

See Also:

ErrorBox

error

public final void error(java.lang.String s,
                        java.lang.Throwable t,
                        java.lang.String helpTopic)

Parents an error box to the application's frame, displays a Throwable object's stace trace, and contains a button that opens a given help page.

Parameters:

s - an error message

t - the Exception or Error that caused the error

helpTopic - the topic you want to link to

See Also:

ErrorBox

error

public final void error(java.lang.String s,
                        java.lang.String helpTopic)

Parents an error box to the application's frame, and contains a button that opens a given help page.

Parameters:

s - an error message

helpTopic - the topic you want to link to

See Also:

ErrorBox

showHelpTopic

public final void showHelpTopic(java.lang.String helpTopicTarget)

showHelpTopic

public final void showHelpTopic(java.lang.String helpTopicTarget,
                                java.awt.Window owner)

Shows the specified JavaHelp topic with the TOC visible

Parameters:

helpTopicTarget - the JavaHelp XML target name which maps to the .html page in the map file

getGetOptions

public GetOptions getGetOptions()

Get the GetOptions object that will be used to parse the command line arguments

getCommandManager

public CommandTargetManager getCommandManager()