org.apache.wicket.ajax.attributes
Class AjaxCallListener

java.lang.Object
  org.apache.wicket.ajax.attributes.AjaxCallListener

All Implemented Interfaces:

Serializable, IAjaxCallListener, IComponentAwareHeaderContributor, IClusterable

Direct Known Subclasses:

CancelEventIfAjaxListener

public class AjaxCallListener
extends Object
implements IAjaxCallListener, IComponentAwareHeaderContributor

An adapter for implementations of IAjaxCallListener.

Since:

6.0

See Also:

Serialized Form

Constructor Summary

AjaxCallListener()

Method Summary

CharSequence	getAfterHandler(Component component) The JavaScript that will be executed after the Ajax call.
CharSequence	getBeforeHandler(Component component) The JavaScript that will be executed before the Ajax call, as early as possible.
CharSequence	getBeforeSendHandler(Component component) The JavaScript that will be executed right before the execution of the the Ajax call, only if all preconditions pass.
CharSequence	getCompleteHandler(Component component) The JavaScript that will be executed after both successful and unsuccessful return of the Ajax call.
CharSequence	getDoneHandler(Component component) The JavaScript that will be executed after the Ajax call is done, regardless whether it was sent or not.
CharSequence	getFailureHandler(Component component) The JavaScript that will be executed after unsuccessful return of the Ajax call.
CharSequence	getInitHandler(Component component) TODO Wicket 7: pull up into IAjaxCallListener
CharSequence	getPrecondition(Component component) A JavaScript function that is invoked before the request is being executed.
CharSequence	getSuccessHandler(Component component) The JavaScript that will be executed after successful return of the Ajax call.
AjaxCallListener	onAfter(CharSequence after) Sets the JavaScript code that will be returned by getAfterHandler(Component).
AjaxCallListener	onBefore(CharSequence before) Sets the JavaScript code that will be returned by getBeforeHandler(Component).
AjaxCallListener	onBeforeSend(CharSequence beforeSend) Sets the JavaScript code that will be returned by getBeforeSendHandler(Component).
AjaxCallListener	onComplete(CharSequence complete) Sets the JavaScript code that will be returned by getCompleteHandler(Component).
AjaxCallListener	onDone(CharSequence done) Sets the JavaScript code that will be returned by getDoneHandler(Component).
AjaxCallListener	onFailure(CharSequence failure) Sets the JavaScript code that will be returned by getFailureHandler(Component).
AjaxCallListener	onInit(CharSequence init) Sets the JavaScript code that will be returned by getInitHandler(Component).
AjaxCallListener	onPrecondition(CharSequence precondition) Sets the JavaScript code that will be returned by getPrecondition(Component).
AjaxCallListener	onSuccess(CharSequence success) Sets the JavaScript code that will be returned by getSuccessHandler(Component).
void	renderHead(Component component, IHeaderResponse response) Render to the web response whatever the component-aware wants to contribute to the head section.

Methods inherited from class java.lang.Object

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

Constructor Detail

AjaxCallListener

public AjaxCallListener()

Method Detail

onInit

public AjaxCallListener onInit(CharSequence init)

Sets the JavaScript code that will be returned by getInitHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

init - the JavaScript code for the corresponding handler

Returns:

This

onDone

public AjaxCallListener onDone(CharSequence done)

Sets the JavaScript code that will be returned by getDoneHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

init - the JavaScript code for the corresponding handler

Returns:

This

onBefore

public AjaxCallListener onBefore(CharSequence before)

Sets the JavaScript code that will be returned by getBeforeHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

before - the JavaScript code for the corresponding handler

Returns:

This

onBeforeSend

public AjaxCallListener onBeforeSend(CharSequence beforeSend)

Sets the JavaScript code that will be returned by getBeforeSendHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

beforeSend - the JavaScript code for the corresponding handler

Returns:

This

onAfter

public AjaxCallListener onAfter(CharSequence after)

Sets the JavaScript code that will be returned by getAfterHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

after - the JavaScript code for the corresponding handler

Returns:

This

onSuccess

public AjaxCallListener onSuccess(CharSequence success)

Sets the JavaScript code that will be returned by getSuccessHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

success - the JavaScript code for the corresponding handler

Returns:

This

