Class NetPhantomStarter

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Panel

NetPhantomStarter

All Implemented Interfaces:

ActionListener, KeyListener, MouseListener, WindowListener, ImageObserver, MenuContainer, Serializable, Runnable, EventListener, Accessible, AuthCB

Direct Known Subclasses:

NetPhantomStarterSSL

public class NetPhantomStarter
extends Panel
implements ActionListener, WindowListener, KeyListener, MouseListener, Runnable, AuthCB

The program to launch the client after checking of newer available versions on the server. This program can also update itself prior to the launch.

See Also:

Serialized Form

Nested Class Summary

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

Panel.AccessibleAWTPanel

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected Auth	auth The authenticator.
protected URL	baseUrl The base URL of the package file.
protected static String	httpString The HTTP string.
protected static String	prgmName
protected static String	sslClass SSL added string for class name.
protected static String	sslClass2 SSL added string for class name #2.
protected static Color	standardBackgroundColor Defining dialog background color

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, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
NetPhantomStarter()

Method Summary

Methods

Modifier and Type	Method and Description
void	actionPerformed(ActionEvent e) Performs action requested by the selection of a push button.
protected String[]	addClientArguments(String[] arg) This method adds starting arguments for the Client such as client certificate file name and password, accepted CA certificate.
protected void	addMessage(String text) Adds a message to the message list.
protected String[]	addStarterArguments(String[] arg) This method adds starting arguments for the Starter such as client certificate file name and password, accepted CA certificate.
protected Window	displayDialog(Window owner, String title, Component[] comps, String[] buttons) Displays a generic dialog box.
protected static void	displayVersion(String text) Display program information.
protected void	disposeDialog(Window dlg) Disposes of the dialog box.
String[]	getAuth(boolean usesSSL, boolean isProxy, String serverName, String scheme, String realm, String resource, String userID, String password) Requests a password.
protected boolean	initSSL() Initializes SSL: does nothing.
void	keyPressed(KeyEvent e)
void	keyReleased(KeyEvent e)
void	keyTyped(KeyEvent e)
static void	main(String[] arg) This method starts execution of the Starter.
protected void	messageBox(String msg) Displays an error message.
protected void	messageBox(String title, String msg) Displays an error message.
protected int	messageBox(String title, String[] msg, int count, String[] buttons) Displays an error message.
protected int	messageBox(String title, String[] msg, String[] buttons) Displays an error message.
void	mouseClicked(MouseEvent e)
void	mouseEntered(MouseEvent e)
void	mouseExited(MouseEvent e)
void	mousePressed(MouseEvent e)
void	mouseReleased(MouseEvent e)
void	paint(Graphics g)
protected int	processDialog(Window dlg) Processes the dialog box for user input.
void	run()
protected void	runProgram(String[] arg) Runs the program.
void	windowActivated(WindowEvent e)
void	windowClosed(WindowEvent e)
void	windowClosing(WindowEvent e) Window is closed.
void	windowDeactivated(WindowEvent e)
void	windowDeiconified(WindowEvent e)
void	windowIconified(WindowEvent e)
void	windowOpened(WindowEvent e)
protected String[]	wrapStrings(String[] msgs) Scans an array of strings and returns a possibly longer array because the string lengths were too long.

Methods inherited from class java.awt.Panel

addNotify, getAccessibleContext

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, 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, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

httpString

protected static String httpString

The HTTP string.

sslClass

protected static String sslClass

SSL added string for class name.

sslClass2

protected static String sslClass2

SSL added string for class name #2.

prgmName

protected static String prgmName

standardBackgroundColor

protected static final Color standardBackgroundColor

Defining dialog background color

baseUrl

protected URL baseUrl

The base URL of the package file.

auth

protected Auth auth

The authenticator.

Constructor Detail

NetPhantomStarter

public NetPhantomStarter()

Method Detail

main

public static void main(String[] arg)

This method starts execution of the Starter.

The program can be started with optional parameters, some of which consists of a switch followed by one or more values. The switch must be preceded by a '-' (dash) or a '/' (forward slash). The switch can be given in upper or lower case.

The following parameters are accepted:

   baseURL
   -C startClass
   -A arg1 [arg2 [argN]]
 

where:

• baseURL is the URL to the local properties file.
• strartClass means the class to be started by the starter. This will normally be se.entra.phantom.client.Phantom.
• The argX parameters are any parameters to be passed on to the startClass.

Parameters:

arg - Any command line parameters.

displayVersion

protected static void displayVersion(String text)

Display program information.

runProgram

protected void runProgram(String[] arg)

Runs the program.

Parameters:

arg - All the arguments from the command line, passed on by the main method.

