|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--jade.core.behaviours.Behaviour | +--jade.core.behaviours.CompositeBehaviour
An abstract superclass for behaviours composed by many parts. This
class holds inside a number of children behaviours.
When a CompositeBehaviour
receives it execution quantum
from the agent scheduler, it executes one of its children according
to some policy. This class must be extended to provide the actual
scheduling policy to apply when running children behaviours.
SequentialBehaviour
,
ParallelBehaviour
,
FSMBehaviour
,
Serialized FormField Summary |
Fields inherited from class jade.core.behaviours.Behaviour |
myAgent |
Constructor Summary | |
protected |
CompositeBehaviour()
Default constructor, does not set the owner agent. |
protected |
CompositeBehaviour(Agent a)
This constructor sets the owner agent. |
Method Summary | |
void |
action()
Executes this CompositeBehaviour . |
void |
block()
Blocks this behaviour. |
protected abstract boolean |
checkTermination(boolean currentDone,
int currentResult)
This methods is called after the execution of each child in order to check whether the CompositeBehaviour
should terminate. |
boolean |
done()
Checks whether this behaviour has terminated. |
abstract Collection |
getChildren()
This method returns a Collection view of the children of this CompositeBehaviour |
protected abstract Behaviour |
getCurrent()
This method returns the child behaviour currently scheduled for execution |
void |
reset()
Puts a CompositeBehaviour back in initial state. |
protected void |
resetChildren()
|
void |
restart()
Restarts this behaviour. |
protected abstract void |
scheduleFirst()
This method schedules the first child to be executed |
protected abstract void |
scheduleNext(boolean currentDone,
int currentResult)
This method schedules the next child to be executed |
void |
setAgent(Agent a)
Associates this behaviour with the agent it belongs to. |
Methods inherited from class jade.core.behaviours.Behaviour |
block, getBehaviourName, getDataStore, getParent, isRunnable, onEnd, onStart, root, setBehaviourName, setDataStore |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected CompositeBehaviour()
protected CompositeBehaviour(Agent a)
a
- The agent this behaviour belongs to.Method Detail |
public final void action()
CompositeBehaviour
. This method
executes children according to the scheduling policy
defined by concrete subclasses that implements
the scheduleFirst()
and scheduleNext()
methods.
action
in class Behaviour
CompositeBehaviour
public final boolean done()
done
in class Behaviour
true
if this CompositeBehaviour
has finished executing, false
otherwise.protected abstract void scheduleFirst()
protected abstract void scheduleNext(boolean currentDone, int currentResult)
currentDone
- a flag indicating whether the just executed
child has completed or not.currentResult
- the termination value (as returned by
onEnd()
) of the just executed child in the case this
child has completed (otherwise this parameter is meaningless)protected abstract boolean checkTermination(boolean currentDone, int currentResult)
CompositeBehaviour
should terminate.
currentDone
- a flag indicating whether the just executed
child has completed or not.currentResult
- the termination value (as returned by
onEnd()
) of the just executed child in the case this
child has completed (otherwise this parameter is meaningless)
CompositeBehaviour
should terminate. false otherwise.protected abstract Behaviour getCurrent()
public abstract Collection getChildren()
CompositeBehaviour
public void block()
block()
is called
all its children are notified too.
block
in class Behaviour
Behaviour.restart()
public void restart()
restart()
is called
all its children are notified too.
restart
in class Behaviour
Behaviour.block()
public void reset()
CompositeBehaviour
back in initial state. The
internal state is cleaned up and reset()
is
recursively called for each child behaviour.
reset
in class Behaviour
protected void resetChildren()
public void setAgent(Agent a)
setAgent
in class Behaviour
a
- The agent this behaviour belongs to.Behaviour.setAgent(Agent a)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |