org.apache.wicket.page

Class PartialPageUpdate

java.lang.Object

org.apache.wicket.page.PartialPageUpdate

Direct Known Subclasses:

XmlPartialPageUpdate

public abstract class PartialPageUpdate
extends Object

A partial update of a page that collects components and header contributions to be written to the client in a specific String-based format (XML, JSON, * ...).

The elements of such response are:

• priority-evaluate - an item of the prepend JavaScripts
• component - the markup of the updated component
• evaluate - an item of the onDomReady and append JavaScripts
• header-contribution - all HeaderItems which have been contributed in components' and their behaviors' #renderHead(Component, IHeaderResponse)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	PartialPageUpdate.ResponseBuffer Wrapper of a response that buffers its contents.

Field Summary

Fields

Modifier and Type	Field and Description
protected List<CharSequence>	appendJavaScripts A list of scripts (JavaScript) which should be executed on the client side after the components' replacement
protected PartialPageUpdate.ResponseBuffer	bodyBuffer Buffer of response body.
protected boolean	componentsFrozen A flag that indicates that components cannot be added anymore.
protected List<CharSequence>	domReadyJavaScripts A list of scripts (JavaScript) which should be executed on the client side after the components' replacement.
protected HtmlHeaderContainer	header
protected PartialPageUpdate.ResponseBuffer	headerBuffer Buffer of response header.
protected Map<String,Component>	markupIdToComponent The component instances that will be rendered/replaced.
protected List<CharSequence>	prependJavaScripts A list of scripts (JavaScript) which should be executed on the client side before the components' replacement

Constructor Summary

Constructors

Constructor and Description
PartialPageUpdate(Page page) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(Component component, String markupId) Adds a component to be updated at the client side with its current markup
void	appendJavaScript(CharSequence javascript) Adds script to the ones which are executed after the component replacement.
protected boolean	containsAncestorFor(Component component) Checks if the target contains an ancestor for the given component
boolean	containsPage()
void	detach(IRequestCycle requestCycle) Detaches the page if at least one of its components was updated.
boolean	equals(Object o)
Collection<? extends Component>	getComponents()
IHeaderResponse	getHeaderResponse() Gets or creates an IHeaderResponse instance to use for the header contributions.
int	hashCode()
protected void	onAfterRespond(Response response) Hook-method called after components are written.
protected void	onBeforeRespond(Response response) Hook-method called before components are written.
void	prependJavaScript(CharSequence javascript) Adds script to the ones which are executed before the component replacement.
abstract void	setContentType(WebResponse response, String encoding) Sets the Content-Type header to indicate the type of the response.
protected abstract void	writeComponent(Response response, String markupId, Component component, String encoding) Writes a single component
protected abstract void	writeFooter(Response response, String encoding)
protected abstract void	writeHeader(Response response, String encoding) Writes the head part of the response.
protected abstract void	writeHeaderContribution(Response response) Writes header contribution (<link/> or <script/>) to the response.
protected void	writeHeaderContribution(Response response, Component component)
protected abstract void	writeNormalEvaluations(Response response, Collection<CharSequence> js)
protected abstract void	writePriorityEvaluations(Response response, Collection<CharSequence> js)
void	writeTo(Response response, String encoding) Serializes this object to the response.

Methods inherited from class java.lang.Object

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

Field Detail

prependJavaScripts

protected final List<CharSequence> prependJavaScripts

A list of scripts (JavaScript) which should be executed on the client side before the components' replacement

appendJavaScripts

protected final List<CharSequence> appendJavaScripts

A list of scripts (JavaScript) which should be executed on the client side after the components' replacement

domReadyJavaScripts

protected final List<CharSequence> domReadyJavaScripts

A list of scripts (JavaScript) which should be executed on the client side after the components' replacement. Executed immediately after the replacement of the components, and before appendJavaScripts

markupIdToComponent

protected final Map<String,Component> markupIdToComponent

The component instances that will be rendered/replaced.

componentsFrozen

protected transient boolean componentsFrozen

