com.googlecode.wicket.jquery.ui.widget.wizard

Class AbstractWizard<T extends Serializable>

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

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

com.googlecode.wicket.jquery.core.JQueryPanel

com.googlecode.wicket.jquery.ui.widget.dialog.AbstractDialog<T>

com.googlecode.wicket.jquery.ui.widget.dialog.AbstractFormDialog<T>

com.googlecode.wicket.jquery.ui.widget.wizard.AbstractWizard<T>

Type Parameters:

T - the model object type

All Implemented Interfaces:

IJQueryWidget, Serializable, Iterable<org.apache.wicket.Component>, org.apache.wicket.event.IEventSink, org.apache.wicket.event.IEventSource, org.apache.wicket.extensions.wizard.IWizard, org.apache.wicket.extensions.wizard.IWizardModelListener, org.apache.wicket.IConverterLocator, org.apache.wicket.markup.html.IHeaderContributor, org.apache.wicket.request.component.IRequestableComponent, org.apache.wicket.util.IHierarchical<org.apache.wicket.Component>, org.apache.wicket.util.io.IClusterable

public abstract class AbstractWizard<T extends Serializable>
extends AbstractFormDialog<T>
implements org.apache.wicket.extensions.wizard.IWizardModelListener, org.apache.wicket.extensions.wizard.IWizard

Provides the base class for wizard-based dialogs

Author:

Sebastien Briquet - sebfz1

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.googlecode.wicket.jquery.ui.widget.dialog.AbstractFormDialog

AbstractFormDialog.DialogFormSubmitter

Nested classes/interfaces inherited from interface com.googlecode.wicket.jquery.core.IJQueryWidget

IJQueryWidget.JQueryWidget

Field Summary

Fields inherited from class com.googlecode.wicket.jquery.ui.widget.dialog.AbstractDialog

LBL_CANCEL, LBL_CLOSE, LBL_NO, LBL_OK, LBL_SUBMIT, LBL_YES

Fields inherited from class com.googlecode.wicket.jquery.core.JQueryPanel

options

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

PANEL

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER

Constructor Summary

Constructors

Constructor and Description
AbstractWizard(String id, org.apache.wicket.model.IModel<String> title) Constructor
AbstractWizard(String id, org.apache.wicket.model.IModel<String> title, boolean modal) Constructor
AbstractWizard(String id, org.apache.wicket.model.IModel<String> title, org.apache.wicket.model.IModel<T> model) Constructor
AbstractWizard(String id, org.apache.wicket.model.IModel<String> title, org.apache.wicket.model.IModel<T> model, boolean modal) Constructor
AbstractWizard(String id, org.apache.wicket.model.IModel<String> title, org.apache.wicket.extensions.wizard.IWizardModel wizardModel) Constructor
AbstractWizard(String id, String title) Constructor
AbstractWizard(String id, String title, boolean modal) Constructor
AbstractWizard(String id, String title, org.apache.wicket.model.IModel<T> model) Constructor
AbstractWizard(String id, String title, org.apache.wicket.model.IModel<T> model, boolean modal) Constructor
AbstractWizard(String id, String title, org.apache.wicket.extensions.wizard.IWizardModel wizardModel) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
protected List<DialogButton>	getButtons() Gets the dialog's buttons. It is allowed to return a predefined list (ie: DialogButtons#OK_CANCEL#toList()) as long as the buttons state (enable and/or visible) are not modified Warning: It is not legal to create the buttons to be returned in this method.
protected DialogButton	getCancelButton() Gets the button that is in charge to cancel to wizard.
org.apache.wicket.markup.html.panel.FeedbackPanel	getFeedbackPanel() Gets the wizard FeedbackPanel
org.apache.wicket.markup.html.form.Form<?>	getForm() Gets the form to be validated by this dialog. Warning, the onSubmit and the onError are being delegated to this dialog.
protected org.apache.wicket.markup.html.form.Form<?>	getForm(DialogButton button) Returns the form associated to the button. It means that it will return the form if the supplied button is considered as a form submitter and null otherwise.
protected DialogButton	getSubmitButton() Gets the button that is in charge to submit the form. It should be in the list of buttons returned by AbstractDialog.getButtons()
org.apache.wicket.extensions.wizard.IWizardModel	getWizardModel()
protected void	init(org.apache.wicket.extensions.wizard.IWizardModel wizardModel) Initialization
void	onActiveStepChanged(org.apache.wicket.extensions.wizard.IWizardStep step)
void	onCancel()
protected void	onCancel(org.apache.wicket.ajax.AjaxRequestTarget target) Triggered when the wizard has been canceled
void	onClick(org.apache.wicket.ajax.AjaxRequestTarget target, DialogButton button) Triggered when a wizard button is clicked.
protected void	onConfigure(org.apache.wicket.ajax.AjaxRequestTarget target) Called when the wizard needs to be configured.
protected void	onError(org.apache.wicket.ajax.AjaxRequestTarget target) Triggered after Form.onError() (when the form processing has error(s))
void	onFinish()
protected abstract void	onFinish(org.apache.wicket.ajax.AjaxRequestTarget target) Triggered when the wizard completes
protected void	onInitialize()
protected void	onOpen(org.apache.wicket.ajax.AjaxRequestTarget target) Triggered when the dialog opens
protected void	onSubmit(org.apache.wicket.ajax.AjaxRequestTarget target) Triggered after Form.onSubmit() (the form has been submitted and it does not have error)
protected void	refresh(org.apache.wicket.ajax.AjaxRequestTarget target) Refreshes the wizard, by calling onConfigure(AjaxRequestTarget) and re-attaching the form This method is called when, for instance, the wizard opens or the step changes.