initSSL

protected boolean initSSL()

Initializes SSL: does nothing.

addClientArguments

protected String[] addClientArguments(String[] arg)

This method adds starting arguments for the Client such as client certificate file name and password, accepted CA certificate. If this method is overridden, it must call super.addStartArguments(arg) before returning, in case of future enhancements in the non-SSL version.

addStarterArguments

protected String[] addStarterArguments(String[] arg)

This method adds starting arguments for the Starter such as client certificate file name and password, accepted CA certificate. If this method is overridden, it must call super.addStartArguments(arg) before returning, in case of future enhancements in the non-SSL version.

paint

public void paint(Graphics g)

Overrides:

paint in class Container

run

public void run()

Specified by:

run in interface Runnable

actionPerformed

public void actionPerformed(ActionEvent e)

Performs action requested by the selection of a push button.

Specified by:

actionPerformed in interface ActionListener

Parameters:

e - The action event.

windowClosing

public void windowClosing(WindowEvent e)

Window is closed.

Specified by:

windowClosing in interface WindowListener

windowOpened

public void windowOpened(WindowEvent e)

Specified by:

windowOpened in interface WindowListener

windowClosed

public void windowClosed(WindowEvent e)

Specified by:

windowClosed in interface WindowListener

windowActivated

public void windowActivated(WindowEvent e)

Specified by:

windowActivated in interface WindowListener

windowDeactivated

public void windowDeactivated(WindowEvent e)

Specified by:

windowDeactivated in interface WindowListener

windowIconified

public void windowIconified(WindowEvent e)

Specified by:

windowIconified in interface WindowListener

windowDeiconified

public void windowDeiconified(WindowEvent e)

Specified by:

windowDeiconified in interface WindowListener

keyTyped

public void keyTyped(KeyEvent e)

Specified by:

keyTyped in interface KeyListener

keyPressed

public void keyPressed(KeyEvent e)

Specified by:

keyPressed in interface KeyListener

keyReleased

public void keyReleased(KeyEvent e)

Specified by:

keyReleased in interface KeyListener

mouseClicked

public void mouseClicked(MouseEvent e)

Specified by:

mouseClicked in interface MouseListener

mouseEntered

public void mouseEntered(MouseEvent e)

Specified by:

mouseEntered in interface MouseListener

mouseExited

public void mouseExited(MouseEvent e)

Specified by:

mouseExited in interface MouseListener

mousePressed

public void mousePressed(MouseEvent e)

Specified by:

mousePressed in interface MouseListener

mouseReleased

public void mouseReleased(MouseEvent e)

Specified by:

mouseReleased in interface MouseListener

addMessage

protected void addMessage(String text)

Adds a message to the message list.

Parameters:

text - The new message.

wrapStrings

protected String[] wrapStrings(String[] msgs)

Scans an array of strings and returns a possibly longer array because the string lengths were too long.

messageBox

protected void messageBox(String msg)

Displays an error message.

messageBox

protected void messageBox(String title,
              String msg)

Displays an error message. If the title is null, the program name is used.

messageBox

protected int messageBox(String title,
             String[] msg,
             String[] buttons)

Displays an error message. If the title is null, the program name is used.

Returns:

the button index that activated the message or -1 for cancel.

messageBox

protected int messageBox(String title,
             String[] msg,
             int count,
             String[] buttons)

Displays an error message. If the title is null, the program name is used.

Returns:

the button index that activated the message or -1 for cancel.

displayDialog

protected Window displayDialog(Window owner,
                   String title,
                   Component[] comps,
                   String[] buttons)

Displays a generic dialog box. If the title is null, the program name is used.

processDialog

protected int processDialog(Window dlg)

Processes the dialog box for user input.

disposeDialog

protected void disposeDialog(Window dlg)

Disposes of the dialog box.

getAuth

public String[] getAuth(boolean usesSSL,
               boolean isProxy,
               String serverName,
               String scheme,
               String realm,
               String resource,
               String userID,
               String password)

Requests a password.

The following parameters indicates how the process is handled:

• Certificate:

           server   = null,
           realm    = null,
           resource = certificateFileName
       

• Basic authentication:

           server   = protocol://serverName[:port],
           realm    = null,
           resource = null
       

• Digest authentication:

           server   = protocol://serverName[:port],
           realm    = realmString,
           resource = null
       

The parameters "userID" and "password" are set to null if no previous data is present, otherwise the previous userID (always null for certificate files) and the previous password.

Specified by:

getAuth in interface AuthCB

Returns:

null no userID/password is specified (cancel was pressed. String [2] String[0]=userID, String[1]=password, for certificate files, userID is null.