A flag that indicates that components cannot be added anymore. See https://issues.apache.org/jira/browse/WICKET-3564

See Also:

add(Component, String)

bodyBuffer

protected final PartialPageUpdate.ResponseBuffer bodyBuffer

Buffer of response body.

headerBuffer

protected final PartialPageUpdate.ResponseBuffer headerBuffer

Buffer of response header.

header

protected HtmlHeaderContainer header

Constructor Detail

PartialPageUpdate

public PartialPageUpdate(Page page)

Constructor.

Parameters:

page - the page which components are being updated.

Method Detail

writeTo

public void writeTo(Response response,
           String encoding)

Serializes this object to the response.

Parameters:

response - the response to write to

encoding - the encoding for the response

onBeforeRespond

protected void onBeforeRespond(Response response)

Hook-method called before components are written.

Parameters:

response -

onAfterRespond

protected void onAfterRespond(Response response)

Hook-method called after components are written.

Parameters:

response -

writeFooter

protected abstract void writeFooter(Response response,
               String encoding)

Parameters:

response - the response to write to

encoding - the encoding for the response

writePriorityEvaluations

protected abstract void writePriorityEvaluations(Response response,
                            Collection<CharSequence> js)

Parameters:

response - the response to write to

js - the JavaScript to evaluate

writeNormalEvaluations

protected abstract void writeNormalEvaluations(Response response,
                          Collection<CharSequence> js)

Parameters:

response - the response to write to

js - the JavaScript to evaluate

writeComponent

protected abstract void writeComponent(Response response,
                  String markupId,
                  Component component,
                  String encoding)

Writes a single component

Parameters:

response - the response to write to

markupId - the markup id to use for the component replacement

component - the component which markup will be used as replacement

encoding - the encoding for the response

writeHeader

protected abstract void writeHeader(Response response,
               String encoding)

Writes the head part of the response. For example XML preamble

Parameters:

response - the response to write to

encoding - the encoding for the response

writeHeaderContribution

protected abstract void writeHeaderContribution(Response response)

Writes header contribution (<link/> or <script/>) to the response.

Parameters:

response - the response to write to

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

appendJavaScript

public final void appendJavaScript(CharSequence javascript)

Adds script to the ones which are executed after the component replacement.

Parameters:

javascript - the javascript to execute

prependJavaScript

public final void prependJavaScript(CharSequence javascript)

Adds script to the ones which are executed before the component replacement.

Parameters:

javascript - the javascript to execute

add

public final void add(Component component,
       String markupId)
               throws IllegalArgumentException,
                      IllegalStateException

Adds a component to be updated at the client side with its current markup

Parameters:

component - the component to update

markupId - the markup id to use to find the component in the page's markup

Throws:

IllegalArgumentException - thrown when a Page or an AbstractRepeater is added

IllegalStateException - thrown when components no more can be added for replacement.

getComponents

public final Collection<? extends Component> getComponents()

Returns:

a read-only collection of all components which have been added for replacement so far.

detach

public void detach(IRequestCycle requestCycle)

Detaches the page if at least one of its components was updated.

Parameters:

requestCycle - the current request cycle

containsAncestorFor

protected boolean containsAncestorFor(Component component)

Checks if the target contains an ancestor for the given component

Parameters:

component - the component which ancestors should be checked.

Returns:

true if target contains an ancestor for the given component

containsPage

public boolean containsPage()

Returns:

true if the page has been added for replacement

getHeaderResponse

public IHeaderResponse getHeaderResponse()

Gets or creates an IHeaderResponse instance to use for the header contributions.

Returns:

IHeaderResponse instance to use for the header contributions.

writeHeaderContribution

protected void writeHeaderContribution(Response response,
                           Component component)

Parameters:

response - the response to write to

component - to component which will contribute to the header

setContentType

public abstract void setContentType(WebResponse response,
                  String encoding)

Sets the Content-Type header to indicate the type of the response.

Parameters:

response - the current we response

encoding - the encoding to use