org.apache.wicket.extensions.wizard

Class WizardStep

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

org.apache.wicket.markup.html.panel.Panel

org.apache.wicket.extensions.wizard.WizardStep

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IWizardStep, IConverterLocator, IQueueRegion, IHeaderContributor, IRequestableComponent, IHierarchical<Component>, IClusterable

Direct Known Subclasses:

DynamicWizardStep, StaticContentStep

public class WizardStep
extends Panel
implements IWizardStep

default implementation of IWizardStep. It is also a panel, which is used as the view component.

And example of a custom step with a panel follows. Java (defined e.g. in class x.NewUserWizard):

 private final class UserNameStep extends WizardStep
 {
        public UserNameStep()
        {
                super(new ResourceModel("username.title"), new ResourceModel("username.summary"));
                add(new RequiredTextField("user.userName"));
                add(new RequiredTextField("user.email").add(EmailAddressValidator.getInstance()));
        }
 }
 

HTML (defined in e.g. file x/NewUserWizard$UserNameStep.html):

  <wicket:panel>
   <table>
    <tr>
     <td><wicket:message key="username">Username</wicket:message></td>
     <td><input type="text" wicket:id="user.userName" /></td>
    </tr>
    <tr>
     <td><wicket:message key="email">Email Address</wicket:message></td>
     <td><input type="text" wicket:id="user.email" /></td>
    </tr>
   </table>
  </wicket:panel>
 

Author:

Eelco Hillenius

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.markup.html.panel.Panel

PANEL

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_AFTER_RENDERING, FLAG_INITIALIZED, FLAG_PREPARED_FOR_RENDER, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RENDERING, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING

Constructor Summary

Constructors

Constructor and Description
WizardStep() Construct without a title and a summary.
WizardStep(IModel<String> title, IModel<String> summary) Creates a new step with the specified title and summary.
WizardStep(IModel<String> title, IModel<String> summary, IModel<?> model) Creates a new step with the specified title and summary.
WizardStep(String title, String summary) Creates a new step with the specified title and summary.
WizardStep(String title, String summary, IModel<?> model) Creates a new step with the specified title and summary.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(IFormValidator validator) Adds a form validator.
void	applyState() This method is called whenever the user presses next while this step is active.
protected void	detachModel() Detaches the model for this component if it is detachable.
Component	getHeader(String id, Component parent, IWizard wizard) Gets the header component for this step.
String	getSummary() Gets the summary of this step.
String	getTitle() Gets the title of this step.
Component	getView(String id, Component parent, IWizard wizard) Returns the current view this step is displaying.
IWizardModel	getWizardModel()
void	init(IWizardModel wizardModel) Called to initialize the step.
boolean	isComplete() Checks if this step is compete.
protected void	onInit(IWizardModel wizardModel) Template method that is called when the step is being initialized.
protected void	onInitialize() This method is meant to be used as an alternative to initialize components.
void	setComplete(boolean complete) Marks this step as compete.
void	setSummaryModel(IModel<String> summary) Sets summary.
void	setTitleModel(IModel<String> title) Sets title.

Methods inherited from class org.apache.wicket.markup.html.panel.Panel

getRegionMarkup, newMarkupSourcingStrategy

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onAfterRenderChildren, onComponentTagBody, onDetach, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, canCallListenerInterface, canCallListenerInterfaceAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.wicket.IQueueRegion

dequeue, newDequeueContext

Constructor Detail

WizardStep

public WizardStep()

Construct without a title and a summary. Useful for when you provide a custom header by overiding getHeader(String, Component, IWizard).

WizardStep

public WizardStep(IModel<String> title,
          IModel<String> summary)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

WizardStep

public WizardStep(IModel<String> title,
          IModel<String> summary,
          IModel<?> model)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

model - Any model which is to be used for this step

WizardStep

public WizardStep(String title,
          String summary)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

WizardStep

public WizardStep(String title,
          String summary,
          IModel<?> model)

Creates a new step with the specified title and summary. The title and summary are displayed in the wizard title block while this step is active.

Parameters:

title - the title of this step.

summary - a brief summary of this step or some usage guidelines.

model - Any model which is to be used for this step

Method Detail

add

