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

org.apache.wicket.markup.html.panel.GenericPanel<T>

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:

com.googlecode.wicket.jquery.core.IJQueryWidget, IDialogListener, 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.IGenericComponent<T>, 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

com.googlecode.wicket.jquery.core.IJQueryWidget.JQueryWidget

Field Summary

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

CANCEL, CLOSE, LBL_CANCEL, LBL_CLOSE, LBL_NO, LBL_OK, LBL_SUBMIT, LBL_YES, NO, OK, SUBMIT, YES

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

Modifier and Type	Method and Description
protected boolean	closeOnCancel() Indicates whether the wizard should close when onCancel() is triggered
protected boolean	closeOnFinish() Indicates whether the wizard should close when onFinish() is triggered
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.WebMarkupContainer	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
protected org.apache.wicket.markup.html.WebMarkupContainer	newFeedbackPanel(String id) Gets a new FeedbackPanel
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.
void	onConfigure(com.googlecode.wicket.jquery.core.JQueryBehavior behavior) Warning: autoOpen option is not supported
protected void	onError(org.apache.wicket.ajax.AjaxRequestTarget target) Triggered when the form is submitted, but the validation failed
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 when the form is submitted, and the validation succeed
void	refresh(org.apache.wicket.ajax.AjaxRequestTarget target) Deprecated. use reload(AjaxRequestTarget) instead
protected void	reload(org.apache.wicket.ajax.AjaxRequestTarget target) Reloads 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, getModelComparator, newButtonAjaxBehavior, onClose, onModelChanged

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

close, findButton, getTitle, getWidth, isDefaultCloseEventEnabled, isEscapeCloseEventEnabled, isModal, isResizable, newWidgetBehavior, onBeforeRender, onDetach, open, setTitle, setTitle, setTitle

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

getModel, getModelObject, setModel, setModelObject

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

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, 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, 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, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onEvent, onModelChanging, onReAdd, 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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

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

reload

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

Reloads 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

refresh

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

Deprecated. use reload(AjaxRequestTarget) instead

getFeedbackPanel

public org.apache.wicket.markup.html.WebMarkupContainer getFeedbackPanel()

Gets the wizard FeedbackPanel

Returns:

the FeedbackPanel

closeOnCancel

protected boolean closeOnCancel()

Indicates whether the wizard should close when onCancel() is triggered

Returns:

true by default

closeOnFinish

protected boolean closeOnFinish()

Indicates whether the wizard should close when onFinish() is triggered

Returns:

true by default

onInitialize

protected void onInitialize()

Overrides:

onInitialize in class AbstractFormDialog<T extends Serializable>

onConfigure

public void onConfigure(com.googlecode.wicket.jquery.core.JQueryBehavior behavior)

Warning: autoOpen option is not supported

Specified by:

onConfigure in interface com.googlecode.wicket.jquery.core.IJQueryWidget

Overrides:

onConfigure in class AbstractDialog<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.

Specified by:

onClick in interface IDialogListener

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 when the form is submitted, and the validation succeed

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 when the form is submitted, but the validation failed

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

newFeedbackPanel

protected org.apache.wicket.markup.html.WebMarkupContainer newFeedbackPanel(String id)

Gets a new FeedbackPanel

Parameters:

id - the markup id

Returns:

a new JQueryFeedbackPanel by default