Package cz.cuni.amis.pogamut.sposh.executor

Classes for creation and execution of primitives.

See: Description

Interface Summary

Interface	Description
IAction	Primitive representation used in StateWorkExecutor.
ILogicWorkExecutor	Deprecated This is a wrong place for these methods, SposhLogicController has templated IWorkExecutor and methods logicBeforePlan and logicBeforePlan.
ISense<RETURN>	Interface for sense in state paradigma.
IWorkExecutor	Interface that is used by posh engine to execute primitives.

Class Summary

Class	Description
BehaviorWorkExecutor	Executor for posh plans that will execute annotated methods on the object.
DoNothing	Primitive action that doesn't do anything.
Fail	Primitive sense that always fails (returns false) and does nothing else.
ParamInfo	Object for storing information about one parameter of a parametrized primitive.
ParamsAction<CONTEXT extends Context>	Base class for actions that have parameters passed to them using the reflection API.
ParamsSense<CONTEXT extends Context,RETURN>	Create new parametrized sense using reflection.
PrimitiveData	Exchange container used for passing info between crawler and explorer.
PrintWorkExecutor	Very simple executor for plans that will print name of primitive, that is supposed to execute, to specified stream.
StateAction<CONTEXT extends Context>	Basic state action primitive.
StateSense<CONTEXT extends Context,RETURN>	Basic state sense primitive.
StateWorkExecutor	This class is an IWorkExecutor, that considers actions to be have state, in this executor, primitive is working in phases INIT, RUN*, DONE.
Succeed	Primitive sense, always succeed (return true) and do nothing else.

Enum Summary

Enum	Description
ActionResult	The value returned by the primitive via IWorkExecutor that can modify the behavior of posh stack evaluation.
ParamInfo.Type	Enum of all possible types allowed as the parameters of methods in a parametrized primitive.

Annotation Types Summary

Annotation Type	Description
Param	Specified the name of a variable from the VariableContext that will be mapped the parameter with the annotation.
PrimitiveInfo	Optional, use this annotation for the some implementation of ISense and IAction, this annotation specifies the name and description of primitive.

Package cz.cuni.amis.pogamut.sposh.executor Description

Classes for creation and execution of primitives. When engine want to actully perform some action or get value of the sense, it askes some IWorkExecutor to do it.

StateWorkExecutor (used by Yaposh) takes instances of IAction and ISense and executes them. It is not very comfortable to always implement interface, so user should use one of abstract classes provided by this package:

• ParamsAction - for parametrized actions, easy to use parameters, but user has to carefuly write methods of action (reflection API is used to find methods for phases).
• StateAction - very basic abstract class implementing IAction with access to context.
• ParamsSense - for parametrized sense, easy to use parameters, but user has to carefuly write query method, the sense is using reflection API to find the method.
• StateSense - very basic abstract class implementing ISense with access to context.

Yaposh is using automatic instantiation of primitives from fully qualified names found in the plan. Automatic instantiation requires standard constructor, thus all primitives must have public constructor with one parameter - subclass of type Context (same one as in generic parameter of IAction/ISense).

All classes of primitives (the ones overriding IAction / ISense) should be annotated with PrimitiveInfo. The annotation provides useful information to the editor.