Methods inherited from class com.googlecode.wicket.jquery.ui.widget.dialog.AbstractFormDialog

getDefaultFormProcessing, newButtonAjaxBehavior, onClose

Methods inherited from class com.googlecode.wicket.jquery.ui.widget.dialog.AbstractDialog

close, findButton, getModel, getModelObject, getTitle, getWidth, isDefaultCloseEventEnabled, isEscapeCloseEventEnabled, isModal, isResizable, newWidgetBehavior, onConfigure, open, setModelObject, setTitle, setTitle, setTitle

Methods inherited from class com.googlecode.wicket.jquery.core.JQueryPanel

onBeforeRender

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

newMarkupSourcingStrategy

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

getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onComponentTagBody, onRender, 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, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, debug, detach, detachModel, 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, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onDetach, onEvent, onModelChanged, onModelChanging, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, 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

Constructor Detail

AbstractWizard

public AbstractWizard(String id,
              String title)

Constructor

Parameters:

id - the markup id

title - the dialog's title

AbstractWizard

public AbstractWizard(String id,
              org.apache.wicket.model.IModel<String> title)

Constructor

Parameters:

id - the markup id

title - the dialog's title

AbstractWizard

public AbstractWizard(String id,
              String title,
              org.apache.wicket.extensions.wizard.IWizardModel wizardModel)

Constructor

Parameters:

id - the markup id

title - the dialog's title

wizardModel - the IWizardModel

AbstractWizard

public AbstractWizard(String id,
              org.apache.wicket.model.IModel<String> title,
              org.apache.wicket.extensions.wizard.IWizardModel wizardModel)

Constructor

Parameters:

id - the markup id

title - the dialog's title

wizardModel - the IWizardModel

AbstractWizard

public AbstractWizard(String id,
              String title,
              boolean modal)

Constructor

Parameters:

id - the markup id

title - the dialog's title

modal - indicates whether the dialog is modal

AbstractWizard

public AbstractWizard(String id,
              org.apache.wicket.model.IModel<String> title,
              boolean modal)

Constructor

Parameters:

id - the markup id

title - the dialog's title

modal - indicates whether the dialog is modal

AbstractWizard

public AbstractWizard(String id,
              String title,
              org.apache.wicket.model.IModel<T> model,
              boolean modal)

Constructor

Parameters:

id - the markup id

title - the dialog's title

model - the dialog's model

modal - indicates whether the dialog is modal

AbstractWizard

public AbstractWizard(String id,
              org.apache.wicket.model.IModel<String> title,
              org.apache.wicket.model.IModel<T> model,
              boolean modal)

Constructor

Parameters:

id - the markup id

title - the dialog's title

model - the dialog's model

modal - indicates whether the dialog is modal

AbstractWizard

public AbstractWizard(String id,
              String title,
              org.apache.wicket.model.IModel<T> model)

Constructor

Parameters:

id - the markup id

title - the dialog's title

model - the dialog's model

AbstractWizard

public AbstractWizard(String id,
              org.apache.wicket.model.IModel<String> title,
              org.apache.wicket.model.IModel<T> model)

Constructor

Parameters:

id - the markup id

title - the dialog's title

model - the dialog's model

Method Detail

init

protected final void init(org.apache.wicket.extensions.wizard.IWizardModel wizardModel)

Initialization

Parameters:

wizardModel - the IWizardModel

refresh

protected void refresh(org.apache.wicket.ajax.AjaxRequestTarget target)

Refreshes the wizard, by calling onConfigure(AjaxRequestTarget) and re-attaching the form
This method is called when, for instance, the wizard opens or the step changes.

Parameters:

target - the AjaxRequestTarget

getFeedbackPanel

