gov.virginia.dcjs.gui
Class ApplicationPanel

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  gov.virginia.dcjs.gui.DCJSPanel
                      gov.virginia.dcjs.gui.ArbitratorPanel
                          gov.virginia.dcjs.gui.ApplicationPanel

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

public class ApplicationPanel

extends ArbitratorPanel

This class manages two gui panel objects, a ButtonPanel * and a GridPanel. Either child panel has the option of * letting this class handle events from their components. * Communication back to the server is via the provided reference to a * ApplicationClient. *

* Note: The following button names will have the associated * actions

*
• Obtain a sublist
  *
  • Child *
  • List *
  • Related *
  *
• Add a new row
  *
  • Add *
  • New *
  • Blank *
  *
• Edit an existing row
  *
  • Edit *
  • Modify *
  • Change *
  • Fix *
  • View *
  *
• Save a new or updated row
  *
  • Save *
  • Update *
  • Commit *
  • Keep *
  • Store *
  • OK *
  *
• Delete an existing row
  *
  • Delete *
  • Remove *
  • Obliterate *
  • Erase *
  • Clear *
  *
• Print the contents being displayed
  *
  • Print
  *
  • Hardcopy
  *
  *
• Cancel any new entries
  *
  • Cancel *
  • Quit *
  • Later *
  • Bye *
  *
• Application specific custom action *
  None of the above - subclasses will need to override * in order to handle such specifically *

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

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 gov.virginia.dcjs.gui.ArbitratorPanel

BOTTOM, LEFT, RIGHT, TOP

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, 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

ApplicationPanel()

ApplicationPanel(ApplicationClient client)

ApplicationPanel(ButtonPanel bp, GridPanel gp)

ApplicationPanel(ButtonPanel bp, GridPanel gp, ApplicationClient client)

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e) Button and Grid panel event handler option.
void	addRowAction() Add a row to the database.
void	alert(java.lang.String msg) Display an informational dialog to the user * @param msg Message to be presented to user
void	alert(java.lang.String msg, java.lang.String title) Pop up a message to the user * @param msg Message to present to user * @param title Dialog title
protected void	buildPanel() Builds and initializes the gui for use
void	cancelRowAction() Subclasses override this method to cancel an add or edit.
void	customRowAction() Subclasses override this method to perform some custom action * upon a row of data
void	deleteRowAction() Delete a row from the database.
void	editRowAction() Edit a row in the database.
ButtonPanel	getButtonPanel() Obtain the button panel being managed * @return Button panel being managed by this class
ApplicationClient	getClient() Obtain the ApplicationClient handling * communication back to server * @return ApplicationClient handling * communication back to server
GridPanel	getGridPanel() Obtain the GridPanel subclass being managed * @return Grid panel subclass being managed
Relation	getRowSource(int code) Obtain the row source Relation from the * ApplicationClient for the list or combo box on * the GridPanel object being managed.
protected void	postAction(boolean successful)
void	saveRowAction() Save a row to the database.
void	setClient(ApplicationClient client) Provide the ApplicationClient handling * communication back to server * @param client ApplicationClient handling * communication back to server
void	sublistAction() Obtain a sublist from the database.

Methods inherited from class gov.virginia.dcjs.gui.ArbitratorPanel

addTitle, getAgentPanel, getSplitPane, repaint, resizePanels, setPanels

Methods inherited from class gov.virginia.dcjs.gui.DCJSPanel

addTitle, addTitle, addTitle, getTitle, setPanelColor, setTextColor, setTitle

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, 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, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

ApplicationPanel

public ApplicationPanel()

ApplicationPanel

public ApplicationPanel(ApplicationClient client)

Parameters:

client - ApplicationClient handling * communication back to server

ApplicationPanel

public ApplicationPanel(ButtonPanel bp,
                        GridPanel gp)

Parameters:

bp - Buttons for this class to manage * @param gp GridPanel subclass to manage

ApplicationPanel

public ApplicationPanel(ButtonPanel bp,
                        GridPanel gp,
                        ApplicationClient client)

Parameters:

bp - Buttons for this class to manage * @param gp GridPanel subclass to manage * @param client ApplicationClient handling * communication back to server

Method Detail

buildPanel

protected void buildPanel()

Builds and initializes the gui for use

Overrides:

buildPanel in class ArbitratorPanel

getButtonPanel

public ButtonPanel getButtonPanel()

Obtain the button panel being managed * @return Button panel being managed by this class

getGridPanel

public GridPanel getGridPanel()

Obtain the GridPanel subclass being managed * @return Grid panel subclass being managed

getClient

public ApplicationClient getClient()

Obtain the ApplicationClient handling * communication back to server * @return ApplicationClient handling * communication back to server

setClient

public void setClient(ApplicationClient client)

Provide the ApplicationClient handling * communication back to server * @param client ApplicationClient handling * communication back to server

alert

public void alert(java.lang.String msg)

Display an informational dialog to the user * @param msg Message to be presented to user

alert

public void alert(java.lang.String msg,
                  java.lang.String title)

Pop up a message to the user * @param msg Message to present to user * @param title Dialog title

getRowSource

public Relation getRowSource(int code)

Obtain the row source Relation from the * ApplicationClient for the list or combo box on * the GridPanel object being managed. * Subclasses may override this method to provide the desired * row source data for list/combo box controls. * @param code Identifier for the desired row source * @return Row source for a list or combo box within a * GridPanel

sublistAction

public void sublistAction()

Obtain a sublist from the database. Subclasses should not * override, but if overridden, call super.sublistAction() * last.

addRowAction

public void addRowAction()

Add a row to the database. Subclasses should not override, * but if overridden, call super.addRowAction() last.

editRowAction

public void editRowAction()

Edit a row in the database. Subclasses should not override, * but if overridden, call super.editRowAction() last.

saveRowAction

public void saveRowAction()

Save a row to the database. Subclasses should not override, * but if overridden, call super.saveRowAction() last.

deleteRowAction

public void deleteRowAction()

Delete a row from the database. Subclasses should not * override, but if overridden, call super.deleteRowAction() * last.

cancelRowAction

public void cancelRowAction()

Subclasses override this method to cancel an add or edit.

customRowAction

public void customRowAction()

Subclasses override this method to perform some custom action * upon a row of data

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Button and Grid panel event handler option. Must be overridden * by subclass to handle application specific events.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Overrides:

actionPerformed in class ArbitratorPanel

postAction

protected void postAction(boolean successful)