Apache Struts API Documentation: Class LinkTag

Apache Struts API


org.apache.struts.taglib.html Class LinkTag

java.lang.Object
  |
  +--javax.servlet.jsp.tagext.TagSupport
        |
        +--javax.servlet.jsp.tagext.BodyTagSupport
              |
              +--org.apache.struts.taglib.html.BaseHandlerTag
                    |
                    +--org.apache.struts.taglib.html.LinkTag
All Implemented Interfaces:
javax.servlet.jsp.tagext.BodyTag, java.io.Serializable, javax.servlet.jsp.tagext.Tag
Direct Known Subclasses:
FrameTag, NestedLinkTag, RewriteTag

public class LinkTag
extends BaseHandlerTag

Generate a URL-encoded hyperlink to the specified URI.

Version:
$Rev: 164530 $ $Date: 2005-04-25 04:11:07 +0100 (Mon, 25 Apr 2005) $
See Also:
Serialized Form

Field Summary
protected  java.lang.String action
          The module-relative action (beginning with a slash) which will be called by this link
protected  java.lang.String anchor
          The anchor to be added to the end of the generated hyperlink.
protected  java.lang.String forward
          The logical forward name from which to retrieve the hyperlink URI.
protected  java.lang.String href
          The hyperlink URI.
protected  java.lang.String indexId
          Name of parameter to generate to hold index number
protected  java.lang.String linkName
          The link name for named links.
protected static MessageResources messages
          The message resources for this package.
protected  java.lang.String module
          The module prefix (beginning with a slash) which will be used to find the action for this link.
protected  java.lang.String name
          The JSP bean name for query parameters.
protected  java.lang.String page
          The module-relative page URL (beginning with a slash) to which this hyperlink will be rendered.
protected  java.lang.String paramId
          The single-parameter request parameter name to generate.
protected  java.lang.String paramName
          The single-parameter JSP bean name.
protected  java.lang.String paramProperty
          The single-parameter JSP bean property.
protected  java.lang.String paramScope
          The single-parameter JSP bean scope.
protected  java.lang.String property
          The JSP bean property name for query parameters.
protected  java.lang.String scope
          The scope of the bean specified by the name property, if any.
protected  java.lang.String target
          The window target.
protected  java.lang.String text
          The body content of this tag (if any).
protected  boolean transaction
          Include transaction token (if any) in the hyperlink?
protected  boolean useLocalEncoding
           
 
Fields inherited from class org.apache.struts.taglib.html.BaseHandlerTag
accesskey, alt, altKey, bundle, defaultLocale, disabled, doDisabled, doReadonly, errorKey, errorStyle, errorStyleClass, errorStyleId, indexed, locale, log, loopTagStatusClass, loopTagStatusGetIndex, loopTagSupportClass, loopTagSupportGetStatus, onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect, readonly, style, styleClass, styleId, tabindex, title, titleKey, triedJstlInit, triedJstlSuccess
 
Fields inherited from class javax.servlet.jsp.tagext.BodyTagSupport
bodyContent
 
Fields inherited from class javax.servlet.jsp.tagext.TagSupport
id, pageContext, parent, values
 
Fields inherited from interface javax.servlet.jsp.tagext.BodyTag
EVAL_BODY_TAG
 
