org.apache.wicket.ajax.form
Class AjaxFormSubmitBehavior

java.lang.Object
  org.apache.wicket.behavior.AbstractBehavior
      org.apache.wicket.behavior.AbstractAjaxBehavior
          org.apache.wicket.ajax.AbstractDefaultAjaxBehavior
              org.apache.wicket.ajax.AjaxEventBehavior
                  org.apache.wicket.ajax.form.AjaxFormSubmitBehavior

All Implemented Interfaces:

Serializable, IBehavior, IBehaviorListener, IComponentConfigurationBehavior, IClusterable, IRequestListener, IHeaderContributor

Direct Known Subclasses:

AjaxFormValidatingBehavior

public abstract class AjaxFormSubmitBehavior
extends AjaxEventBehavior

Ajax event behavior that submits a form via ajax when the event it is attached to, is invoked.

The form must have an id attribute in the markup or have MarkupIdSetter added.

Since:

1.2

Author:

Igor Vaynberg (ivaynberg)

See Also:

AjaxEventBehavior, Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.ajax.AbstractDefaultAjaxBehavior

INDICATOR

Fields inherited from interface org.apache.wicket.behavior.IBehaviorListener

INTERFACE

Constructor Summary

AjaxFormSubmitBehavior(Form<?> form, String event)
Construct.

AjaxFormSubmitBehavior(String event)
Constructor.

Method Summary

protected Form<?>	findForm() Finds the form this behavior is linked to
protected CharSequence	getEventHandler()
Form<?>	getForm()
protected CharSequence	getPreconditionScript()
protected abstract void	onError(AjaxRequestTarget target) Listener method invoked when the form has been processed and errors occurred
protected void	onEvent(AjaxRequestTarget target) Listener method for the ajax event
protected abstract void	onSubmit(AjaxRequestTarget target) Listener method that is invoked after the form has been submitted and processed without errors

Methods inherited from class org.apache.wicket.ajax.AjaxEventBehavior

generateCallbackScript, getEvent, onCheckEvent, onComponentTag, respond, setThrottleDelay

Methods inherited from class org.apache.wicket.ajax.AbstractDefaultAjaxBehavior

findIndicatorId, getAjaxCallDecorator, getCallbackScript, getCallbackScript, getChannelName, getFailureScript, getSuccessScript, onBind, onRequest, renderHead, throttleScript

Methods inherited from class org.apache.wicket.behavior.AbstractAjaxBehavior

bind, getCallbackUrl, getCallbackUrl, getComponent, getImplementationId, getStatelessHint, onComponentRendered, onComponentTag, onRendered, onRenderHeadContribution, onRenderHeadInitContribution

Methods inherited from class org.apache.wicket.behavior.AbstractBehavior

afterRender, beforeRender, cleanup, detach, detachModel, exception, isEnabled, isTemporary, onConfigure, onException, rendered

Methods inherited from class java.lang.Object

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

Constructor Detail

AjaxFormSubmitBehavior

public AjaxFormSubmitBehavior(String event)

Constructor. This constructor can only be used when the component this behavior is attached to is inside a form.

Parameters:

event - javascript event this behavior is attached to, like onclick

AjaxFormSubmitBehavior

public AjaxFormSubmitBehavior(Form<?> form,
                              String event)

Construct.

Parameters:

form - form that will be submitted

event - javascript event this behavior is attached to, like onclick

Method Detail

getForm

public final Form<?> getForm()

Returns:

Form that will be submitted by this behavior

findForm

protected Form<?> findForm()

Finds the form this behavior is linked to

Returns:

form this behavior is linked to or null if none

getEventHandler

protected CharSequence getEventHandler()

Overrides:

getEventHandler in class AjaxEventBehavior

Returns:

event handler

See Also:

AjaxEventBehavior.getEventHandler()

onEvent

protected void onEvent(AjaxRequestTarget target)

Description copied from class: AjaxEventBehavior

Listener method for the ajax event

Specified by:

onEvent in class AjaxEventBehavior

See Also:

AjaxEventBehavior.onEvent(org.apache.wicket.ajax.AjaxRequestTarget)

onSubmit

protected abstract void onSubmit(AjaxRequestTarget target)

Listener method that is invoked after the form has been submitted and processed without errors

Parameters:

target -

onError

protected abstract void onError(AjaxRequestTarget target)

Listener method invoked when the form has been processed and errors occurred

Parameters:

target -

getPreconditionScript

protected CharSequence getPreconditionScript()

Overrides:

getPreconditionScript in class AbstractDefaultAjaxBehavior

Returns:

an optional javascript expression that determines whether the request will actually execute (in form of return XXX;);

See Also:

AbstractDefaultAjaxBehavior.getPreconditionScript()