TagLib: Mail

messages

Description

This tag denotes a reference to a collection of messages. This tag will iterate upon its body until the collection is exhausted, or as constrained by the start and count properties. The start and count properties should only be set when the iterate attribute is set to "false".

Tag Body

JSP

Tag Parent

n/a

Restrictions

None.

Attributes

This tag has the following attributes:

Attribute	Description	Req'd?
id	Name of the `entries` collection to create.	No
name	Name of the `entries` collection to use.	No
iterate	A boolean that selects iteration. Default is "false", the collection will not iterate.	No
beanid	During iteration, specifies a name by which the current bean may be retrieved from the PageContext.	No

Properties

This tag provides the following bean properties:

Property
Description
Type
Access

index Index of the current bean in the collection. Integer. Integer
Get

count The number of iterations the collection should perform. Integer. Integer
Get/Set

start The zero based index from which to begin iteration. Integer. Integer
Get/Set

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

startOne One-based start; suitable for presentation. Integer
Get

endOne One-based end; suitable for presentation. Integer

size The size of the collection being paged. Integer. Integer
Get

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

prevPage Whether there are items in the collection preceding the current iterations. Boolean Boolean
Get

Example(s)

<%-- messages tag example --%>
...
<mail:context/>
...
<mail:fetch collection="messages" id="INBOX" sb="date" sd="down"/>
...
<mail:messages id="msgs">
  <mail:set property="start" value="$(start)"/>
  <mail:set property="count" value="5"/>
</mail:messages>
<mail:messages name="msgs" iterate="true">
  <mail:message>
    <p>Subject:  <mail:get property="subject"/>
  </mail:message>
</mail:messages>