1.3 1.2 nested http://struts.apache.org/tags-nested [Since Struts 1.1]

This tag library brings a nested context to the functionality of the Struts custom tag library.

It's written in a layer that extends the current Struts tags, building on their logic and functionality. The layer enables the tags to be aware of the tags which surround them so they can correctly provide the nesting property reference to the Struts system.

It's all about nesting beans...
A bean holds a reference to another bean internally, and all access to that bean is handled through the current bean. This act of having one bean's access go through another bean is known as "nesting beans". The first bean is known as the parent bean. The bean which it references, is known as a child bean. The terms "parent" and "child" are commonly used to describe the model's hierarchy.

A simple example...
Take an object which represents a monkey. The monkey's job is to pick bunches of bananas. On each bunch picked hangs many bananas. If this case was translated to bean objects, the monkey object would have a reference to the bunch objects he picked, and each bunch object would hold a reference to the bananas hanging in the bunch.

To describe this...
The monkey object is the parent to the bunch object, and the bunch object is a child of the monkey object. The bunch object is parent to its child banana objects, and the child banana objects children of the bunch object. The monkey is higher in the hierarchy than the bananas, and the bananas lower in the hierarchy to the bunches.

One special term to remember is for the most parent class, which is known as the "root" object which starts the hierarchy.

Nested tags are all about efficiently managing this style of hierarchy structure within your JSP markup.

Important Note: Nearly all these tags extend tags from other libraries to bring their functionality into the nested context. Nesting relies on the tags working against the one bean model, and managing the properties so that they become relative to the properties they are nested within. In doing so, the tags will set the "name" attribute internally (where applicable), and in many cases will rely on the "property" attribute being set so it can be updated internally to become nested. The original tags on occasion provide options that don't use the "name" and "property" attributes. These uses will then fall outside the nested context, and will most likely cause error. To take advantage of these options, markup using the original tag for these cases. For an example see the <nested:options> tag.

]]> nest org.apache.struts.taglib.nested.NestedPropertyTag JSP Defines a new level of nesting for child tags to reference to

This tag provides a simple method of defining a logical nesting level in the nested hierarchy. It run no explicit logic, is simply a place holder. It also means you can remove the need for explicit setting of level properties in child tags.

Just as the iterate tag provide a parent to other tags, this does the same but there is no logic for iterating or otherwise.

Example...

<nested:write property="myNestedLevel.propertyOne" />
<nested:write property="myNestedLevel.propertyTwo" />
<nested:write property="myNestedLevel.propertyThree" />

Can instead become...

<nested:nest property="myNestedLevel" >
  <nested:write property="propertyOne" />
  <nested:write property="propertyTwo" />
  <nested:write property="propertyThree" />
</nested:nest >
]]> property false true writeNesting org.apache.struts.taglib.nested.NestedWriteNestingTag org.apache.struts.taglib.nested.NestedWriteNestingTei JSP Writes or makes a scripting variable of the current nesting level.

This tag provides a way of accessing the nested property reference used by the nested tags. Can expose a scripting variable, or simply write out the value. ]]> property false true id false true id is supplied, then what would have been written out into the response stream, will instead be made available as a String object defined by the variable name provided. ]]> filter false true boolean root org.apache.struts.taglib.nested.NestedRootTag JSP To start off a nested hierarchy without the need for a form

This tag is provided to allow the nested tags to find a common bean reference without the need for a form and its relative overhead. As long as the name attribute of this tag matches the name of a bean in scope of the JSP (ie: Struts tags can find it via usual means). For example you can load a bean for use with the jsp:useBean tag.

The tag can also be used without specifying the name attribute, but this is only in the case that the current JSP is a dynamic include specified in another file. You will not be able to run the tag without a name unless this inclusion is in place. Otherwise the nested tags will not have the bean and property references that they need to provide their logic.

Note: The access to a bean via the name attribute takes priority over looking for the reference from other parent tags. So if a name is specified, a bean will have to be there waiting for it. It was made this way so that you could use separate beans within a JSP that itself is an inclusion into another.

]]> name false true define org.apache.struts.taglib.nested.bean.NestedDefineTag org.apache.struts.taglib.nested.bean.NestedDefineTei empty Nested Extension - Define a scripting variable based on the value(s) of the specified bean property.

