All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.install.nodes.CustomNode

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Panel
                           |
                           +----com.sun.wizards.core.WizardComponent
                                   |
                                   +----com.sun.wizards.core.WizardComposite
                                           |
                                           +----com.sun.wizards.nodes.SkipNode
                                                   |
                                                   +----com.sun.install.nodes.CustomNode

public class CustomNode
extends SkipNode
The CustomNode is used for adding "customize" subtrees to a higher level install. For example, in a CD installation layout, you will have an installer for each product on the CD (a product-level installer) as well as a CD-level installer that connects the installation programs together. The CustomNode is used in the CD-level installer for extracting the custom subtrees from the product-level installers.

In order to connect multiple wizard archives at runtime, they must be specified at buildtime using a relative path from the CD-level archive using the addChild() method of the root Wizard state at buildtime. The InstallArchiveWriter class can do this for you via the addWizard() method. The relative path you specify at buildtime is searched at runtime to find the wizard.

During initialization, the product-level wizard archives are located and connected to the main archive if they are found. The subtrees in the secondary archive must bear the same name as this custom node if it is to be attached as a child of this node. In addition, the subtree must be a child of the root of the child client panel in order for it to be found.

At runtime, the secondary archive is located and decompressed. It is then available to the wizard system as a child of the primary archive. Finally, when this CustomNode is encountered, it will then attach the client-side subtree from the secondary archive to the primary tree, and advance into the newly-added subtree.

Read the Web Start SDK User's Guide for more information about creating a hierarchical installation.

See Also:
addWizard, addChild

Constructor Index

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

Method Index

 o addRuntimeResources(Vector)
Set the runtime classes required by this panel.
 o setCustomProducts(Vector)
Set the list of custom products.

Constructors

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

 o CustomNode
 public CustomNode(WizardState wizardState,
                   String name,
                   String skipKey)
Creates a CustomNode with the specified wizard state and name. This name is also used to access the subtrees of the child wizard archives when this CustomNode is encountered at runtime.

Parameters:
wizardState - The buildtime WizardState.
name - The name for this CustomNode.
skipKey - The key to reference when deciding whether this CustomNode should be skipped in the tree traversal.
 o CustomNode
 public CustomNode(String name,
                   Route route,
                   WizardTreeManager wizardManager)
Creates a CustomNode with the specified name, the specified route and wizard manager. This name is also used to access the subtrees of the child wizard archives when this CustomNode is encountered at runtime.

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

Methods

 o setCustomProducts
 public void setCustomProducts(Vector customProducts)
Set the list of custom products. The list should contain routes to the wizard states that are to be customized. This is used at runtime to determine which child subtrees to fetch and attach to this tree. Before this is done, however, the old subtrees are removed (but still reside in a cache).

Parameters:
customProducts - Routes to the states that are to be customized.
 o addRuntimeResources
 public void addRuntimeResources(Vector resourceVector)
Set the runtime classes required by this panel.

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

All Packages  Class Hierarchy  This Package  Previous  Next  Index