uk.ac.starlink.util.gui
Class ProxySetupFrame

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Window
              extended by java.awt.Frame
                  extended by javax.swing.JFrame
                      extended by uk.ac.starlink.util.gui.ProxySetupFrame
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class ProxySetupFrame
extends JFrame

Create a dialog window for displaying and modifying the current proxy server configuration as found in a backing store.

This is basically an interface to changes the values of the system properties:

A typical invocation would follow the sequence:
     ProxySetupFrame.restore( null );
     ...
     ProxySetupFrame frame = new ProxySetupFrame();
 
Which would restore the backing store configuration first and then create a dialog to change or view it. Typically the restoration would occur in an network aware applications startup code (i.e. well before the creation of the frame itself).

Version:
$Id$
Author:
Peter W. Draper
See Also:
Serialized Form

Nested Class Summary
protected  class ProxySetupFrame.AcceptAction
          Inner class defining Action for closing window and keeping changes.
protected  class ProxySetupFrame.CancelAction
          Inner class defining Action for closing window and discarding changes.
 
Nested classes/interfaces inherited from class javax.swing.JFrame
JFrame.AccessibleJFrame
 
Nested classes/interfaces inherited from class java.awt.Frame
Frame.AccessibleAWTFrame
 
Nested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow
 
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
protected  JButton acceptButton
           
protected  JButton cancelButton
           
protected  JMenuItem closeFileMenu
           
protected  JMenu fileMenu
           
protected  JTextField hostName
           
protected  JMenuBar menuBar
          Menubar and various menus and items that it contains.
protected  JCheckBox needProxy
          Other UI elements
protected  JTextField nonHostNames
           
protected  JTextField portNumber
           
 
Fields inherited from class javax.swing.JFrame
accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Frame
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR
 
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, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
ProxySetupFrame()
          Create an instance.
 
Method Summary
protected  void checkEntryStates()
          Check the entry states for the proxy hostname and port.
protected  void closeWindowEvent(boolean accept)
          Close the window by withdrawing it.
protected  void initFrame()
          Initialise frame properties (disposal, menus etc.).
protected  void initMenus()
          Initialise the menu bar and related actions.
protected  void initUI()
          Initialise the main part of the user interface.
protected  void matchToInterface()
          Match the system properties to the state of interface.
protected  void matchToProperties()
          Match interface to the current state of the system properties.
static void restore(ProxySetupFrame target)
          Restore from backing store, updating the system properties.
static void store(ProxySetupFrame target)
          Save state of system properties to backing store.
 
Methods inherited from class javax.swing.JFrame
addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update
 
Methods inherited from class java.awt.Frame
addNotify, finalize, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, show, 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, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, firePropertyChange, firePropertyChange, firePropertyChange, 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, getMousePosition, 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, isMaximumSizeSet, isMinimumSizeSet, isOpaque, 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, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.awt.MenuContainer
getFont, postEvent
 

Field Detail

menuBar

protected JMenuBar menuBar
Menubar and various menus and items that it contains.


fileMenu

protected JMenu fileMenu

closeFileMenu

protected JMenuItem closeFileMenu

needProxy

protected JCheckBox needProxy
Other UI elements


hostName

protected JTextField hostName

portNumber

protected JTextField portNumber

nonHostNames

protected JTextField nonHostNames

acceptButton

protected JButton acceptButton

cancelButton

protected JButton cancelButton
Constructor Detail

ProxySetupFrame

public ProxySetupFrame()
Create an instance.

Method Detail

initUI

protected void initUI()
Initialise the main part of the user interface.


initFrame

protected void initFrame()
Initialise frame properties (disposal, menus etc.).


initMenus

protected void initMenus()
Initialise the menu bar and related actions.


matchToProperties

protected void matchToProperties()
Match interface to the current state of the system properties.


matchToInterface

protected void matchToInterface()
Match the system properties to the state of interface.


checkEntryStates

protected void checkEntryStates()
Check the entry states for the proxy hostname and port. These are enabled when a proxy is required and disabled when not.


closeWindowEvent

protected void closeWindowEvent(boolean accept)
Close the window by withdrawing it.

Parameters:
accept - if true then the system global properties are matched to those of the interface. Otherwise the interface is modified to match the system properties (thus "accepting" or "cancelling" modifications to the proxy).

restore

public static void restore(ProxySetupFrame target)
Restore from backing store, updating the system properties.

Parameters:
target - if not null, then this should be a ProxySetupFrame that will be initialise to match the state of the backing store contents.

store

public static void store(ProxySetupFrame target)
Save state of system properties to backing store.

Parameters:
target - if not null, then this should be a ProxySetupFrame that has a setup that should be used in preference to the system properties. Note that after this method the system properties will be modified to reflect the stored state.


Copyright © 2015 Central Laboratory of the Research Councils. All Rights Reserved.