|
ContactCenters V. 0.9.9. |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DialerList
Represents a list that contains and manages contacts to be made later
by a dialer.
This interface specifies methods to clear the current
list, to remove the first contact of the list, and
to compute the current size of the list.
The contents of the dialer list depends on the implementation.
For example, InfiniteDialerList
always has an
infinite size, and uses a user-supplied contact
factory to obtain contacts.
The ContactListenerDialerList
, on the other hand,
is backed by a fixed list which is populated by a contact
listener.
The contents of the dialer list could also change with time.
For example, during some time intervals of the day,
a limit on the maximal number of dialed contacts
might be imposed by restricting the size of the
dialer list.
Some dialer lists might also allow one to restrict the types of contacts that can be extracted from the list. This can be useful for some dialing policies managing contacts of several types, and composing specific numbers of contacts of each type.
A dialer list also implements
the ContactFactory
interface;
the implementation of the ContactFactory.newInstance()
method usually forwards the call to
removeFirst(int[])
.
However,
while the contact factory always creates new objects,
a dialer list may extract them from a list with
possibly finite size.
Method Summary | |
---|---|
void |
clear()
Clears the contents of this dialer list. |
Contact |
removeFirst(int[] contactTypes)
Removes and returns the first contact with one of the desired types from the dialer list. |
int |
size(int[] contactTypes)
Returns the number of contacts of desired types stored into this dialer list. |
Methods inherited from interface umontreal.iro.lecuyer.contactcenters.contact.ContactFactory |
---|
newInstance |
Method Detail |
---|
int size(int[] contactTypes)
Integer.MAX_VALUE
.
If the dialer list does not allow restriction to
specific contact types, this method throws
an UnsupportedOperationException
.
contactTypes
- the array of desired contact types.
UnsupportedOperationException
- if contactTypes
is non-null while the dialer list does not support
restrictions to specific contact types.void clear()
Contact removeFirst(int[] contactTypes)
NoSuchElementException
.
If contactTypes is null,
any contact type is allowed.
If contactTypes is non-null while
the dialer list does not support restrictions to
specific contact types, this throws an
UnsupportedOperationException
.
contactTypes
- the array of desired contact types.
NoSuchElementException
- if the dialer list is empty.
UnsupportedOperationException
- if contactTypes
is non-null while the dialer list does not support
restrictions to specific contact types.
|
ContactCenters V. 0.9.9. |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |