bdi4jade.core

Class Intention

java.lang.Object

bdi4jade.core.Intention

public class Intention
extends java.lang.Object

This class represents the intention abstraction from the BDI model. It represents a goal that the agent is committed to achieve. It has the associated goal and tries to execute plans to achieve it. It keeps a list of the executed plans, and after using all plans unsuccessfully, the goal is considered unachievable. When a plan fails, the BDI-interpreter cycle may invoke the tryToAchive() method again, so the intention tries another plan. During its execution, the intention can be set to no longer desired.

Author:

ingrid

Constructor Summary

Constructors

Constructor and Description
Intention(Goal goal, BDIAgent bdiAgent) Creates a new intention.
Intention(Goal goal, BDIAgent bdiAgent, Capability owner) Creates a new intention.

Method Summary

Methods

Modifier and Type	Method and Description
void	addGoalListener(GoalListener goalListener) Adds a listener to be notified when the given has achieve its end state.
void	doWait() Sets this intention to the GoalStatus.WAITING status.
void	fireGoalFinishedEvent() Fires a goal event when a goal has achieved its end state.
Goal	getGoal()
java.util.List<GoalListener>	getGoalListeners()
BDIAgent	getMyAgent()
Capability	getOwner()
GoalStatus	getStatus() Returns the current goal status that this capability is committed to achieve.
void	noLongerDesire() Sets this intention as no longer desired.
void	removeGoalListener(GoalListener goalListener) Removes a goal listener to not be notified about the goal achievement anymore.
void	tryToAchive() Makes this intention starts to try to achieve the goal.

Methods inherited from class java.lang.Object

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

Constructor Detail

Intention

public Intention(Goal goal,
         BDIAgent bdiAgent)

Creates a new intention. It is associated with an agent and the goal that it is committed to achieve.

Parameters:

goal - the goal to be achieved.

bdiAgent - the bdiAgent associated with this intention.

Intention

public Intention(Goal goal,
         BDIAgent bdiAgent,
         Capability owner)

Creates a new intention. It is associated with an agent and the goal that it is committed to achieve. It also receives a Capability as parameter indicating the owner of the goal (dispatched the goal).

Parameters:

goal - the goal to be achieved.

bdiAgent - the bdiAgent associated with this intention.

owner - the Capability that is owner of the goal.

Method Detail

addGoalListener

public void addGoalListener(GoalListener goalListener)

Adds a listener to be notified when the given has achieve its end state.

Parameters:

goalListener - the listener to be notified.

doWait

public void doWait()

Sets this intention to the GoalStatus.WAITING status. It may come from the GoalStatus.PLAN_FAILED or GoalStatus.TRYING_TO_ACHIEVE states.

fireGoalFinishedEvent

public void fireGoalFinishedEvent()

Fires a goal event when a goal has achieved its end state.

See Also:

GoalStatus

getGoal

public Goal getGoal()

Returns:

the goal

getGoalListeners

public java.util.List<GoalListener> getGoalListeners()

Returns:

the goalListeners

getMyAgent

public BDIAgent getMyAgent()

Returns:

the myAgent

getOwner

public Capability getOwner()

Returns:

the owner

getStatus

public GoalStatus getStatus()

Returns the current goal status that this capability is committed to achieve.

Returns:

the current goal status.

See Also:

GoalStatus

noLongerDesire

public void noLongerDesire()

Sets this intention as no longer desired. It stops the current plan execution. It changes the goal status from GoalStatus.WAITING, GoalStatus.PLAN_FAILED or GoalStatus.TRYING_TO_ACHIEVE to GoalStatus.NO_LONGER_DESIRED.

removeGoalListener

public void removeGoalListener(GoalListener goalListener)

Removes a goal listener to not be notified about the goal achievement anymore.

Parameters:

goalListener - the goal listener to be removed.

tryToAchive

public void tryToAchive()

Makes this intention starts to try to achieve the goal. It changes the goal status from GoalStatus.WAITING or GoalStatus.PLAN_FAILED to GoalStatus.TRYING_TO_ACHIEVE.