io.engineblock.activityapi

Interface ActivityType

public interface ActivityType

An ActivityType is the central extension point in EngineBlock for new activity types drivers. It is responsible for naming the activity type, as well as providing the input, activity, and motor instances that will be assembled into an activity.

At the very minimum, a useful implementation of an activity type should provide an action dispenser. Default implementations of input and motor dispensers are provided, and by extension, default inputs and motors.

Method Summary

Modifier and Type	Method and Description
default ActionDispenser	getActionDispenser(Activity activity) This method will be called once per action instance.
default Activity	getActivity(ActivityDef activityDef) Create an instance of an activity from the activity type.
default Activity	getAssembledActivity(ActivityDef activityDef, Map<String,Activity> activities) Create an instance of an activity that ties together all the components into a usable activity instance.
default InputDispenser	getInputDispenser(Activity activity) Return the InputDispenser instance that will be used by the associated activity to create Input factories for each thread slot.
default MotorDispenser	getMotorDispenser(Activity activity, InputDispenser inputDispenser, ActionDispenser actionDispenser)
String	getName() Return the short name of this activity type.

Method Detail

getName

String getName()

Return the short name of this activity type. The fully qualified name of an activity type is this value, prefixed by the package of the implementing class.

Returns:

An activity type name, like "diag"

getActivity

default Activity getActivity(ActivityDef activityDef)

Create an instance of an activity from the activity type.

Parameters:

activityDef - the definition that initializes and controls the activity.

Returns:

a distinct Activity instance for each call

getAssembledActivity

default Activity getAssembledActivity(ActivityDef activityDef,
                                      Map<String,Activity> activities)

Create an instance of an activity that ties together all the components into a usable activity instance. This is the method that should be called by executor classes.

Parameters:

activityDef - the definition that initializez and controlls the activity.

activities - a map of existing activities

Returns:

a distinct activity instance for each call

getActionDispenser

default ActionDispenser getActionDispenser(Activity activity)

This method will be called once per action instance.

Parameters:

activity - The activity instance that will parameterize the returned ActionDispenser instance.

Returns:

an instance of ActionDispenser

getInputDispenser

default InputDispenser getInputDispenser(Activity activity)

Return the InputDispenser instance that will be used by the associated activity to create Input factories for each thread slot.

Parameters:

activity - the Activity instance which will parameterize this InputDispenser

Returns:

the InputDispenser for the associated activity

getMotorDispenser

default MotorDispenser getMotorDispenser(Activity activity,
                                         InputDispenser inputDispenser,
                                         ActionDispenser actionDispenser)