ifs.fnd.ap

Class ManualDecisionCollection

java.lang.Object

ifs.fnd.ap.ManualDecisionCollection

public final class ManualDecisionCollection
extends java.lang.Object

A collection class holding ManualDecision objects. To handle requests for user feedback, do as follows:

1. Catch ManualDecisionExcpetion's when doing Server.invoke(). Since that is a sub-class to APException, it must be come first in the list of catch statements.
2. Obtain the ManualDecisionCollection to work with by doing ex.getDecisions().
3. Go through the collection with the iterator, the objects held are ManualDecision objects.
4. If the decision is unanswered (!decision.isAnswered()), ask the user the given question (decision.getMessage()) and get some input. Information on the type of question to ask as well which options the user has is available in each ManualDecision object.
5. If the user's answer equals to the decision's cancel answer ( decision.getAnswer().equals(decision.getCancelAnswer)), the process is to stop immediately. Otherwise, go on.
6. If the user have answered YES_TO_ALL or NO_TO_ALL, then the decision's decision key must be set to "*" and all subsequent decision with the same decision id must be removed (with the Iterator's remove() method) from the collection.
7. When all the decisions have been answered, set the ManualDecisionCollection on the Server object and invoke the operation again.

Note! server only asks for manual decisions if the access provider is set to run in interactive mode.

Note! Many times it's much easier to use add a ManualDecisionListener to the server object instead of doing all the steps descibed above. But that does not however work in a server environment (which probably runs in a non-interactive mode).

See Also:

ManualDecisionListener, ManualDecision, Server.setInteractiveMode(boolean), Server.setDecisions(ifs.fnd.ap.ManualDecisionCollection)

Method Summary

Modifier and Type	Method and Description
boolean	allAnswered() Returns true if all decisions in this collection have been answered.
java.util.Iterator<ManualDecision>	iterator() Returns an iterator to all decisions to make.
java.lang.String	toString() Returns a String representation of this object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

allAnswered

public boolean allAnswered()

Returns true if all decisions in this collection have been answered.

iterator

public java.util.Iterator<ManualDecision> iterator()

Returns an iterator to all decisions to make. The objects in the collection iterated over is of class ManualDecision.

toString

public java.lang.String toString()

Returns a String representation of this object.

Overrides:

toString in class java.lang.Object