PutTag (Apache Struts API Documentation)

Put an attribute in enclosing attribute container tag. Enclosing attribute container tag can be : <insert> or <definition>. Exception is thrown if no appropriate tag can be found. Put tag can have following atributes :

name : Name of the attribute

value | content : value to put as attribute

type : value type. Only valid if value is a String and is set by value="something" or by a bean. Possible type are : string (value is used as direct string), page | template (value is used as a page url to insert), definition (value is used as a definition name to insert)

direct : Specify if value is to be used as a direct string or as a page url to insert. This is another way to specify the type. It only apply if value is set as a string, and type is not present.

beanName : Name of a bean used for setting value. Only valid if value is not set. If property is specified, value come from bean's property. Otherwise, bean itself is used for value.

beanProperty : Name of the property used for retrieving value.

beanScope : Scope containing bean.

role : Role to check when 'insert' will be called. If enclosing tag is <insert>, role is checked immediately. If enclosing tag is <definition>, role will be checked when this definition will be inserted.

Value can also come from tag body. Tag body is taken into account only if value is not set by one of the tag attributes. In this case Attribute type is "string", unless tag body define another type.

Field Summary
protected String	attributeName Name of attribute to put in component context.
String	beanName Bean name attribute.
String	beanProperty Bean property attribute.
String	beanScope Bean scope attribute.
protected String	body The body content of this tag.
String	direct JSP Template compatibility.
protected Object	realValue Cached real value computed from tag attributes.
String	role Role attribute.
Object	value Associated attribute value.
String	valueType Requested type for the value.

Constructor Summary
	PutTag() Default constructor.

Method Summary
protected void	callParent() Find parent tag which must implement AttributeContainer.
protected void	computeRealValue() Compute real value according to tag attributes.
int	doAfterBody() Save the body content of this tag (if any)
int	doEndTag() Do end tag.
int	doStartTag() Do start tag.
protected PutTagParent	findEnclosingPutTagParent() Find parent tag which must implement AttributeContainer.
String	getBeanName() Get bean name.
String	getBeanProperty() Get bean property.
String	getBeanScope() Get bean scope.
String	getContent() Get content.
String	getName() Get name.
Object	getRealValue() Get real value according to tag attribute.
protected void	getRealValueFromBean() Extract real value from specified bean.
String	getRole() Get role attribute
String	getType() Get type.
String	getValue() Get value.
void	release() Release all allocated resources.
protected void	releaseInternal() Release internal properties.
void	setBeanName(String value) Set bean name.
void	setBeanProperty(String value) Set bean property.
void	setBeanScope(String value) Set bean scope.
void	setContent(String value) Set content.
void	setContent(Object value) Set content.
void	setDirect(String isDirect) Set direct.
void	setName(String value) Set name.
void	setObjectValue(Object value) Set property value as an object.
void	setRole(String role) Set role attribute.
void	setType(String value) Set type.
void	setValue(String value) Set value.
void	setValue(Object value) Set value.

Get real value according to tag attribute. Real value is the value computed after attribute processing.

Returns: Real value.

Throws: JspException If something goes wrong while getting value from bean.

Class PutTag