onFailure

public AjaxCallListener onFailure(CharSequence failure)

Sets the JavaScript code that will be returned by getFailureHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

failure - the JavaScript code for the corresponding handler

Returns:

This

onComplete

public AjaxCallListener onComplete(CharSequence complete)

Sets the JavaScript code that will be returned by getCompleteHandler(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

complete - the JavaScript code for the corresponding handler

Returns:

This

onPrecondition

public AjaxCallListener onPrecondition(CharSequence precondition)

Sets the JavaScript code that will be returned by getPrecondition(Component). If this code was already set, the new one will be appended to the existing one.

Parameters:

precondition - the JavaScript code for the precondition

Returns:

This

getSuccessHandler

public CharSequence getSuccessHandler(Component component)

Description copied from interface: IAjaxCallListener

The JavaScript that will be executed after successful return of the Ajax call. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON
2. jqXHR - the jQuery XMLHttpRequest object
3. data - the Ajax response. Its type depends on AjaxRequestAttributes.dataType
4. textStatus - the status as text

Specified by:

getSuccessHandler in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed after a successful return of the Ajax call.

getFailureHandler

public CharSequence getFailureHandler(Component component)

Description copied from interface: IAjaxCallListener

The JavaScript that will be executed after unsuccessful return of the Ajax call. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON

Specified by:

getFailureHandler in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed after a unsuccessful return of the Ajax call.

getInitHandler

public CharSequence getInitHandler(Component component)

TODO Wicket 7: pull up into IAjaxCallListener

getBeforeHandler

public CharSequence getBeforeHandler(Component component)

Description copied from interface: IAjaxCallListener

The JavaScript that will be executed before the Ajax call, as early as possible. Even before the preconditions. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON

Specified by:

getBeforeHandler in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed before the Ajax call.

getBeforeSendHandler

public CharSequence getBeforeSendHandler(Component component)

Description copied from interface: IAjaxCallListener

The JavaScript that will be executed right before the execution of the the Ajax call, only if all preconditions pass. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON
2. jqXHR - the jQuery XMLHttpRequest object
3. settings - the settings used for the jQuery.ajax() call

Specified by:

getBeforeSendHandler in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed before the Ajax call.

getAfterHandler

public CharSequence getAfterHandler(Component component)

Description copied from interface: IAjaxCallListener

The JavaScript that will be executed after the Ajax call. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON

Note: if the Ajax call is synchronous (see AjaxRequestAttributes.setAsynchronous(boolean)) then this JavaScript will be executed after the complete handler, otherwise it is executed right after the execution of the Ajax request.

Specified by:

getAfterHandler in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed after the start of the Ajax call but before its response is returned.

getCompleteHandler

public CharSequence getCompleteHandler(Component component)

Description copied from interface: IAjaxCallListener

The JavaScript that will be executed after both successful and unsuccessful return of the Ajax call. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON
2. jqXHR - the jQuery XMLHttpRequest object
3. textStatus - the status as text

Specified by:

getCompleteHandler in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed after both successful and unsuccessful return of the Ajax call.

getPrecondition

public CharSequence getPrecondition(Component component)

Description copied from interface: IAjaxCallListener

A JavaScript function that is invoked before the request is being executed. If it returns false then the execution of the Ajax call will be cancelled. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON

Specified by:

getPrecondition in interface IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that should be used to decide whether the Ajax call should be made at all.

getDoneHandler

public CharSequence getDoneHandler(Component component)

The JavaScript that will be executed after the Ajax call is done, regardless whether it was sent or not. The script will be executed in a function that receives the following parameters:

1. attrs - the AjaxRequestAttributes as JSON

TODO Wicket 7: pull up into IAjaxCallListener

Parameters:

component - the Component with the Ajax behavior

Returns:

the JavaScript that will be executed after the Ajax call is done.

renderHead

public void renderHead(Component component,
                       IHeaderResponse response)

Description copied from interface: IComponentAwareHeaderContributor

Render to the web response whatever the component-aware wants to contribute to the head section.

Specified by:

renderHead in interface IComponentAwareHeaderContributor

Parameters:

component - component which is contributing to the response. This parameter is here to give the component as the context for component-awares implementing this interface

response - Response object