org.apache.tapestry.link

Class AbstractLinkComponent

java.lang.Object

org.apache.hivemind.impl.BaseLocatable

org.apache.tapestry.AbstractComponent

org.apache.tapestry.link.AbstractLinkComponent

All Implemented Interfaces:

org.apache.hivemind.Locatable, org.apache.hivemind.LocationHolder, ILinkComponent, IComponent, IRender

Direct Known Subclasses:

ActionLink, DirectLink, ExternalLink, GenericLink, PageLink, ServiceLink

public abstract class AbstractLinkComponent
extends AbstractComponent
implements ILinkComponent

Base class for implementations of ILinkComponent. Includes a disabled attribute (that should be bound to a disabled parameter), an anchor attribute, and a renderer attribute (that should be bound to a renderer parameter). A default, shared instance of DefaultLinkRenderer is used when no specific renderer is provided.

Author:

Howard Lewis Ship

Constructor Summary

Constructors

Constructor and Description
AbstractLinkComponent()

Method Summary

Methods

Modifier and Type	Method and Description
void	addEventHandler(LinkEventType eventType, java.lang.String functionName) Adds an event handler (typically, from a wrapped component such as a Rollover).
protected void	cleanupAfterRender(IRequestCycle cycle) Invoked by AbstractComponent.render(IMarkupWriter, IRequestCycle)after the component renders.
protected void	finishLoad() Sets the renderer parameter property to its default value DefaultLinkRenderer.SHARED_INSTANCE.
abstract java.lang.String	getAnchor() Returns the anchor defined for this link, or null for no anchor.
ILink	getLink(IRequestCycle cycle) Invoked by the ILinkRenderer (if the link is not disabled) to provide a EngineServiceLink that the renderer can convert into a URL.
protected ILink	getLink(IRequestCycle cycle, java.lang.String serviceName, java.lang.Object parameter) Deprecated. To be removed in 4.1; links may now have the necessary engine service injected.
abstract ILinkRenderer	getRenderer()
abstract boolean	isDisabled() Returns whether this service link component is enabled or disabled.
void	renderAdditionalAttributes(IMarkupWriter writer, IRequestCycle cycle) Invoked (by the ILinkRenderer) to make the link render any additional attributes.
protected void	renderComponent(IMarkupWriter writer, IRequestCycle cycle) Renders the link by delegating to an instance of ILinkRenderer.
abstract void	setRenderer(ILinkRenderer renderer)
protected java.lang.String	writeEventHandler(IMarkupWriter writer, PageRenderSupport pageRenderSupport, java.lang.String name, java.lang.String attributeName, java.lang.Object value)
protected void	writeEventHandlers(IMarkupWriter writer, IRequestCycle cycle)

Methods inherited from class org.apache.tapestry.AbstractComponent

addAsset, addBody, addComponent, checkActiveLock, enterActiveState, finishLoad, format, format, format, format, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getComponent, getComponents, getContainedComponent, getContainer, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, isInActiveState, isParameterBound, isRendering, pageEndRender, prepareForRender, render, renderBody, renderInformalParameters, setBinding, setContainedComponent, setContainer, setId, setNamespace, setPage, setProperty, toString

Methods inherited from class org.apache.hivemind.impl.BaseLocatable

getLocation, setLocation

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.tapestry.components.ILinkComponent

getPort, getScheme, getTarget

Methods inherited from interface org.apache.tapestry.IComponent

addAsset, addBody, addComponent, enterActiveState, finishLoad, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getComponent, getComponents, getContainedComponent, getContainer, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, isRendering, renderBody, setBinding, setContainedComponent, setContainer, setId, setNamespace, setPage, setProperty

Methods inherited from interface org.apache.tapestry.IRender

render

Methods inherited from interface org.apache.hivemind.LocationHolder

setLocation

Methods inherited from interface org.apache.hivemind.Locatable

getLocation

Constructor Detail

AbstractLinkComponent

public AbstractLinkComponent()

Method Detail

isDisabled

public abstract boolean isDisabled()

Description copied from interface: ILinkComponent

Returns whether this service link component is enabled or disabled.

Specified by:

isDisabled in interface ILinkComponent

addEventHandler

public void addEventHandler(LinkEventType eventType,
                   java.lang.String functionName)

Adds an event handler (typically, from a wrapped component such as a Rollover).

Specified by:

addEventHandler in interface ILinkComponent

renderComponent

protected void renderComponent(IMarkupWriter writer,
                   IRequestCycle cycle)

Renders the link by delegating to an instance of ILinkRenderer.

Specified by:

renderComponent in class AbstractComponent

cleanupAfterRender

protected void cleanupAfterRender(IRequestCycle cycle)

Description copied from class: AbstractComponent

Invoked by AbstractComponent.render(IMarkupWriter, IRequestCycle)after the component renders. This implementation does nothing.

Overrides:

cleanupAfterRender in class AbstractComponent

writeEventHandlers

protected void writeEventHandlers(IMarkupWriter writer,
                      IRequestCycle cycle)

writeEventHandler

protected java.lang.String writeEventHandler(IMarkupWriter writer,
                                 PageRenderSupport pageRenderSupport,
                                 java.lang.String name,
                                 java.lang.String attributeName,
                                 java.lang.Object value)

getRenderer

public abstract ILinkRenderer getRenderer()

Since:

3.0 *

setRenderer

public abstract void setRenderer(ILinkRenderer renderer)

renderAdditionalAttributes

public void renderAdditionalAttributes(IMarkupWriter writer,
                              IRequestCycle cycle)

Description copied from interface: ILinkComponent

Invoked (by the ILinkRenderer) to make the link render any additional attributes. These are informal parameters, plus any attributes related to events. This is only invoked for non-disabled links.

Specified by:

renderAdditionalAttributes in interface ILinkComponent

getLink

protected ILink getLink(IRequestCycle cycle,
            java.lang.String serviceName,
            java.lang.Object parameter)

Deprecated. To be removed in 4.1; links may now have the necessary engine service injected.

Utility method for subclasses; Gets the named service from the engine and invokes IEngineService#getLink(org.apache.tapestry.IComponent, Object[])on it.

Since:

3.0

getAnchor

public abstract java.lang.String getAnchor()

Description copied from interface: ILinkComponent

Returns the anchor defined for this link, or null for no anchor.

Specified by:

getAnchor in interface ILinkComponent

getLink

public ILink getLink(IRequestCycle cycle)

Description copied from interface: ILinkComponent

Invoked by the ILinkRenderer (if the link is not disabled) to provide a EngineServiceLink that the renderer can convert into a URL.

Specified by:

getLink in interface ILinkComponent

finishLoad

protected void finishLoad()

Sets the renderer parameter property to its default value DefaultLinkRenderer.SHARED_INSTANCE.

Overrides:

finishLoad in class AbstractComponent

Since:

3.0