org.apache.wicket.markup.html.form

Class FormComponentUpdatingBehavior

java.lang.Object

org.apache.wicket.behavior.Behavior

org.apache.wicket.markup.html.form.FormComponentUpdatingBehavior

All Implemented Interfaces:

Serializable, IComponentAwareEventSink, IRequestListener, IComponentAwareHeaderContributor, org.apache.wicket.util.io.IClusterable

public class FormComponentUpdatingBehavior
extends Behavior
implements IRequestListener

A behavior to get notifications when a FormComponent changes its value.

Contrary to AjaxFormComponentUpdatingBehavior all notification are sent via standard HTTP requests and the full page is rendered as a response.

Notification is triggered by an event suitable for the host component this behavior is added to - if needed getEvent() can be overridden to change the default ( for DropDownChoice, ListMultipleChoice and AbstractTextComponent, for anything else).

Note: This behavior has limited support for FormComponents outside of a form, i.e. multiple choice components (ListMultipleChoice and RadioGroup) will send their last selected choice only.

See Also:

onUpdate(), Serialized Form

Constructor Summary

Constructors

Constructor and Description
FormComponentUpdatingBehavior()

Method Summary

Modifier and Type	Method and Description
void	bind(Component component) Bind this handler to the given component.
protected String	getEvent() Which JavaScript event triggers notification.
FormComponent<?>	getFormComponent() Get the hosting component.
boolean	getStatelessHint(Component component) This method returns false if the behavior generates a callback url (for example ajax behaviors)
protected boolean	getUpdateModel() Gives the control to the application to decide whether the form component model should be updated automatically or not.
protected void	onBind() Called when the component was bound to it's host component.
void	onComponentTag(Component component, ComponentTag tag) Called any time a component that has this behavior registered is rendering the component tag.
protected void	onError(RuntimeException e) Hook method invoked when updating of the component resulted in an error.
void	onRequest() Called when a request is received.
protected void	onUpdate() Hook method invoked when the component is updated.

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

afterRender, beforeRender, canCallListener, detach, isEnabled, isTemporary, onAttribute, onConfigure, onEvent, onException, onRemove, onTag, renderHead, unbind

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.wicket.IRequestListener

rendersPage

Constructor Detail

FormComponentUpdatingBehavior

public FormComponentUpdatingBehavior()

Method Detail

getStatelessHint

public boolean getStatelessHint(Component component)

Description copied from class: Behavior

This method returns false if the behavior generates a callback url (for example ajax behaviors)

Overrides:

getStatelessHint in class Behavior

Parameters:

component - the component that has this behavior coupled.

Returns:

boolean true or false.

bind

public final void bind(Component component)

Description copied from class: Behavior

Bind this handler to the given component. This method is called by the host component immediately after this behavior is added to it. This method is useful if you need to do initialization based on the component it is attached and you can't wait to do it at render time. Keep in mind that if you decide to keep a reference to the host component, it is not thread safe anymore, and should thus only be used in situations where you do not reuse the behavior for multiple components.

Overrides:

bind in class Behavior

Parameters:

component - the component to bind to

onBind

protected void onBind()

Called when the component was bound to it's host component. You can get the bound host component by calling getFormComponent().

getFormComponent

public final FormComponent<?> getFormComponent()

Get the hosting component.

Returns:

hosting component

onComponentTag

public void onComponentTag(Component component,
                           ComponentTag tag)

Description copied from class: Behavior

Called any time a component that has this behavior registered is rendering the component tag.

Overrides:

onComponentTag in class Behavior

Parameters:

component - the component that renders this tag currently

tag - the tag that is rendered

getEvent

protected String getEvent()

Which JavaScript event triggers notification.

Returns:

or , depending on the host component

getUpdateModel

protected boolean getUpdateModel()

Gives the control to the application to decide whether the form component model should be updated automatically or not. Make sure to call FormComponent.valid() additionally in case the application want to update the model manually.

Returns:

true if the model of form component should be updated, false otherwise

onUpdate

protected void onUpdate()

Hook method invoked when the component is updated.

Note: #onError(AjaxRequestTarget, RuntimeException) is called instead when processing of the FormComponent failed with conversion or validation errors!

onError

protected void onError(RuntimeException e)

Hook method invoked when updating of the component resulted in an error.

The RuntimeException will be null if it was just a validation or conversion error of the FormComponent.

Parameters:

e - optional runtime exception

onRequest

public final void onRequest()

Description copied from interface: IRequestListener

Called when a request is received.

Specified by:

onRequest in interface IRequestListener