This tag is an extension of the <bean:define> tag. Please consult its documentation for information on tag attributes and usage details.

]]> id true true name false true property false true scope false true toScope false true type false true value false true message org.apache.struts.taglib.nested.bean.NestedMessageTag empty Nested Extension - Render an internationalized message string to the response.

This tag is an extension of the <bean:message> tag. Please consult its documentation for information on tag attributes and usage details.

]]> arg0 false true arg1 false true arg2 false true arg3 false true arg4 false true bundle false true key false true locale false true name false true property false true scope false true size org.apache.struts.taglib.nested.bean.NestedSizeTag org.apache.struts.taglib.bean.SizeTei empty Nested Extension - Define a bean containing the number of elements in a Collection or Map.

This tag is an extension of the <bean:size> tag. Please consult its documentation for information on tag attributes and usage details.

]]> collection false true java.lang.Object id true true name false true property false true scope false true write org.apache.struts.taglib.nested.bean.NestedWriteTag empty Nested Extension - Render the value of the specified bean property to the current JspWriter.

This tag is an extension of the <bean:write> tag. Please consult its documentation for information on tag attributes and usage details.

]]> bundle false true filter false true boolean format false true formatKey false true ignore false true boolean locale false true name false true property false true scope false true checkbox org.apache.struts.taglib.nested.html.NestedCheckboxTag Nested Extension - Render A Checkbox Input Field

This tag is an extension of the <html:checkbox> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true property true true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value false true errors org.apache.struts.taglib.nested.html.NestedErrorsTag empty Nested Extension - Conditionally display a set of accumulated error messages.

This tag is an extension of the <html:errors> tag. Please consult its documentation for information on tag attributes and usage details.

]]> bundle false true footer false true
Since:
Struts 1.2.5
]]> header false true
Since:
Struts 1.2.5
]]> locale false true name false true prefix false true
Since:
Struts 1.2.5
]]> property false true suffix false true
Since:
Struts 1.2.5
]]> file org.apache.struts.taglib.nested.html.NestedFileTag Nested Extension - Render A File Select Input Field

This tag is an extension of the <html:file> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true accept false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean maxlength false true name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true property true true size false true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value false true form org.apache.struts.taglib.nested.html.NestedFormTag JSP Nested Extension - Define An Input Form

This tag is an extension of the <html:form> tag. Please consult its documentation for information on tag attributes and usage details.

]]> action true true acceptCharset false true disabled false true boolean
Since:
Struts 1.2.7
]]> enctype false true focus false true focusIndex false true method false true onreset false true onsubmit false true readonly false true boolean
Since:
Struts 1.2.7
]]> scriptLanguage false true boolean style false true styleClass false true styleId false true target false true hidden org.apache.struts.taglib.nested.html.NestedHiddenTag Nested Extension - Render A Hidden Field

This tag is an extension of the <html:hidden> tag. Please consult its documentation for information on tag attributes and usage details.

]]> alt false true altKey false true indexed false true boolean name false true property true true title false true titleKey false true styleClass false true styleId false true value false true write false true boolean image org.apache.struts.taglib.nested.html.NestedImageTag Nested Extension - Render an input tag of type "image"

This tag is an extension of the <html:image> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true align false true alt false true altKey false true border false true bundle false true disabled false true boolean indexed false true boolean locale false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true page false true pageKey false true property false true src false true srcKey false true style false true styleClass false true tabindex false true title false true titleKey false true value false true img org.apache.struts.taglib.nested.html.NestedImgTag empty Nested Extension - Render an HTML "img" tag

This tag is an extension of the <html:img> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true align false true alt false true altKey false true border false true bundle false true height false true hspace false true imageName false true ismap false true locale false true name false true onkeydown false true onkeypress false true onkeyup false true paramId false true page false true pageKey false true action false true module false true paramName false true paramProperty false true paramScope false true property false true scope false true src false true srcKey false true style false true styleClass false true styleId false true title false true titleKey false true useLocalEncoding false true boolean usemap false true vspace false true width false true link org.apache.struts.taglib.nested.html.NestedLinkTag Nested Extension - Render an HTML anchor or hyperlink

