TagLib: AddressBook

entries

Description

This tag denotes a reference to the "entries" collection, as constructed by an appropriate fetch tag. 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".  This collection is typically used to contain the entries from the top level of an addressbook, which may contain contacts and groups.

Tag Body

JSP

Tag Parent

n/a

Restrictions

Address Book fetch should have happened prior to the invocation of this tag.

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
Get
count The number of iterations the collection should perform. Integer
Get/Set
start The zero-based index from which to begin iteration. Integer
Get/Set
end The zero-based index that denotes the item upon which iteration will terminate. 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
Get
nextPage Whether or not there are more items in the collection, beyond the current iterations. Boolean
Get
prevPage Whether there are items in the collection preceding the current iterations. Boolean
Get
   
 

Example(s)

<%@ page errorPage="/jsp/errorpage.jsp" %>
<%@ taglib uri="/taglibs/ips_taglib_ab.jar" prefix="ab" %>

<ab:context/>
<ab:fetch ln="$(ln)" fn="$(fn)" bp="$(bp)" em="$(em)" hp="$(
hp)" fp="$(fp)" mp="$(mp)" pp="$(pp)" sb="ln" sd="up">

          Error in Looking up address book.

</ab:fetch>

        Number of Address Book entries:

<ab:context>
  <ab:get property="numEntries"/>
</ab:context>

<ab:entries iterate="true">             
  <ab:entry>
             Entry Id: <ab:get property="entryid"/>
             First Name: <ab:get property="fn"/>
             Last Name: <ab:get property="ln"/>
             Email: <ab:get property="em"/>
  </ab:entry>
</ab:entries>