public final void add(IFormValidator validator)

Adds a form validator.

Parameters:

validator -

applyState

public void applyState()

Description copied from interface: IWizardStep

This method is called whenever the user presses next while this step is active.

This method will only be called if IWizardModel.isNextAvailable() returns true.

Specified by:

applyState in interface IWizardStep

See Also:

IWizardStep.applyState()

getHeader

public Component getHeader(String id,
                  Component parent,
                  IWizard wizard)

Description copied from interface: IWizardStep

Gets the header component for this step. This component is displayed in a special section of the wizard.

Specified by:

getHeader in interface IWizardStep

Parameters:

id - The id that the component should be created with

parent - The parent component (for post 1.2)

wizard - The wizard component the header will be placed on

Returns:

The header component

See Also:

IWizardStep.getHeader(java.lang.String, org.apache.wicket.Component, org.apache.wicket.extensions.wizard.IWizard)

getSummary

public String getSummary()

Gets the summary of this step. This will be displayed in the title of the wizard while this step is active. The summary is typically an overview of the step or some usage guidelines for the user.

Returns:

the summary of this step.

getTitle

public String getTitle()

Gets the title of this step.

Returns:

the title of this step.

getView

public Component getView(String id,
                Component parent,
                IWizard wizard)

Description copied from interface: IWizardStep

Returns the current view this step is displaying. This component will be displayed in the main section of the wizard with this step is active. This may changed at any time by as long as an appropriate property change event is fired.

Specified by:

getView in interface IWizardStep

Parameters:

id - The id that the component should be created with

parent - The parent component (for post 1.2)

wizard - The wizard component the header will be placed on

Returns:

The current view of the step.

See Also:

IWizardStep.getView(java.lang.String, org.apache.wicket.Component, org.apache.wicket.extensions.wizard.IWizard)

init

public final void init(IWizardModel wizardModel)

Called to initialize the step. When this method is called depends on the kind of wizard model that is used. The static wizard model knows all the steps upfront and initializes themm when starting up. This method will be called when the wizard is initializing. The dynamic wizard model initializes steps every time they are encountered. This method sets the wizard model and then calls template method onInit(IWizardModel)

Specified by:

init in interface IWizardStep

Parameters:

wizardModel - the model to which the step belongs.

isComplete

public boolean isComplete()

Checks if this step is compete. This method should return true if the wizard can proceed to the next step. This property is bound and changes can be made at anytime by calling setComplete(boolean) .

Specified by:

isComplete in interface IWizardStep

Returns:

true if the wizard can proceed from this step, false otherwise.

See Also:

setComplete(boolean)

setComplete

public void setComplete(boolean complete)

Marks this step as compete. The wizard will not be able to proceed from this step until this property is configured to true.

Parameters:

complete - true to allow the wizard to proceed, false otherwise.

See Also:

isComplete()

setSummaryModel

public void setSummaryModel(IModel<String> summary)

Sets summary.

Parameters:

summary - summary

setTitleModel

public void setTitleModel(IModel<String> title)

Sets title.

Parameters:

title - title

detachModel

protected void detachModel()

Description copied from class: Component

Detaches the model for this component if it is detachable.

Overrides:

detachModel in class Component

See Also:

Component.detachModel()

onInitialize

protected void onInitialize()

Description copied from class: Component

This method is meant to be used as an alternative to initialize components. Usually the component's constructor is used for this task, but sometimes a component cannot be initialized in isolation, it may need to access its parent component or its markup in order to fully initialize. This method is invoked once per component's lifecycle when a path exists from this component to the Page thus providing the component with an atomic callback when the component's environment is built out.

Overrides must call super#Component.onInitialize(). Usually this should be the first thing an override does, much like a constructor.

Parent containers are guaranteed to be initialized before their children

It is safe to use Component.getPage() in this method

NOTE:The timing of this call is not precise, the contract is that it is called sometime before Component.onBeforeRender().

Overrides:

onInitialize in class MarkupContainer

onInit

protected void onInit(IWizardModel wizardModel)

Template method that is called when the step is being initialized.

Parameters:

wizardModel -

See Also:

init(IWizardModel)

getWizardModel

public IWizardModel getWizardModel()

Returns:

wizard model