io.nflow.engine.workflow.curated

Class BulkWorkflow

java.lang.Object

io.nflow.engine.model.ModelObject

io.nflow.engine.workflow.definition.AbstractWorkflowDefinition<S>

io.nflow.engine.workflow.definition.WorkflowDefinition<BulkWorkflow.State>

io.nflow.engine.workflow.curated.BulkWorkflow

@Component
public class BulkWorkflow
extends WorkflowDefinition<BulkWorkflow.State>

Bulk child workflow executor that does not overflow the system.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BulkWorkflow.State Bulk workflow states.

Field Summary

Fields

Modifier and Type	Field and Description
static String	BULK_WORKFLOW_TYPE The type of default bulk workflow.
static String	VAR_CHILD_DATA State variable name for child data.
static String	VAR_CONCURRENCY State variable to define the maximum concurrency for executing child workflows.

Fields inherited from class io.nflow.engine.workflow.definition.AbstractWorkflowDefinition

allowedTransitions, failureTransitions

Constructor Summary

Constructors

Modifier	Constructor and Description
	BulkWorkflow() Create bulk workflow definition.
protected	BulkWorkflow(String type) Extend bulk workflow definition.

Method Summary

Modifier and Type	Method and Description
protected boolean	isRunning(WorkflowInstance instance) Override this to determine if the child workflow is running or not.
NextAction	splitWork(StateExecution execution, com.fasterxml.jackson.databind.JsonNode data) Call splitWorkImpl to create new child workflows.
protected boolean	splitWorkImpl(StateExecution execution, com.fasterxml.jackson.databind.JsonNode data) Override this to create child workflows or add the children before starting the parent.
protected org.joda.time.DateTime	waitForChildrenToCompleteUntil() Override this to customize the time to wait for children to finish.
NextAction	waitForChildrenToFinish(StateExecution execution, int concurrency) Check if all child workflows have finished.
protected org.joda.time.DateTime	waitForChildrenUntil() Override this to customize the time to wait for new children before waking up.

Methods inherited from class io.nflow.engine.workflow.definition.WorkflowDefinition

getStates

Methods inherited from class io.nflow.engine.workflow.definition.AbstractWorkflowDefinition

getAllowedTransitions, getDescription, getErrorState, getFailureTransitions, getInitialState, getMethod, getName, getSettings, getState, getSupportedSignals, getType, isAllowedNextAction, isStartState, permit, permit, setDescription, setName

Methods inherited from class io.nflow.engine.model.ModelObject

equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

BULK_WORKFLOW_TYPE

public static final String BULK_WORKFLOW_TYPE

The type of default bulk workflow.

See Also:

Constant Field Values

VAR_CHILD_DATA

public static final String VAR_CHILD_DATA

State variable name for child data.

See Also:

Constant Field Values

VAR_CONCURRENCY

public static final String VAR_CONCURRENCY

State variable to define the maximum concurrency for executing child workflows.

See Also:

Constant Field Values

Constructor Detail

BulkWorkflow

protected BulkWorkflow(String type)

Extend bulk workflow definition.

Parameters:

type - The type of the workflow.

BulkWorkflow

public BulkWorkflow()

Create bulk workflow definition.

Method Detail

splitWork

public NextAction splitWork(StateExecution execution,
                            com.fasterxml.jackson.databind.JsonNode data)

Call splitWorkImpl to create new child workflows.

Parameters:

execution - State execution context.

data - Child data.

Returns:

Action to start waiting for children to finish or action to wait for children to be created.

splitWorkImpl

protected boolean splitWorkImpl(StateExecution execution,
                                com.fasterxml.jackson.databind.JsonNode data)

Override this to create child workflows or add the children before starting the parent.

Parameters:

execution - State execution context.

data - Child data.

Returns:

True to start processing the children, false to wait for children to be created.

Throws:

RuntimeException - Thrown by default implementation if children are not created before the parent is started.

waitForChildrenUntil

protected org.joda.time.DateTime waitForChildrenUntil()

Override this to customize the time to wait for new children before waking up. Default is one hour.

Returns:

Time when parent should wake up to check if new children have been added.

waitForChildrenToFinish

public NextAction waitForChildrenToFinish(StateExecution execution,
                                          int concurrency)

Check if all child workflows have finished. Start new children if needed and allowed by concurrency limit.

Parameters:

execution - State execution context.

concurrency - The maximum number of child workflows to start.

Returns:

Action to retry this state at the time returned by waitForChildrenToCompleteUntil.

isRunning

protected boolean isRunning(WorkflowInstance instance)

Override this to determine if the child workflow is running or not. The default implementation returns true if the instance state is finished or created.

Parameters:

instance - The child workflow instance to check.

Returns:

True if the child is running, false otherwise.

waitForChildrenToCompleteUntil

protected org.joda.time.DateTime waitForChildrenToCompleteUntil()

Override this to customize the time to wait for children to finish. Default is 15 minutes. This is a safety mechanism only, as when the children normally go to finished state, they will automatically wake up the parent workflow.

Returns:

The time when parent should wake up to check if the children are finished.