jadex.bdi.runtime.interpreter

Class GoalLifecycleRules

java.lang.Object

jadex.bdi.runtime.interpreter.GoalLifecycleRules

public class GoalLifecycleRules
extends Object

Static helper class for goal lifecycle rules and actions. These rules are responsible for managing the lifecycle of goals. Concretely there are conditions that do the following: - Create a goal (user creation condition) - Suspend a goal (!context condition) - Optionize a goal (context condition) - Drop a goal (drop condition)

Constructor Summary

Constructors

Constructor and Description
GoalLifecycleRules()

Method Summary

Methods

Modifier and Type	Method and Description
static void	adoptGoal(jadex.rules.state.IOAVState state, Object rcapa, Object rgoal) Adopt a goal.
static Object	createGoal(jadex.rules.state.IOAVState state, Object rcapa, String type) Create a goal of a given type.
static Object[]	createGoalCreationUniqueUserRule(Object model, jadex.rules.state.IOAVState state) Create a goal, when the ADF creation condition triggers and no similar goal exists (according to unique flags)
static Object[]	createGoalCreationUserRule(Object model) Create a goal, when the ADF creation condition triggers.
static jadex.rules.rulesystem.rules.Rule	createGoalDroppingRule() Start dropping a goal that is succeeded or failed.
static Object[]	createGoalDroppingUserRule(Object model) Start dropping a goal, when the ADF context condition triggers.
static Object[]	createGoalOptionUserRule(Object model) Set a suspended goal to option state, when the ADF suspension condition triggers.
static Object[]	createGoalSuspendUserRule(Object model) Set a goal to suspended state, when the ADF context condition triggers.
static void	dropGoal(jadex.rules.state.IOAVState state, Object rgoal) Drop a goal.
static Object	instantiateGoal(jadex.rules.state.IOAVState state, Object rcapa, Object mgoal, Object cgoal, Map bindings, OAVBDIFetcher fetcher, OAVBDIFetcher configfetcher) Instantiate a goal but does not add it to the state.

Methods inherited from class java.lang.Object

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

Constructor Detail

GoalLifecycleRules

public GoalLifecycleRules()

Method Detail

createGoal

public static Object createGoal(jadex.rules.state.IOAVState state,
                Object rcapa,
                String type)

Create a goal of a given type. Uses method instantiateGoal().

instantiateGoal

public static Object instantiateGoal(jadex.rules.state.IOAVState state,
                     Object rcapa,
                     Object mgoal,
                     Object cgoal,
                     Map bindings,
                     OAVBDIFetcher fetcher,
                     OAVBDIFetcher configfetcher)

Instantiate a goal but does not add it to the state. Creates also the goals parameters.

Parameters:

state - The state

rcapa - The capability.

mgoal - The goal model.

cgoal - The goal configuration (if any).

Returns:

The goal instance.

adoptGoal

public static void adoptGoal(jadex.rules.state.IOAVState state,
             Object rcapa,
             Object rgoal)

Adopt a goal. Adds the goal to the state (goalbase).

Parameters:

state - The state

rcapa - The capability.

rgoal - The goal.

dropGoal

public static void dropGoal(jadex.rules.state.IOAVState state,
            Object rgoal)

Drop a goal.

Parameters:

state - The state.

rgoal - The goal.

createGoalCreationUserRule

public static Object[] createGoalCreationUserRule(Object model)

Create a goal, when the ADF creation condition triggers.

Parameters:

model - The goal model element.

createGoalCreationUniqueUserRule

public static Object[] createGoalCreationUniqueUserRule(Object model,
                                        jadex.rules.state.IOAVState state)

Create a goal, when the ADF creation condition triggers and no similar goal exists (according to unique flags)

Parameters:

model - The goal model element.

createGoalOptionUserRule

public static Object[] createGoalOptionUserRule(Object model)

Set a suspended goal to option state, when the ADF suspension condition triggers.

Parameters:

usercond - The ADF condition part.

model - The goal model element.

createGoalSuspendUserRule

public static Object[] createGoalSuspendUserRule(Object model)

Set a goal to suspended state, when the ADF context condition triggers.

Parameters:

usercond - The ADF part of the context condition (will be negated automatically).

model - The goal model element.

createGoalDroppingRule

public static jadex.rules.rulesystem.rules.Rule createGoalDroppingRule()

Start dropping a goal that is succeeded or failed.

createGoalDroppingUserRule

public static Object[] createGoalDroppingUserRule(Object model)

Start dropping a goal, when the ADF context condition triggers.

Parameters:

usercond - The ADF part of the context condition.

model - The goal model element.