This tag is an extension of the <html:link> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true action false true module false true anchor false true forward false true href false true indexed false true boolean indexId false true bundle false true
Since:
Struts 1.2.7
]]> linkName false true name false true onblur false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true page false true paramId false true paramName false true paramProperty false true paramScope false true property false true scope false true style false true styleClass false true styleId false true tabindex false true target false true title false true titleKey false true transaction false true boolean useLocalEncoding false true boolean messages org.apache.struts.taglib.nested.html.NestedMessagesTag org.apache.struts.taglib.html.MessagesTei JSP Nested Extension - Conditionally display a set of accumulated messages.

This tag is an extension of the <html:messages> tag. Please consult its documentation for information on tag attributes and usage details.

]]> id true true bundle false true locale false true name false true property false true header false true footer false true message false true multibox org.apache.struts.taglib.nested.html.NestedMultiboxTag Nested Extension - Render A Checkbox Input Field

This tag is an extension of the <html:multibox> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true property true true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value false true options org.apache.struts.taglib.nested.html.NestedOptionsTag empty Nested Extension - Render a Collection of Select Options

This tag is an extension of the <html:options> tag. Please consult its documentation for information on tag attributes and usage details.

Note: The nested context of this tag relies on the use of the "property" property, and the internal use of the "name" property. The nested tags rely on these properties and will attempt to set them itself. The <html:options> tag this tag extended allows other options for the tag which don't use these properties. To take advantage of these options, markup using the <html:options> tag instead of the nested tag.

For example, the "collections" option allows you to specify a separate bean reference which itself is a list of objects with properties to access the title and value parts of the html option tag. You can use this in a nested context (the list is a property of a nested bean) by using the nested define tag and the original options tag. 

<nested:nest property="myNestedLevel" />
  <nested:define property="collectionList" />
  <html:options collection="collectionList"
                  property="valueProperty"
             labelProperty="labelProperty" />
</nested:nest >
]]> collection false true java.lang.String filter false true boolean labelName false true labelProperty false true name false true property false true style false true styleClass false true optionsCollection org.apache.struts.taglib.nested.html.NestedOptionsCollectionTag empty Nested Extension - Render a Collection of Select Options

This tag is an extension of the <html:optionsCollection> tag. Please consult its documentation for information on tag attributes and usage details.

]]> filter false true boolean label false true name false true property true true style false true styleClass false true value false true password org.apache.struts.taglib.nested.html.NestedPasswordTag Nested Extension - Render A Password Input Field

This tag is an extension of the <html:password> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean maxlength false true name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true property true true readonly false true boolean redisplay false true boolean style false true styleClass false true styleId false true size false true tabindex false true title false true titleKey false true value false true radio org.apache.struts.taglib.nested.html.NestedRadioTag Nested Extension - Render A Radio Button Input Field

This tag is an extension of the <html:radio> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true property true true onmousedown false true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value true true idName false true select org.apache.struts.taglib.nested.html.NestedSelectTag JSP Nested Extension - Render A Select Element

This tag is an extension of the <html:select> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean multiple false true name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true property true true style false true styleClass false true styleId false true tabindex false true size false true title false true titleKey false true value false true submit org.apache.struts.taglib.nested.html.NestedSubmitTag Nested Extension - Render A Submit Button

This tag is an extension of the <html:submit> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean indexed false true boolean onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true property false true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value false true text org.apache.struts.taglib.nested.html.NestedTextTag Nested Extension - Render An Input Field of Type text

This tag is an extension of the <html:text> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean maxlength false true name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true onselect false true property true true readonly false true boolean size false true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value false true textarea org.apache.struts.taglib.nested.html.NestedTextareaTag Nested Extension - Render A Textarea

This tag is an extension of the <html:textarea> tag. Please consult its documentation for information on tag attributes and usage details.

]]> accesskey false true alt false true altKey false true bundle false true
Since:
Struts 1.2.7
]]> cols false true disabled false true boolean errorKey false true
Since:
Struts 1.2.5
]]> errorStyle false true
Since:
Struts 1.2.5
]]> errorStyleClass false true
Since:
Struts 1.2.5
]]> errorStyleId false true
Since:
Struts 1.2.5
]]> indexed false true boolean name false true onblur false true onchange false true onclick false true ondblclick false true onfocus false true onkeydown false true onkeypress false true onkeyup false true onmousedown false true onmousemove false true onmouseout false true onmouseover false true onmouseup false true onselect false true property true true readonly false true boolean rows false true style false true styleClass false true styleId false true tabindex false true title false true titleKey false true value false true empty org.apache.struts.taglib.nested.logic.NestedEmptyTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is either null or an empty string.

