org.apache.myfaces.taglib.core
Class AttributeTag

java.lang.Object
  extended by javax.servlet.jsp.tagext.TagSupport
      extended by org.apache.myfaces.taglib.core.AttributeTag
All Implemented Interfaces:
Serializable, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

@JSFJspTag(name="f:attribute",
           bodyContent="empty")
public class AttributeTag
extends javax.servlet.jsp.tagext.TagSupport

This tag associates an attribute with the nearest parent UIComponent.

When the value is not an EL expression, this tag has the same effect as calling component.getAttributes.put(name, value). When the attribute name specified matches a standard property of the component, that property is set. However it is also valid to assign attributes to components using any arbitrary name; the component itself won't make any use of these but other objects such as custom renderers, validators or action listeners can later retrieve the attribute from the component by name.

When the value is an EL expression, this tag has the same effect as calling component.setValueBinding. A call to method component.getAttributes().get(name) will then cause that expression to be evaluated and the result of the expression is returned, not the original EL expression string.

See the javadoc for UIComponent.getAttributes for more details.

Unless otherwise specified, all attributes accept static values or EL expressions.

Version:
$Revision: 693358 $ $Date: 2008-09-08 22:54:29 -0500 (Mon, 08 Sep 2008) $
Author:
Manfred Geiler (latest modification by $Author: lu4242 $), Bruno Aranda (JSR-252)
See Also:
Serialized Form

Field Summary
 
Fields inherited from class javax.servlet.jsp.tagext.TagSupport
id, pageContext
 
Fields inherited from interface javax.servlet.jsp.tagext.IterationTag
EVAL_BODY_AGAIN
 
Fields inherited from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Constructor Summary
AttributeTag()
           
 
Method Summary
 int doStartTag()
           
 void release()
          Deprecated.  
 void setName(javax.el.ValueExpression nameExpression)
          The name of the attribute.
 void setValue(javax.el.ValueExpression valueExpression)
          The attribute's value.
 
Methods inherited from class javax.servlet.jsp.tagext.TagSupport
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AttributeTag

public AttributeTag()
Method Detail

setName

@JSFJspAttribute(rtexprvalue=true,
                 className="java.lang.String")
public void setName(javax.el.ValueExpression nameExpression)
The name of the attribute.

Parameters:
nameExpression -

setValue

@JSFJspAttribute(rtexprvalue=true,
                 className="java.lang.Object")
public void setValue(javax.el.ValueExpression valueExpression)
The attribute's value.

Parameters:
valueExpression -

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException
Specified by:
doStartTag in interface javax.servlet.jsp.tagext.Tag
Overrides:
doStartTag in class javax.servlet.jsp.tagext.TagSupport
Throws:
javax.servlet.jsp.JspException

release

public void release()
Deprecated. 

Specified by:
release in interface javax.servlet.jsp.tagext.Tag
Overrides:
release in class javax.servlet.jsp.tagext.TagSupport


Copyright © 2012 The Apache Software Foundation. All Rights Reserved.