All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.install.panels.ProgressPanel

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Panel
                           |
                           +----com.sun.wizards.core.WizardComponent
                                   |
                                   +----com.sun.wizards.core.WizardLeaf
                                           |
                                           +----com.sun.install.panels.ProgressPanel

public class ProgressPanel
extends WizardLeaf
ProgressPanel displays progress bars for products that are installing. The labels come from the WizardState, set there at buildtime and retrieved at runtime. If you are installing multiple products (as opposed to multiple *components* of a *single* product), you will get a progress bar for each product, as well as an overall progress bar indicating the completeness of the entire install.

Here is a sample ProgressPanel installing 1 product: Graphic of a ProgressPanel

The code to create this panel is:

wizardState.setPurpose("install"); Vector msgs = new Vector(); msgs.addElement(new Msg("Installing Webstart Wizards SDK")); wizardState.setData("progressLabels", msgs); wizardState.setProgressLabel("install", new Msg("Installing Webstart Wizards SDK")); ProgressPanel samplePanel = new ProgressPanel(wizardState, "SampleName", "progressLabels");

Each product wizard state on the client side should set its progress label using setProgressLabel(String, Msg).


Variable Index

 o multiplier
Scales the progress bar in CLI mode
 o progressKey
The progress key is used to request labels from the server for each of the progress bars that are to appear on this panel. Deprecated.
 o progressManager
The ProgressManager object manages the progress bar(s). Deprecated.
 o progressVisual
The ProgressVisual object that is to be displayed on the progress panel. Deprecated.
 o sequenceIsComplete
local status for when sequence is complete Deprecated.
 o shouldPerform
This flag indicates whether the sequence should be performed or reversed. Deprecated.
 o STOPPED
Flag indicating the progress panels have stopped
 o ttyNum
Which progress result to use for display TTY progress.

Constructor Index

 o ProgressPanel()
Creates a ProgressPanel with a route to the root of the server object tree.
 o ProgressPanel(String, Route, WizardTreeManager)
Creates a ProgressPanel with the specified name, the specified route and wizard manager.
 o ProgressPanel(WizardState, String, String)
Creates a ProgressPanel with the specified name.

Method Index

 o abortDisplay()
This method is called when this ProgressPanel is being displayed, and the user presses the "cancel" button.
 o addRuntimeResources(Vector)
Get the runtime classes required by this panel.
 o beginDisplay()
This method is called when the ProgressPanel is displayed.
 o cancel()
Cancel has occured.
 o consoleInteraction()
Shows the progress bar in CLI mode
 o createUI()
This method creates the user interface.
 o deserialize(DataInput)
Deserialize this WizardComponent from the specified input stream.
 o getButtonMask()
Returns information suggesting which buttons should be displayed for this panel.
 o getProgressVisual()
Get the ProgressVisual object for this ProgressPanel.
 o isDisplayComplete()
Returns true if this WizardComponent is finished displaying.
 o sequenceComplete()
This is the callback method passed in to the performSequence call.
 o serialize(DataOutput)
Serialize this WizardComponent to the specified output stream.
 o setLabel(String)
 o setProgress(int[])
Set the progress to the specified values.
 o setReverse()
Set this panel to reverse the sequence rather than perform it.
 o setVisual(ProgressVisual)
Set the ProgressVisual object for the progress panel.

Variables

 o STOPPED
 public static final int STOPPED
Flag indicating the progress panels have stopped

 o ttyNum
 protected int ttyNum
Which progress result to use for display TTY progress.

 o multiplier
 protected double multiplier
Scales the progress bar in CLI mode

 o progressKey
 protected String progressKey
Note: progressKey is deprecated.

The progress key is used to request labels from the server for each of the progress bars that are to appear on this panel.

 o shouldPerform
 protected boolean shouldPerform
Note: shouldPerform is deprecated.

This flag indicates whether the sequence should be performed or reversed.

 o progressManager
 protected ProgressManager progressManager
Note: progressManager is deprecated.

The ProgressManager object manages the progress bar(s).

 o progressVisual
 protected ProgressVisual progressVisual
