INameList

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> com >> clra >> [ web overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.clra.web
Interface INameList

All Known Subinterfaces:: IMemberNameList

All Known Implementing Classes:: MemberSet

public interface INameList

Declares JSP attributes and bean properties for alphabetized lists of stuff. Views that implement this interface may be controlled via components such as NameSelector.

For Java Server Pages, this interface declares three attributes that should be set and accessed within the scope of a request or session:

restricted: is the view restricted to a range of items with names that start with a particular group of letters? [true,false]
group: if the view is restricted, the group of letters with the name of an item should begin.
comparator: specifies a bean that implements java.util.Comparator which can compare instances of INamed. The current implementation of NameSelector does not use the value of this attribute.

The Integer value specified by group refers to predefined groups:

ABC - names less than 'D'
DEF - names between 'D' and 'F'
GHI - names between 'G' and 'I'
JKL - names between 'J' and 'L'
MNO - names between 'M' and 'O'
PQRS - names between 'P' and 'S'
TUV - names between 'T' and 'V'
WXYZ - names greater than or equal to 'W'

Note that the first group, ABC, may contain names like "3Com", whereas the last group, WXYZ, may contain names like "Ëtvos". Also note that the group index is indexed from '1', not '0'.

For beans, this interface declares five properties:

restricted: read/write Boolean
group: read/write Integer
comparator: read/write java.util.Comparator, compares instances of INamed
iterator: read-only iterator of INamed instances

Version:: $Revision: 1.3 $ $Date: 2003/02/26 03:38:46 $

Field Summary

static java.lang.String AN_COMPARATOR
          Names an attribute within the scope of an HTTP request or session that holds a bean which implements java.util.Comparator.

static java.lang.String AN_GROUP
          Names an attribute within the scope of an HTTP request or session whose char[] value indicates the letters that with which a item name should begin within a restricted list.

static java.lang.String AN_ISRESTRICTED
          Names an attribute within the scope of an HTTP request or session whose Boolean value indicates whether a list should be restricted to events that are scheduled to start within a particular month and year.

Method Summary

com.clra.util.ISerializableComparator getComparator()
          Returns the sort-order that an iterator will use.

java.lang.Integer getGroup()
          Returns the group of letters to which an iteration is restricted (if it is restricted).

java.util.Iterator getIterator()
          Returns an iterator over a collection of INamed beans.

java.lang.Boolean getRestricted()
          Returns a flag that indicates whether an iterator will be restricted to events that are scheduled to start within a particular month and year.

void setComparator(com.clra.util.ISerializableComparator comparator)
          Sets the sort-order that an iterator will use.

void setGroup(java.lang.Integer group)
          Sets the group to which an iteration is restricted (if it is restricted).

void setRestricted(java.lang.Boolean restricted)
          Sets whether an iterator will be restricted to events that start within a particular month and year.

Field Detail

AN_ISRESTRICTED

public static final java.lang.String AN_ISRESTRICTED

Names an attribute within the scope of an HTTP request or session whose Boolean value indicates whether a list should be restricted to events that are scheduled to start within a particular month and year. A blank, null or missing value should default to non-restricted.

See Also:: Constant Field Values

AN_GROUP

public static final java.lang.String AN_GROUP

Names an attribute within the scope of an HTTP request or session whose char[] value indicates the letters that with which a item name should begin within a restricted list.

See Also:: Constant Field Values

AN_COMPARATOR

public static final java.lang.String AN_COMPARATOR

Names an attribute within the scope of an HTTP request or session that holds a bean which implements java.util.Comparator. The comparator must be able to operate on instances of INamed. Current implementations ignore this attribute, but it is reserved for future enhancements.

See Also:: Constant Field Values

Method Detail

getIterator

public java.util.Iterator getIterator()
                               throws WebException

Returns an iterator over a collection of INamed beans. The behavior of the iterator is specified by setting restricted, month, year, and comparator properties before the iterator is requested.

getRestricted

public java.lang.Boolean getRestricted()

Returns a flag that indicates whether an iterator will be restricted to events that are scheduled to start within a particular month and year. A null value indicates behavior that is implementation-specific.

setRestricted

public void setRestricted(java.lang.Boolean restricted)

Sets whether an iterator will be restricted to events that start within a particular month and year. A null value specifies implementation-specific behavior.

getGroup

public java.lang.Integer getGroup()

Returns the group of letters to which an iteration is restricted (if it is restricted). If the return value is non-null, it must be in the range 1 - 8, inclusive.

setGroup

public void setGroup(java.lang.Integer group)

Sets the group to which an iteration is restricted (if it is restricted). If the input value is non-null, it must be in the range 1 - 8, inclusive.

getComparator

public com.clra.util.ISerializableComparator getComparator()

Returns the sort-order that an iterator will use. Valid comparators must be able to compare instances of INamed. A null comparator indicates the natural sort order of the events will be used.

setComparator

public void setComparator(com.clra.util.ISerializableComparator comparator)

Sets the sort-order that an iterator will use. Valid comparators must be able to compare instances of INamed. A null comparator indicates the natural sort order of the events will be used.