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:

java.io.Serializable, java.lang.Iterable<Component>, IEventSink, IEventSource, IClusterable, IConverterLocator, IRequestListener, IHeaderContributor, ILinkListener, IRequestableComponent, IHierarchical<Component>

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

protected PageParameters

parameters The parameters to pass to the class constructor when instantiated.

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER

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

INTERFACE

Constructor Summary

BookmarkablePageLink(java.lang.String id, java.lang.Class<C> pageClass)
Constructor.

BookmarkablePageLink(java.lang.String id, java.lang.Class<C> pageClass, PageParameters parameters)
Constructor.

Method Summary

java.lang.Class<? extends Page>	getPageClass() Get tge page class registered with the link
PageParameters	getPageParameters()
protected boolean	getStatelessHint() Returns whether the component can be stateless.
protected java.lang.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.
BookmarkablePageLink<T>	setParameter(java.lang.String property, int value) Deprecated. Use getPageParameters().set() instead
BookmarkablePageLink<T>	setParameter(java.lang.String property, long value) Deprecated. Use getPageParameters().set() instead
BookmarkablePageLink<T>	setParameter(java.lang.String property, java.lang.String value) Deprecated. Use getPageParameters().set() instead

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, getAfterDisabledLink, getBeforeDisabledLink, getBody, isLinkEnabled, onBeforeRender, onComponentTagBody, onDetach, setAfterDisabledLink, setBeforeDisabledLink, setBody

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

getWebPage, getWebRequest

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, hasAssociatedMarkup, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onMarkupAttached, onRender, 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, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, configure, continueToOriginalDestination, 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, getFeedbackMessage, 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, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, locateMarkupStream, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onConfigure, onEvent, onInitialize, onModelChanged, onModelChanging, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, 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, 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(java.lang.String id,
                            java.lang.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(java.lang.String id,
                            java.lang.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 java.lang.Class<? extends Page> getPageClass()

Get tge 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()

setParameter

@Deprecated
public BookmarkablePageLink<T> setParameter(java.lang.String property,
                                                       int value)

Deprecated. Use getPageParameters().set() instead

Adds a given page property value to this link.

Parameters:

property - The property

value - The value

Returns:

This

setParameter

@Deprecated
public BookmarkablePageLink<T> setParameter(java.lang.String property,
                                                       long value)

Deprecated. Use getPageParameters().set() instead

Adds a given page property value to this link.

Parameters:

property - The property

value - The value

Returns:

This

setParameter

@Deprecated
public BookmarkablePageLink<T> setParameter(java.lang.String property,
                                                       java.lang.String value)

Deprecated. Use getPageParameters().set() instead

Adds a given page property value to this link.

Parameters:

property - The property

value - The value

Returns:

This

getURL

protected java.lang.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()