Fields inherited from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Constructor Summary
LinkTag()
           
 
Method Summary
protected  java.lang.String calculateURL()
          Return the complete URL to which this hyperlink will direct the user.
 int doAfterBody()
          Save the associated label from the body content.
 int doEndTag()
          Render the end of the hyperlink.
 int doStartTag()
          Render the beginning of the hyperlink.
 java.lang.String getAction()
           
 java.lang.String getAnchor()
           
 java.lang.String getForward()
           
 java.lang.String getHref()
           
 java.lang.String getIndexId()
           
 java.lang.String getLinkName()
           
 java.lang.String getModule()
           
 java.lang.String getName()
           
 java.lang.String getPage()
           
 java.lang.String getParamId()
           
 java.lang.String getParamName()
           
 java.lang.String getParamProperty()
           
 java.lang.String getParamScope()
           
 java.lang.String getProperty()
           
 java.lang.String getScope()
           
 java.lang.String getTarget()
           
 boolean getTransaction()
           
 boolean isUseLocalEncoding()
           
 void release()
          Release any acquired resources.
 void setAction(java.lang.String action)
           
 void setAnchor(java.lang.String anchor)
           
 void setForward(java.lang.String forward)
           
 void setHref(java.lang.String href)
           
 void setIndexId(java.lang.String indexId)
           
 void setLinkName(java.lang.String linkName)
           
 void setModule(java.lang.String module)
           
 void setName(java.lang.String name)
           
 void setPage(java.lang.String page)
           
 void setParamId(java.lang.String paramId)
           
 void setParamName(java.lang.String paramName)
           
 void setParamProperty(java.lang.String paramProperty)
           
 void setParamScope(java.lang.String paramScope)
           
 void setProperty(java.lang.String property)
           
 void setScope(java.lang.String scope)
           
 void setTarget(java.lang.String target)
           
 void setTransaction(boolean transaction)
           
 void setUseLocalEncoding(boolean b)
           
 
Methods inherited from class org.apache.struts.taglib.html.BaseHandlerTag
doErrorsExist, getAccesskey, getAlt, getAltKey, getBundle, getDisabled, getElementClose, getErrorKey, getErrorStyle, getErrorStyleClass, getErrorStyleId, getIndexed, getIndexValue, getJstlLoopIndex, getLocale, getOnblur, getOnchange, getOnclick, getOndblclick, getOnfocus, getOnkeydown, getOnkeypress, getOnkeyup, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getOnselect, getReadonly, getStyle, getStyleClass, getStyleId, getTabindex, getTitle, getTitleKey, isXhtml, lookupProperty, message, prepareAttribute, prepareEventHandlers, prepareFocusEvents, prepareIndex, prepareKeyEvents, prepareMouseEvents, prepareName, prepareOtherAttributes, prepareStyles, prepareTextEvents, setAccesskey, setAlt, setAltKey, setBundle, setDisabled, setErrorKey, setErrorStyle, setErrorStyleClass, setErrorStyleId, setIndexed, setLocale, setOnblur, setOnchange, setOnclick, setOndblclick, setOnfocus, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnselect, setReadonly, setStyle, setStyleClass, setStyleId, setTabindex, setTitle, setTitleKey
 
Methods inherited from class javax.servlet.jsp.tagext.BodyTagSupport
doInitBody, getBodyContent, getPreviousOut, setBodyContent
 
Methods inherited from class javax.servlet.jsp.tagext.TagSupport
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 
Methods inherited from interface javax.servlet.jsp.tagext.Tag
getParent, setPageContext, setParent
 

Field Detail

text

protected java.lang.String text
The body content of this tag (if any).

anchor

protected java.lang.String anchor
The anchor to be added to the end of the generated hyperlink.

forward

protected java.lang.String forward

The logical forward name from which to retrieve the hyperlink URI.

Usage note: If a forward config is used in a hyperlink, and a module is specified, the path must lead to another action and not directly to a page. This is in keeping with rule that in a modular application all links must be to an action rather than a page.


href

protected java.lang.String href
The hyperlink URI.

linkName

protected java.lang.String linkName
The link name for named links.

messages

protected static MessageResources messages
The message resources for this package.

name

protected java.lang.String name
The JSP bean name for query parameters.

page

protected java.lang.String page
The module-relative page URL (beginning with a slash) to which this hyperlink will be rendered.

action

protected java.lang.String action
The module-relative action (beginning with a slash) which will be called by this link

module

protected java.lang.String module
The module prefix (beginning with a slash) which will be used to find the action for this link.

paramId

