software.amazon.awscdk.services.stepfunctions

Class State

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.services.stepfunctions.State

All Implemented Interfaces:

IDependable, IChainable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

Direct Known Subclasses:

Choice, CustomState, Fail, Map, Parallel, Pass, Succeed, Task, TaskStateBase, Wait

@Generated(value="jsii-pacmak/1.54.0 (build b1b977a)",
           date="2022-02-19T00:19:34.326Z")
 @Stability(value=Stable)
public abstract class State
extends Construct
implements IChainable

Base class for all other state classes.

Nested Class Summary

Nested classes/interfaces inherited from class software.constructs.Construct

software.constructs.Construct.Builder

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.stepfunctions.IChainable

IChainable.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct

IConstruct.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	State(software.constructs.Construct scope, String id, StateProps props)
protected	State(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	State(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
protected void	addBranch(StateGraph branch) Add a paralle branch to this state.
protected void	addChoice(Condition condition, State next) Add a choice branch to this state.
protected void	addIterator(StateGraph iteration) Add a map iterator to this state.
void	addPrefix(String x) Add a prefix to the stateId of this state.
void	bindToGraph(StateGraph graph) Register this state as part of the given graph.
static List<INextable>	filterNextables(List<? extends State> states) Return only the states that allow chaining from an array of states.
static List<State>	findReachableEndStates(State start) Find the set of end states states reachable through transitions from the given start state.
static List<State>	findReachableEndStates(State start, FindStateOptions options) Find the set of end states states reachable through transitions from the given start state.
static List<State>	findReachableStates(State start) Find the set of states reachable through transitions from the given start state.
static List<State>	findReachableStates(State start, FindStateOptions options) Find the set of states reachable through transitions from the given start state.
protected List<StateGraph>	getBranches()
protected String	getComment()
protected State	getDefaultChoice()
abstract List<INextable>	getEndStates() Continuable states of this Chainable.
String	getId() Descriptive identifier for this chainable.
protected String	getInputPath()
protected StateGraph	getIteration()
protected String	getOutputPath()
protected com.fasterxml.jackson.databind.node.ObjectNode	getParameters()
protected String	getResultPath()
protected com.fasterxml.jackson.databind.node.ObjectNode	getResultSelector()
State	getStartState() First state of this Chainable.
String	getStateId() Tokenized string that evaluates to the state's ID.
protected void	makeDefault(State def) Make the indicated state the default choice transition of this state.
protected void	makeNext(State next) Make the indicated state the default transition of this state.
static void	prefixStates(software.constructs.IConstruct root, String prefix) Add a prefix to the stateId of all States found in a construct tree.
protected Object	renderBranches() Render parallel branches in ASL JSON format.
protected Object	renderChoices() Render the choices in ASL JSON format.
protected Object	renderInputOutput() Render InputPath/Parameters/OutputPath in ASL JSON format.
protected Object	renderIterator() Render map iterator in ASL JSON format.
protected Object	renderNextEnd() Render the default next state in ASL JSON format.
protected Object	renderResultSelector() Render ResultSelector in ASL JSON format.
protected Object	renderRetryCatch() Render error recovery options in ASL JSON format.
protected void	setDefaultChoice(State value)
protected void	setIteration(StateGraph value)
abstract com.fasterxml.jackson.databind.node.ObjectNode	toStateJson() Render the state as JSON.
protected void	whenBoundToGraph(StateGraph graph) Called whenever this state is bound to a graph.

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

State

protected State(software.amazon.jsii.JsiiObjectRef objRef)

State

protected State(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

State

@Stability(value=Stable)
protected State(@NotNull
                                         software.constructs.Construct scope,
                                         @NotNull
                                         String id,
                                         @NotNull
                                         StateProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

filterNextables

@Stability(value=Stable)
 @NotNull
public static List<INextable> filterNextables(@NotNull
                                                                                 List<? extends State> states)

Return only the states that allow chaining from an array of states.

Parameters:

states - This parameter is required.

findReachableEndStates

@Stability(value=Stable)
 @NotNull
public static List<State> findReachableEndStates(@NotNull
                                                                                    State start,
                                                                                    @Nullable
                                                                                    FindStateOptions options)

Find the set of end states states reachable through transitions from the given start state.

Parameters:

start - This parameter is required.

options -

findReachableEndStates

@Stability(value=Stable)
 @NotNull
public static List<State> findReachableEndStates(@NotNull
                                                                                    State start)

Find the set of end states states reachable through transitions from the given start state.

Parameters:

start - This parameter is required.

findReachableStates

@Stability(value=Stable)
 @NotNull
public static List<State> findReachableStates(@NotNull
                                                                                 State start,
                                                                                 @Nullable
                                                                                 FindStateOptions options)

Find the set of states reachable through transitions from the given start state.

This does not retrieve states from within sub-graphs, such as states within a Parallel state's branch.

Parameters:

start - This parameter is required.

options -

findReachableStates

@Stability(value=Stable)
 @NotNull
public static List<State> findReachableStates(@NotNull
                                                                                 State start)

Find the set of states reachable through transitions from the given start state.

This does not retrieve states from within sub-graphs, such as states within a Parallel state's branch.

Parameters:

start - This parameter is required.

prefixStates

@Stability(value=Stable)
public static void prefixStates(@NotNull
                                                         software.constructs.IConstruct root,
                                                         @NotNull
                                                         String prefix)

Add a prefix to the stateId of all States found in a construct tree.

Parameters:

root - This parameter is required.

prefix - This parameter is required.

addBranch

@Stability(value=Stable)
protected void addBranch(@NotNull
                                                  StateGraph branch)

Add a paralle branch to this state.

Parameters:

branch - This parameter is required.

addChoice

@Stability(value=Stable)
protected void addChoice(@NotNull
                                                  Condition condition,
                                                  @NotNull
                                                  State next)

Add a choice branch to this state.

Parameters:

condition - This parameter is required.

next - This parameter is required.

addIterator

@Stability(value=Stable)
protected void addIterator(@NotNull
                                                    StateGraph iteration)

Add a map iterator to this state.

Parameters:

iteration - This parameter is required.

addPrefix

@Stability(value=Stable)
public void addPrefix(@NotNull
                                               String x)

Add a prefix to the stateId of this state.

Parameters:

x - This parameter is required.

bindToGraph

@Stability(value=Stable)
public void bindToGraph(@NotNull
                                                 StateGraph graph)

Register this state as part of the given graph.

Don't call this. It will be called automatically when you work with states normally.

Parameters:

graph - This parameter is required.

makeDefault

@Stability(value=Stable)
protected void makeDefault(@NotNull
                                                    State def)

Make the indicated state the default choice transition of this state.

Parameters:

def - This parameter is required.

makeNext

@Stability(value=Stable)
protected void makeNext(@NotNull
                                                 State next)

Make the indicated state the default transition of this state.

Parameters:

next - This parameter is required.

renderBranches

@Stability(value=Stable)
 @NotNull
protected Object renderBranches()

Render parallel branches in ASL JSON format.

renderChoices

@Stability(value=Stable)
 @NotNull
protected Object renderChoices()

Render the choices in ASL JSON format.

renderInputOutput

@Stability(value=Stable)
 @NotNull
protected Object renderInputOutput()

Render InputPath/Parameters/OutputPath in ASL JSON format.

renderIterator

@Stability(value=Stable)
 @NotNull
protected Object renderIterator()

Render map iterator in ASL JSON format.

renderNextEnd

@Stability(value=Stable)
 @NotNull
protected Object renderNextEnd()

Render the default next state in ASL JSON format.

renderResultSelector

@Stability(value=Stable)
 @NotNull
protected Object renderResultSelector()

Render ResultSelector in ASL JSON format.

renderRetryCatch

@Stability(value=Stable)
 @NotNull
protected Object renderRetryCatch()

Render error recovery options in ASL JSON format.

toStateJson

@Stability(value=Stable)
 @NotNull
public abstract com.fasterxml.jackson.databind.node.ObjectNode toStateJson()

Render the state as JSON.

whenBoundToGraph

@Stability(value=Stable)
protected void whenBoundToGraph(@NotNull
                                                         StateGraph graph)

Called whenever this state is bound to a graph.

Can be overridden by subclasses.

Parameters:

graph - This parameter is required.

getBranches

@Stability(value=Stable)
 @NotNull
protected List<StateGraph> getBranches()

getEndStates

@Stability(value=Stable)
 @NotNull
public abstract List<INextable> getEndStates()

Continuable states of this Chainable.

Specified by:

getEndStates in interface IChainable

getId

@Stability(value=Stable)
 @NotNull
public String getId()

Descriptive identifier for this chainable.

Specified by:

getId in interface IChainable

getStartState

@Stability(value=Stable)
 @NotNull
public State getStartState()

First state of this Chainable.

Specified by:

getStartState in interface IChainable

getStateId

@Stability(value=Stable)
 @NotNull
public String getStateId()

Tokenized string that evaluates to the state's ID.

getComment

@Stability(value=Stable)
 @Nullable
protected String getComment()

getInputPath

@Stability(value=Stable)
 @Nullable
protected String getInputPath()

getOutputPath

@Stability(value=Stable)
 @Nullable
protected String getOutputPath()

getParameters

@Stability(value=Stable)
 @Nullable
protected com.fasterxml.jackson.databind.node.ObjectNode getParameters()

getResultPath

@Stability(value=Stable)
 @Nullable
protected String getResultPath()

getResultSelector

@Stability(value=Stable)
 @Nullable
protected com.fasterxml.jackson.databind.node.ObjectNode getResultSelector()

getDefaultChoice

@Stability(value=Stable)
 @Nullable
protected State getDefaultChoice()

setDefaultChoice

@Stability(value=Stable)
protected void setDefaultChoice(@Nullable
                                                         State value)

getIteration

@Stability(value=Stable)
 @Nullable
protected StateGraph getIteration()

setIteration

@Stability(value=Stable)
protected void setIteration(@Nullable
                                                     StateGraph value)