org.apache.wicket.settings

Class PageSettings

java.lang.Object

org.apache.wicket.settings.PageSettings

public class PageSettings
extends Object

Interface for page related settings.

Author:

Jonathan Locke, Chris Turner, Eelco Hillenius, Juergen Donnerstag, Johan Compagner, Igor Vaynberg (ivaynberg), Martijn Dashorst, James Carman

Constructor Summary

Constructors

Constructor and Description
PageSettings()

Method Summary

Methods

Modifier and Type	Method and Description
PageSettings	addComponentResolver(IComponentResolver resolver) Adds a component resolver to the list.
boolean	getCallListenerInterfaceAfterExpiry()
List<IComponentResolver>	getComponentResolvers() Get the (modifiable) list of IComponentResolvers.
boolean	getRecreateBookmarkablePagesAfterExpiry() When enabled (default), urls on mounted pages will contain the full mount path, including PageParameters, allowing wicket to reinstantiate the page if got expired.
boolean	getVersionPagesByDefault()
PageSettings	setCallListenerInterfaceAfterExpiry(boolean callListenerInterfaceAfterExpiry) Sets a setting that determines whether Wicket should execute the listener interface of a component which owner page is freshly created after expiration of the old one
PageSettings	setRecreateBookmarkablePagesAfterExpiry(boolean recreateBookmarkablePagesAfterExpiry) Sets the recreateBookmarkablePagesAfterExpiry setting
PageSettings	setVersionPagesByDefault(boolean pagesVersionedByDefault) A global setting that tells the pages to update their page id if their component hierarchy changes somehow.

Methods inherited from class java.lang.Object

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

Constructor Detail

PageSettings

public PageSettings()

Method Detail

addComponentResolver

public PageSettings addComponentResolver(IComponentResolver resolver)

Adds a component resolver to the list.

Parameters:

resolver - The IComponentResolver that is added

Returns:

this object for chaining

getComponentResolvers

public List<IComponentResolver> getComponentResolvers()

Get the (modifiable) list of IComponentResolvers.

Returns:

List of ComponentResolvers

getVersionPagesByDefault

public boolean getVersionPagesByDefault()

Returns:

whether all pages should should update their page id when their component hierarchy changes somehow

setVersionPagesByDefault

public PageSettings setVersionPagesByDefault(boolean pagesVersionedByDefault)

A global setting that tells the pages to update their page id if their component hierarchy changes somehow. This way versioned pages can have several versions stored in the page stores and the user can go back and forth through the different versions. If a page is not versioned then only its last state is keep in the page stores and going back will lead the user to the page before the current one, not to the previous state of the current one.

Parameters:

pagesVersionedByDefault - a flag that indicates whether pages should increase their page id when their component hierarchy changes somehow.

Returns:

this object for chaining

getRecreateBookmarkablePagesAfterExpiry

public boolean getRecreateBookmarkablePagesAfterExpiry()

When enabled (default), urls on mounted pages will contain the full mount path, including PageParameters, allowing wicket to reinstantiate the page if got expired. When disabled, urls only use the page id. If this setting is enabled, you should take care that names form fields on mounted pages do not clash with the page parameters.

Returns:

if urls on mounted pages should be the full mount path

See Also:

WICKET-4014, WICKET-4290

setRecreateBookmarkablePagesAfterExpiry

public PageSettings setRecreateBookmarkablePagesAfterExpiry(boolean recreateBookmarkablePagesAfterExpiry)

Sets the recreateBookmarkablePagesAfterExpiry setting

Parameters:

recreateBookmarkablePagesAfterExpiry -

Returns:

this object for chaining

getCallListenerInterfaceAfterExpiry

public boolean getCallListenerInterfaceAfterExpiry()

Returns:

true if Wicket should execute the listener interface of a component which owner page is freshly created after expiration of the old one

See Also:

getRecreateBookmarkablePagesAfterExpiry(), IRequestableComponent.canCallListenerInterfaceAfterExpiry()

setCallListenerInterfaceAfterExpiry

public PageSettings setCallListenerInterfaceAfterExpiry(boolean callListenerInterfaceAfterExpiry)

Sets a setting that determines whether Wicket should execute the listener interface of a component which owner page is freshly created after expiration of the old one

Parameters:

callListenerInterfaceAfterExpiry - true if Wicket should execute the listener interface

Returns:

this object for chaining

See Also:

setRecreateBookmarkablePagesAfterExpiry(boolean), IRequestableComponent.canCallListenerInterfaceAfterExpiry()