public org.apache.wicket.markup.html.panel.FeedbackPanel getFeedbackPanel()

Gets the wizard FeedbackPanel

Returns:

the FeedbackPanel

onInitialize

protected void onInitialize()

Overrides:

onInitialize in class AbstractFormDialog<T extends Serializable>

onConfigure

protected void onConfigure(org.apache.wicket.ajax.AjaxRequestTarget target)

Called when the wizard needs to be configured.

Parameters:

target - the AjaxRequestTarget

onOpen

protected void onOpen(org.apache.wicket.ajax.AjaxRequestTarget target)

Description copied from class: AbstractDialog

Triggered when the dialog opens

Overrides:

onOpen in class AbstractDialog<T extends Serializable>

Parameters:

target - the AjaxRequestTarget

onClick

public final void onClick(org.apache.wicket.ajax.AjaxRequestTarget target,
           DialogButton button)

Triggered when a wizard button is clicked. If the button is a form-submitter button, the validation should have succeeded for this event to be triggered. This implementation overrides the default AbstractDialog.onClick(AjaxRequestTarget, DialogButton) implementation in order to not close the dialog.

Overrides:

onClick in class AbstractDialog<T extends Serializable>

Parameters:

target - the AjaxRequestTarget

button - the button that closed the dialog

onSubmit

protected void onSubmit(org.apache.wicket.ajax.AjaxRequestTarget target)

Description copied from class: AbstractFormDialog

Triggered after Form.onSubmit() (the form has been submitted and it does not have error)

Specified by:

onSubmit in class AbstractFormDialog<T extends Serializable>

Parameters:

target - the AjaxRequestTarget

onError

protected final void onError(org.apache.wicket.ajax.AjaxRequestTarget target)

Description copied from class: AbstractFormDialog

Triggered after Form.onError() (when the form processing has error(s))

Specified by:

onError in class AbstractFormDialog<T extends Serializable>

onFinish

public void onFinish()

Specified by:

onFinish in interface org.apache.wicket.extensions.wizard.IWizardModelListener

onCancel

public void onCancel()

Specified by:

onCancel in interface org.apache.wicket.extensions.wizard.IWizardModelListener

onFinish

protected abstract void onFinish(org.apache.wicket.ajax.AjaxRequestTarget target)

Triggered when the wizard completes

Parameters:

target - the AjaxRequestTarget

onCancel

protected void onCancel(org.apache.wicket.ajax.AjaxRequestTarget target)

Triggered when the wizard has been canceled

Parameters:

target - the AjaxRequestTarget

getWizardModel

public org.apache.wicket.extensions.wizard.IWizardModel getWizardModel()

Specified by:

getWizardModel in interface org.apache.wicket.extensions.wizard.IWizard

onActiveStepChanged

public void onActiveStepChanged(org.apache.wicket.extensions.wizard.IWizardStep step)

Specified by:

onActiveStepChanged in interface org.apache.wicket.extensions.wizard.IWizardModelListener

getButtons

protected List<DialogButton> getButtons()

Description copied from class: AbstractDialog

Gets the dialog's buttons.
It is allowed to return a predefined list (ie: DialogButtons#OK_CANCEL#toList()) as long as the buttons state (enable and/or visible) are not modified
Warning: It is not legal to create the buttons to be returned in this method.

Overrides:

getButtons in class AbstractDialog<T extends Serializable>

Returns:

AbstractDialog.btnOk by default

getSubmitButton

protected DialogButton getSubmitButton()

Description copied from class: AbstractFormDialog

Gets the button that is in charge to submit the form.
It should be in the list of buttons returned by AbstractDialog.getButtons()

Specified by:

getSubmitButton in class AbstractFormDialog<T extends Serializable>

Returns:

the submit button

getCancelButton

protected DialogButton getCancelButton()

Gets the button that is in charge to cancel to wizard.

Returns:

the cancel button

getForm

public org.apache.wicket.markup.html.form.Form<?> getForm()

Description copied from class: AbstractFormDialog

Gets the form to be validated by this dialog.
Warning, the onSubmit and the onError are being delegated to this dialog. However, it does not prevent the use of Form#onSubmit nor Form#onError

Specified by:

getForm in class AbstractFormDialog<T extends Serializable>

Returns:

the form

getForm

protected org.apache.wicket.markup.html.form.Form<?> getForm(DialogButton button)

Returns the form associated to the button.
It means that it will return the form if the supplied button is considered as a form submitter and null otherwise.
This method may be overridden to specify other form-submitter buttons (ie: btnPrev)

Overrides:

getForm in class AbstractFormDialog<T extends Serializable>

Parameters:

button - the dialog's button

Returns:

the Form or null