IEventList

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 IEventList

All Known Implementing Classes:: ApplicationSet, EnrollmentSet, SessionSet

public interface IEventList

Declares JSP attributes and bean properties for sorted lists of scheduled events. Views that implement this interface may be controlled via components such as MonthViewSelector and YearViewSelector.

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

restricted: is the view restricted to a range of dates within a particular month and year? [true,false]
month: if the view is restricted, the month to which it is restricted. A number between 0 (January) and 11 (December).
year: if the view is restricted, the year to which it is restricted. A four-digit year; e.g. 2002.
comparator: specifies a bean that implements java.util.Comparator which can compare instances of IScheduled. The current implementation of MonthViewSelector does not use the value of this attribute.

For beans, this interface declares five properties:

restricted: read/write Boolean
month: read/write Integer, 0 - 11
year: read/write Integer, four digits
comparator: read/write java.util.Comparator, compares instances of IScheduled
iterator: read-only iterator of IScheduled 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_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.

static java.lang.String AN_MONTH
          Names an attribute within the scope of an HTTP request or session whose Integer value indicates the month to which a list should be restricted.

static java.lang.String AN_YEAR
          Names an attribute within the scope of an HTTP request or session whose Integer value indicates the year to which a list should be restricted.

Method Summary

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

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

java.lang.Integer getMonth()
          Returns the month to which an iteration is restricted (if it is restricted).

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.

java.lang.Integer getYear()
          Returns the year to which an iteration is restricted (if it is restricted).

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

void setMonth(java.lang.Integer month)
          Sets the month 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.

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

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.

See Also:: Constant Field Values

AN_MONTH

public static final java.lang.String AN_MONTH

Names an attribute within the scope of an HTTP request or session whose Integer value indicates the month to which a list should be restricted. Valid values are 0 (for January) through 11 (for December).

See Also:: Constant Field Values

AN_YEAR

public static final java.lang.String AN_YEAR

Names an attribute within the scope of an HTTP request or session whose Integer value indicates the year to which a list should be restricted. Values values must have four digits; e.g. "2002".

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 IScheduled. 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 IScheduled 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.

getMonth

public java.lang.Integer getMonth()

Returns the month to which an iteration is restricted (if it is restricted). Valid values are 0 (for January) through 11 (for December) plus null (for the current calendar month).

setMonth

public void setMonth(java.lang.Integer month)

Sets the month to which an iteration is restricted (if it is restricted). Valid values are 0 (for January) through 11 (for December) plus null (for the current calendar month).

getYear

public java.lang.Integer getYear()

Returns the year to which an iteration is restricted (if it is restricted). Valid values have four digits (e.g. "2002") or are null (for the current calendar year).

setYear

public void setYear(java.lang.Integer year)

Sets the year to which an iteration is restricted (if it is restricted). Valid values have four digits (e.g. "2002") or are null (for the current calendar year).

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 IScheduled. 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 IScheduled. A null comparator indicates the natural sort order of the events will be used.