com.sapportals.admin.wizardframework.components
Class WizardComponentContainer

java.lang.Object
  |
  +--com.sapportals.admin.wizardframework.components.AbstractWizardComponent
        |
        +--com.sapportals.admin.wizardframework.components.WizardComponentContainer

All Implemented Interfaces:

IDependencyObject, IWizardComponent, IWizardComponentContainer

public class WizardComponentContainer

extends AbstractWizardComponent

implements IWizardComponentContainer

Version:

6.0 This wizard component can contain other wizard components. It will execute enclosed components in the correct order. if component a was added to a container before component b the container shall call a.init(), b.init(), a.doBeforeDisplay(), b.doBeforeDisplay...

Field Summary

protected java.util.Hashtable	components
static int	HORIZONTAL_LAYOUT
static int	VERTICAL_LAYOUT

Constructor Summary

WizardComponentContainer()
sorry, no detailed documentation yet

WizardComponentContainer(int iLayout)
sorry, no detailed documentation yet

WizardComponentContainer(int iLayout, int iPadding)
sorry, no detailed documentation yet

Method Summary

void	addComponent(java.lang.String key, com.sapportals.htmlb.Component component)
void	addComponent(java.lang.String key, IWizardComponent component)
void	addComponent(java.lang.String key, IWizardComponent component, boolean isMandatoryField)
void	clearIfInconsistent(java.lang.String changedObjectKey, IWizardContext context) the default implementtion clears all values from this component's branch in the session.
void	doAfterSubmit(IWizardContext context) the default implemention does nothing
void	doBeforeDisplay(IWizardContext context) the default implemention does nothing before display
IWizardComponent	getComponent(java.lang.String key) get a (sub)component from this container
com.sapportals.htmlb.Component	getDisplay(IWizardContext context) the default implementation returns null - if your component has a display it should inherit AbstractDisplayComponent or AbstractInputComponent.
java.util.List	getErrorMessages(IWizardContext context) the default implemention returns null
java.lang.String	getPath() get the path of this component (internally used)
void	init(IWizardContext context) the default implemention does nothing on init
boolean	isInitialized(IWizardContext context) always returns true - override this function if your component needs dynamic initialization
void	processInput(IWizardContext context) the default implemention does no input processing.
void	setPath(java.lang.String iPath) set the path of this component. e.g. it's position in the wizard hierarchy. path components are seperated by IWizardSession.PATH_DELIMITER. example: "pane1.nameComponent.firstNameInputField".
void	wasChanged(IWizardContext context) this method should be called whenever a component is changed.

Methods inherited from class com.sapportals.admin.wizardframework.components.AbstractWizardComponent

getControlInFocus, getDescription, getProperty, getTitle, isComplete, isMandatory, setMandatory, setProperty, setTempProperty, setupComponent

Methods inherited from class java.lang.Object

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

Field Detail

components

protected java.util.Hashtable components

VERTICAL_LAYOUT

public static final int VERTICAL_LAYOUT

HORIZONTAL_LAYOUT

public static final int HORIZONTAL_LAYOUT

Constructor Detail

WizardComponentContainer

public WizardComponentContainer()

sorry, no detailed documentation yet

WizardComponentContainer

public WizardComponentContainer(int iLayout)

sorry, no detailed documentation yet

Parameters:

int - iLayout

WizardComponentContainer

public WizardComponentContainer(int iLayout,
                                int iPadding)

sorry, no detailed documentation yet

Parameters:

int - iLayout

int - iPadding

Method Detail

addComponent

public void addComponent(java.lang.String key,
                         IWizardComponent component)

addComponent

public void addComponent(java.lang.String key,
                         IWizardComponent component,
                         boolean isMandatoryField)

addComponent

public void addComponent(java.lang.String key,
                         com.sapportals.htmlb.Component component)

getComponent

public IWizardComponent getComponent(java.lang.String key)

Description copied from interface: IWizardComponentContainer

get a (sub)component from this container

Specified by:

getComponent in interface IWizardComponentContainer

isInitialized

public boolean isInitialized(IWizardContext context)

Description copied from class: AbstractWizardComponent

always returns true - override this function if your component needs dynamic initialization

Overrides:

isInitialized in class AbstractWizardComponent

Following copied from interface: com.sapportals.admin.wizardframework.api.IWizardComponent

Returns:

- has this component already been initialized?

init

public void init(IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implemention does nothing on init

Overrides:

init in class AbstractWizardComponent

doBeforeDisplay

public void doBeforeDisplay(IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implemention does nothing before display

Overrides:

doBeforeDisplay in class AbstractWizardComponent

processInput

public void processInput(IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implemention does no input processing.

Overrides:

processInput in class AbstractWizardComponent

doAfterSubmit

public void doAfterSubmit(IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implemention does nothing

Overrides:

doAfterSubmit in class AbstractWizardComponent

getPath

public java.lang.String getPath()

Description copied from class: AbstractWizardComponent

get the path of this component (internally used)

Overrides:

getPath in class AbstractWizardComponent

setPath

public void setPath(java.lang.String iPath)

Description copied from class: AbstractWizardComponent

set the path of this component. e.g. it's position in the wizard hierarchy. path components are seperated by IWizardSession.PATH_DELIMITER. example: "pane1.nameComponent.firstNameInputField". If this component contains other components it will set their path in this function.

Overrides:

setPath in class AbstractWizardComponent

getDisplay

public com.sapportals.htmlb.Component getDisplay(IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implementation returns null - if your component has a display it should inherit AbstractDisplayComponent or AbstractInputComponent.

Overrides:

getDisplay in class AbstractWizardComponent

wasChanged

public void wasChanged(IWizardContext context)

Description copied from class: AbstractWizardComponent

this method should be called whenever a component is changed. It clears all components dependent on this component or its parent components.

Overrides:

wasChanged in class AbstractWizardComponent

clearIfInconsistent

public void clearIfInconsistent(java.lang.String changedObjectKey,
                                IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implementtion clears all values from this component's branch in the session.

Overrides:

clearIfInconsistent in class AbstractWizardComponent

getErrorMessages

public java.util.List getErrorMessages(IWizardContext context)

Description copied from class: AbstractWizardComponent

the default implemention returns null

Overrides:

getErrorMessages in class AbstractWizardComponent

Following copied from interface: com.sapportals.admin.wizardframework.api.IWizardComponent

Returns:

- If this component was not propperly filled by the user return a list of error messages indicating the missing fields or inconsistencies, otherwise return null;