org.apache.wicket.ajax.markup.html
Class AjaxLink<T>

java.lang.Object
  extended by org.apache.wicket.Component
      extended by org.apache.wicket.MarkupContainer
          extended by org.apache.wicket.markup.html.WebMarkupContainer
              extended by org.apache.wicket.markup.html.link.AbstractLink
                  extended by org.apache.wicket.ajax.markup.html.AjaxLink<T>
Type Parameters:
T - type of model object
All Implemented Interfaces:
java.io.Serializable, java.lang.Iterable<Component>, IAjaxLink, IEventSink, IEventSource, IClusterable, IConverterLocator, IHeaderContributor, IRequestableComponent, IHierarchical<Component>
Direct Known Subclasses:
IndicatingAjaxLink

public abstract class AjaxLink<T>
extends AbstractLink
implements IAjaxLink

A component that allows a trigger request to be triggered via html anchor tag

Since:
1.2
Author:
Igor Vaynberg (ivaynberg)
See Also:
Serialized Form

Field Summary
 
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
 
Constructor Summary
AjaxLink(java.lang.String id)
          Construct.
AjaxLink(java.lang.String id, IModel<T> model)
          Construct.
 
Method Summary
protected  IAjaxCallDecorator getAjaxCallDecorator()
          Returns ajax call decorator that will be used to decorate the ajax call.
protected  AjaxChannel getChannel()
           
 IModel<T> getModel()
          Gets model
 T getModelObject()
          Gets model object
protected  AjaxEventBehavior newAjaxEventBehavior(java.lang.String event)
           
abstract  void onClick(AjaxRequestTarget target)
          Listener method invoked on the ajax request generated when the user clicks the link
protected  void onComponentTag(ComponentTag tag)
          Processes the component tag.
protected  void onInitialize()
          This method is meant to be used as an alternative to initialize components.
 void setModel(IModel<T> model)
          Sets model
 void setModelObject(T object)
          Sets model object
 
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, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, locateMarkupStream, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onConfigure, onEvent, 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
 

Constructor Detail

AjaxLink

public AjaxLink(java.lang.String id)
Construct.

Parameters:
id -

AjaxLink

public AjaxLink(java.lang.String id,
                IModel<T> model)
Construct.

Parameters:
id -
model -
Method Detail

onInitialize

protected void onInitialize()
Description copied from class: Component
This method is meant to be used as an alternative to initialize components. Usually the component's constructor is used for this task, but sometimes a component cannot be initialized in isolation, it may need to access its parent component or its markup in order to fully initialize. This method is invoked once per component's lifecycle when a path exists from this component to the Page thus providing the component with an atomic callback when the component's environment is built out.

Overrides must call super#Component.onInitialize(). Usually this should be the first thing an override does, much like a constructor.

Parent containers are guaranteed to be initialized before their children

It is safe to use Component.getPage() in this method

NOTE:The timing of this call is not precise, the contract is that it is called sometime before Component.onBeforeRender().

Overrides:
onInitialize in class Component

newAjaxEventBehavior

protected AjaxEventBehavior newAjaxEventBehavior(java.lang.String event)
Parameters:
event - the name of the default event on which this link will listen to
Returns:
the ajax behavior which will be executed when the user clicks the link

getChannel

protected AjaxChannel getChannel()
Returns:
the channel that manages how Ajax calls are executed
See Also:
AbstractDefaultAjaxBehavior.getChannel()

onComponentTag

protected void onComponentTag(ComponentTag tag)
Description copied from class: Component
Processes the component tag. Overrides of this method most likely should call the super implementation.

Overrides:
onComponentTag in class Component
Parameters:
tag - Tag to modify

getAjaxCallDecorator

protected IAjaxCallDecorator getAjaxCallDecorator()
Returns ajax call decorator that will be used to decorate the ajax call.

Returns:
ajax call decorator

onClick

public abstract void onClick(AjaxRequestTarget target)
Listener method invoked on the ajax request generated when the user clicks the link

Specified by:
onClick in interface IAjaxLink
Parameters:
target -

getModel

public final IModel<T> getModel()
Gets model

Returns:
model

setModel

public final void setModel(IModel<T> model)
Sets model

Parameters:
model -

getModelObject

public final T getModelObject()
Gets model object

Returns:
model object

setModelObject

public final void setModelObject(T object)
Sets model object

Parameters:
object -


Copyright © 2006-2011 Apache Software Foundation. All Rights Reserved.