org.apache.wicket.markup.html.link

Class BookmarkablePageLink<T>

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

org.apache.wicket.markup.html.link.AbstractLink

org.apache.wicket.markup.html.link.Link<T>

org.apache.wicket.markup.html.link.BookmarkablePageLink<T>

Type Parameters:

T - type of model object, if any

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IConverterLocator, IGenericComponent<T>, IRequestListener, IHeaderContributor, ILinkListener, IRequestableComponent, IHierarchical<Component>, IClusterable

Direct Known Subclasses:

AutoLinkResolver.AutolinkBookmarkablePageLink

public class BookmarkablePageLink<T>
extends Link<T>

Renders a stable link which can be cached in a web browser and used at a later time.

Author:

Jonathan Locke

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected PageParameters	parameters The parameters to pass to the class constructor when instantiated.

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_AFTER_RENDERING, FLAG_INITIALIZED, FLAG_PREPARED_FOR_RENDER, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RENDERING, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING

Fields inherited from interface org.apache.wicket.markup.html.link.ILinkListener

INTERFACE

Constructor Summary

Constructors

Constructor and Description
BookmarkablePageLink(String id, Class<C> pageClass) Constructor.
BookmarkablePageLink(String id, Class<C> pageClass, PageParameters parameters) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
Class<? extends Page>	getPageClass() Get the page class registered with the link
PageParameters	getPageParameters()
protected boolean	getStatelessHint() Returns whether the component can be stateless.
protected CharSequence	getURL() Gets the url to use for this link.
boolean	linksTo(Page page) Whether this link refers to the given page.
void	onClick() THIS METHOD IS NOT USED! Bookmarkable links do not have a click handler.

Methods inherited from class org.apache.wicket.markup.html.link.Link

appendAnchor, getAnchor, getAutoEnable, getModel, getModelObject, getOnClickScript, getPopupSettings, isEnabled, onComponentTag, onLinkClicked, setAnchor, setAutoEnable, setModel, setModelObject, setPopupSettings

Methods inherited from class org.apache.wicket.markup.html.link.AbstractLink

disableLink, getBody, onComponentTagBody, onDetach, setBody

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onAfterRenderChildren, onInitialize, onRender, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, canCallListenerInterface, canCallListenerInterfaceAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onBeforeRender, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Field Detail

parameters

protected PageParameters parameters

The parameters to pass to the class constructor when instantiated.

Constructor Detail

BookmarkablePageLink

public BookmarkablePageLink(String id,
                    Class<C> pageClass)

Constructor.

Type Parameters:

C - type of page

Parameters:

id - The name of this component

pageClass - The class of page to link to

BookmarkablePageLink

public BookmarkablePageLink(String id,
                    Class<C> pageClass,
                    PageParameters parameters)

Constructor.

Type Parameters:

C -

Parameters:

id - See Component

pageClass - The class of page to link to

parameters - The parameters to pass to the new page when the link is clicked

Method Detail

getPageParameters

public PageParameters getPageParameters()

Returns:

page parameters

getPageClass

public final Class<? extends Page> getPageClass()

Get the page class registered with the link

Returns:

Page class

linksTo

public boolean linksTo(Page page)

Whether this link refers to the given page.

Overrides:

linksTo in class Link<T>

Parameters:

page - the page

Returns:

True if this link goes to the given page

See Also:

Link.linksTo(org.apache.wicket.Page)

getStatelessHint

protected boolean getStatelessHint()

Description copied from class: Component

Returns whether the component can be stateless. Also the component behaviors must be stateless, otherwise the component will be treat as stateful. In order for page to be stateless (and not to be stored in session), all components (and component behaviors) must be stateless.

Overrides:

getStatelessHint in class Link<T>

Returns:

whether the component can be stateless

See Also:

Component.getStatelessHint()

onClick

public final void onClick()

THIS METHOD IS NOT USED! Bookmarkable links do not have a click handler. It is here to satisfy the interface only, as bookmarkable links will be dispatched by the handling servlet.

Specified by:

onClick in class Link<T>

See Also:

Link.onClick()

getURL

protected CharSequence getURL()

Gets the url to use for this link.

Overrides:

getURL in class Link<T>

Returns:

The URL that this link links to

See Also:

Link.getURL()