beans

Description

The beans tag operates on a collection of the specified bean objects and iterates through that collection.

Tag Body

JSP

Restrictions

If the id attribute is specified then a collection of type and size is created. If the name attribute is specified then the collection is restored from the page context. The type attribute specifies the java class name of the object to create for the collection.

Attributes

This tag has the following attributes for which the Required values are “Yes” and “No”:

id

Name of the bean collection to create.

name

Name of the bean collection to use.

iterate

A boolean that selects iteration. Default is "false", the collection will not iterate.

type

Type of the bean; a java class name.

size

Number of beans to create for the collection.

beanid

During iteration, specifies a name by which the current bean may be retrieved from the PageContext.

Properties

This tag provides the following bean properties for which the Type values are “Integer”, “Boolean” and the Access value is “Get/Set”:

index

Index of the current bean in the collection.

count

The number of iterations the collection should perform.

start

The zero based index from which to begin iteration.

end

The zero based index that denotes the item upon which iteration will terminate.

startOne

One-based start; suitable for presentation.

endOne

One-based end; suitable for presentation.

size

The size of the collection being paged.

nextPage

Whether or not there are more items in the collection, beyond the current iterations.

prevPage

Whether there are items in the collection preceding the current iterations.

Example(s)

<%-- create a list of 5 dates and set the seconds to the index --%>
<util:beans id="dates" size="5" type="java.util.Date" iterate="true">
<util:get property="index" id="index"/>
<util:bean> 
<util:set property="seconds" id="index"/>
</util:bean>
</util:beans>

<%-- iterate through the dates collection --%>
<util:beans name="dates" iterate="true"/>
<util:bean>
date = <util:get/> 
</util:bean>
</util:beans>