This tag is an extension of the <logic:empty> tag. Please consult its documentation for information on tag attributes and usage details.

]]> name false true property false true scope false true equal org.apache.struts.taglib.nested.logic.NestedEqualTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is equal to the specified value.

This tag is an extension of the <logic:equal> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true scope false true value true true greaterEqual org.apache.struts.taglib.nested.logic.NestedGreaterEqualTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is greater than or equal to the specified value.

This tag is an extension of the <logic:greaterEqual> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true scope false true value true true greaterThan org.apache.struts.taglib.nested.logic.NestedGreaterThanTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is greater than the specified value.

This tag is an extension of the <logic:greaterThan> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true scope false true value true true iterate org.apache.struts.taglib.nested.logic.NestedIterateTag org.apache.struts.taglib.nested.logic.NestedIterateTei JSP Nested Extension - Repeat the nested body content of this tag over a specified collection.

This tag is an extension of the <logic:iterate> tag. Please consult its documentation for information on tag attributes and usage details.

]]> collection false true java.lang.Object id false true indexId false true length false true name false true offset false true property false true scope false true type false true lessEqual org.apache.struts.taglib.nested.logic.NestedLessEqualTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is greater than or equal to the specified value.

This tag is an extension of the <logic:lessEqual> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true scope false true value true true lessThan org.apache.struts.taglib.nested.logic.NestedLessThanTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is less than the specified value.

This tag is an extension of the <logic:lessThan> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true scope false true value true true match org.apache.struts.taglib.nested.logic.NestedMatchTag JSP Nested Extension - Evaluate the nested body content of this tag if the specified value is an appropriate substring of the requested variable.

This tag is an extension of the <logic:match> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true location false true name false true parameter false true property false true scope false true value true true messagesNotPresent org.apache.struts.taglib.nested.logic.NestedMessagesNotPresentTag JSP Nested Extension - Generate the nested body content of this tag if the specified message is not present in this request.

This tag is an extension of the <logic:messagesNotPresent> tag. Please consult its documentation for information on tag attributes and usage details.

]]> name false true property false true message false true messagesPresent org.apache.struts.taglib.nested.logic.NestedMessagesPresentTag JSP Nested Extension - Generate the nested body content of this tag if the specified message is present in this request.

This tag is an extension of the <logic:messagesPresent> tag. Please consult its documentation for information on tag attributes and usage details.

]]> name false true property false true message false true notEmpty org.apache.struts.taglib.nested.logic.NestedNotEmptyTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is neither null nor an empty string.

This tag is an extension of the <logic:notEmpty> tag. Please consult its documentation for information on tag attributes and usage details.

]]> name false true property false true scope false true notEqual org.apache.struts.taglib.nested.logic.NestedNotEqualTag JSP Nested Extension - Evaluate the nested body content of this tag if the requested variable is not equal to the specified value.

This tag is an extension of the <logic:notEqual> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true scope false true value true true notMatch org.apache.struts.taglib.nested.logic.NestedNotMatchTag JSP Nested Extension - Evaluate the nested body content of this tag if the specified value is not an appropriate substring of the requested variable.

This tag is an extension of the <logic:notMatch> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true location false true name false true parameter false true property false true scope false true value true true notPresent org.apache.struts.taglib.nested.logic.NestedNotPresentTag JSP Nested Extension - Generate the nested body content of this tag if the specified value is not present in this request.

This tag is an extension of the <logic:notPresent> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true role false true scope false true user false true present org.apache.struts.taglib.nested.logic.NestedPresentTag JSP Nested Extension - Generate the nested body content of this tag if the specified value is present in this request.

This tag is an extension of the <logic:present> tag. Please consult its documentation for information on tag attributes and usage details.

]]> cookie false true header false true name false true parameter false true property false true role false true scope false true user false true