Note: progressVisual is deprecated.

The ProgressVisual object that is to be displayed on the progress panel.

 o sequenceIsComplete
 protected boolean sequenceIsComplete
Note: sequenceIsComplete is deprecated.

local status for when sequence is complete

Constructors

 o ProgressPanel
 public ProgressPanel()
Creates a ProgressPanel with a route to the root of the server object tree.

 o ProgressPanel
 public ProgressPanel(WizardState wizardState,
                      String name,
                      String progressKey)
Creates a ProgressPanel with the specified name.

Parameters:
wizardState - The buildtime WizardState.
name - The name for this ProgressPanel.
progressKey - The key used to request the progress labels from the WizardState.
 o ProgressPanel
 public ProgressPanel(String name,
                      Route route,
                      WizardTreeManager wizardManager)
Creates a ProgressPanel with the specified name, the specified route and wizard manager.

Parameters:
name - The name for this ProgressPanel.
route - The route to the appropriate server side object.
wizardManager - The wizardManager responsible for this component.

Methods

 o setReverse
 public void setReverse()
Set this panel to reverse the sequence rather than perform it.

 o setVisual
 public void setVisual(ProgressVisual progressVisual)
Set the ProgressVisual object for the progress panel.

Parameters:
progressVisual - The ProgressVisual to use for this panel
 o getProgressVisual
 public ProgressVisual getProgressVisual()
Get the ProgressVisual object for this ProgressPanel.

Returns:
The ProgressVisual object associated with this panel.
 o consoleInteraction
 public void consoleInteraction()
Shows the progress bar in CLI mode

Overrides:
consoleInteraction in class WizardComponent
 o isDisplayComplete
 public boolean isDisplayComplete()
Returns true if this WizardComponent is finished displaying.

Overrides:
isDisplayComplete in class WizardComponent
 o beginDisplay
 public void beginDisplay()
This method is called when the ProgressPanel is displayed. ProgressPanel overrides this method to perform the sequence named "InstallSequence".

Overrides:
beginDisplay in class WizardComponent
 o abortDisplay
 public void abortDisplay()
This method is called when this ProgressPanel is being displayed, and the user presses the "cancel" button. This method provides an opportunity for this WizardComponent to do any required cleanup.

Overrides:
abortDisplay in class WizardComponent
 o cancel
 public WizardComponent cancel()
Cancel has occured. Stay on this panel (by returning its own id). The progress panel's sequence will complete after its reversed any partially done operations.

Overrides:
cancel in class WizardComponent
 o createUI
 public void createUI()
This method creates the user interface.

Overrides:
createUI in class WizardLeaf
 o setProgress
 public void setProgress(int progress[])
Set the progress to the specified values.

Parameters:
progress - An array specifying progress.
 o setLabel
 public void setLabel(String label)
 o sequenceComplete
 public void sequenceComplete()
This is the callback method passed in to the performSequence call. This callback will be called when the sequence has completed.

 o getButtonMask
 public int getButtonMask()
Returns information suggesting which buttons should be displayed for this panel. The progress panel should not have navigation buttons.

Returns:
A button mask identifying valid navigation buttons.
Overrides:
getButtonMask in class WizardLeaf
 o serialize
 protected void serialize(DataOutput out)
Serialize this WizardComponent to the specified output stream. This method does not save its children.

Parameters:
out - The output stream to which this WizardComponent will be serialized.
Overrides:
serialize in class WizardComponent
See Also:
serializeChildren
 o deserialize
 protected void deserialize(DataInput in)
Deserialize this WizardComponent from the specified input stream. This method does not deserialize its children.

Parameters:
in - The input stream from which this WizardComponent will be deserialized.
Overrides:
deserialize in class WizardComponent
See Also:
deserializeChildren
 o addRuntimeResources
 public void addRuntimeResources(Vector resourceVector)
Get the runtime classes required by this panel.

Parameters:
resourceVector - The vector containing all runtime resources for this wizard.
Overrides:
addRuntimeResources in class WizardLeaf

All Packages  Class Hierarchy  This Package  Previous  Next  Index