protected java.lang.String paramId
The single-parameter request parameter name to generate.

paramName

protected java.lang.String paramName
The single-parameter JSP bean name.

paramProperty

protected java.lang.String paramProperty
The single-parameter JSP bean property.

paramScope

protected java.lang.String paramScope
The single-parameter JSP bean scope.

property

protected java.lang.String property
The JSP bean property name for query parameters.

scope

protected java.lang.String scope
The scope of the bean specified by the name property, if any.

target

protected java.lang.String target
The window target.

transaction

protected boolean transaction
Include transaction token (if any) in the hyperlink?

indexId

protected java.lang.String indexId
Name of parameter to generate to hold index number

useLocalEncoding

protected boolean useLocalEncoding
Constructor Detail

LinkTag

public LinkTag()
Method Detail

getAnchor

public java.lang.String getAnchor()

setAnchor

public void setAnchor(java.lang.String anchor)

getForward

public java.lang.String getForward()

setForward

public void setForward(java.lang.String forward)

getHref

public java.lang.String getHref()

setHref

public void setHref(java.lang.String href)

getLinkName

public java.lang.String getLinkName()

setLinkName

public void setLinkName(java.lang.String linkName)

getName

public java.lang.String getName()

setName

public void setName(java.lang.String name)

getPage

public java.lang.String getPage()

setPage

public void setPage(java.lang.String page)

getAction

public java.lang.String getAction()

setAction

public void setAction(java.lang.String action)

getModule

public java.lang.String getModule()

setModule

public void setModule(java.lang.String module)

getParamId

public java.lang.String getParamId()

setParamId

public void setParamId(java.lang.String paramId)

getParamName

public java.lang.String getParamName()

setParamName

public void setParamName(java.lang.String paramName)

getParamProperty

public java.lang.String getParamProperty()

setParamProperty

public void setParamProperty(java.lang.String paramProperty)

getParamScope

public java.lang.String getParamScope()

setParamScope

public void setParamScope(java.lang.String paramScope)

getProperty

public java.lang.String getProperty()

setProperty

public void setProperty(java.lang.String property)

getScope

public java.lang.String getScope()

setScope

public void setScope(java.lang.String scope)

getTarget

public java.lang.String getTarget()

setTarget

public void setTarget(java.lang.String target)

getTransaction

public boolean getTransaction()

setTransaction

public void setTransaction(boolean transaction)

getIndexId

public java.lang.String getIndexId()

setIndexId

public void setIndexId(java.lang.String indexId)

isUseLocalEncoding

public boolean isUseLocalEncoding()

setUseLocalEncoding

public void setUseLocalEncoding(boolean b)

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException
Render the beginning of the hyperlink.

Support for indexed property since Struts 1.1

Overrides:
doStartTag in class javax.servlet.jsp.tagext.BodyTagSupport
Throws:
javax.servlet.jsp.JspException - if a JSP exception has occurred

doAfterBody

public int doAfterBody()
                throws javax.servlet.jsp.JspException
Save the associated label from the body content.
Overrides:
doAfterBody in class javax.servlet.jsp.tagext.BodyTagSupport
Throws:
javax.servlet.jsp.JspException - if a JSP exception has occurred

doEndTag

public int doEndTag()
             throws javax.servlet.jsp.JspException
Render the end of the hyperlink.
Overrides:
doEndTag in class javax.servlet.jsp.tagext.BodyTagSupport
Throws:
javax.servlet.jsp.JspException - if a JSP exception has occurred

release

public void release()
Release any acquired resources.
Overrides:
release in class BaseHandlerTag

calculateURL

protected java.lang.String calculateURL()
                                 throws javax.servlet.jsp.JspException
Return the complete URL to which this hyperlink will direct the user. Support for indexed property since Struts 1.1
Throws:
javax.servlet.jsp.JspException - if an exception is thrown calculating the value


Copyright � 2000-2005 - The Apache Software Foundation