software.amazon.awscdk.services.stepfunctions

Class Map

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.services.stepfunctions.State

software.amazon.awscdk.services.stepfunctions.Map

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:42.399Z")
 @Stability(value=Stable)
public class Map
extends State
implements INextable

Define a Map state in the state machine.

A Map state can be used to run a set of steps for each element of an input array. A Map state will execute the same steps for multiple entries of an array in the state input.

While the Parallel state executes multiple branches of steps using the same input, a Map state will execute the same steps for multiple entries of an array in the state input.

Example:

 Map map = Map.Builder.create(this, "Map State")
         .maxConcurrency(1)
         .itemsPath(JsonPath.stringAt("$.inputForMap"))
         .build();
 map.iterator(new Pass(this, "Pass State"));
 

See Also:

https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-map-state.html

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Map.Builder A fluent builder for Map.

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.INextable

INextable.Jsii$Default, INextable.Jsii$Proxy

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

IChainable.Jsii$Default

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
Map	addCatch(IChainable handler) Add a recovery handler for this state.
Map	addCatch(IChainable handler, CatchProps props) Add a recovery handler for this state.
Map	addRetry() Add retry configuration for this state.
Map	addRetry(RetryProps props) Add retry configuration for this state.
List<INextable>	getEndStates() Continuable states of this Chainable.
Map	iterator(IChainable iterator) Define iterator state machine in Map.
Chain	next(IChainable next) Continue normal execution with the given state.
com.fasterxml.jackson.databind.node.ObjectNode	toStateJson() Return the Amazon States Language object for this state.
protected List<String>	validateState() Validate this state.

Methods inherited from class software.amazon.awscdk.services.stepfunctions.State

addBranch, addChoice, addIterator, addPrefix, bindToGraph, filterNextables, findReachableEndStates, findReachableEndStates, findReachableStates, findReachableStates, getBranches, getComment, getDefaultChoice, getId, getInputPath, getIteration, getOutputPath, getParameters, getResultPath, getResultSelector, getStartState, getStateId, makeDefault, makeNext, prefixStates, renderBranches, renderChoices, renderInputOutput, renderIterator, renderNextEnd, renderResultSelector, renderRetryCatch, setDefaultChoice, setIteration, whenBoundToGraph

Methods inherited from class software.constructs.Construct

getNode, isConstruct, 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

Map

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

Map

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

Map

@Stability(value=Stable)
public Map(@NotNull
                                    software.constructs.Construct scope,
                                    @NotNull
                                    String id,
                                    @Nullable
                                    MapProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

Map

@Stability(value=Stable)
public Map(@NotNull
                                    software.constructs.Construct scope,
                                    @NotNull
                                    String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

addCatch

@Stability(value=Stable)
 @NotNull
public Map addCatch(@NotNull
                                                       IChainable handler,
                                                       @Nullable
                                                       CatchProps props)

Add a recovery handler for this state.

When a particular error occurs, execution will continue at the error handler instead of failing the state machine execution.

Parameters:

handler - This parameter is required.

props -

addCatch

@Stability(value=Stable)
 @NotNull
public Map addCatch(@NotNull
                                                       IChainable handler)

Add a recovery handler for this state.

When a particular error occurs, execution will continue at the error handler instead of failing the state machine execution.

Parameters:

handler - This parameter is required.

addRetry

@Stability(value=Stable)
 @NotNull
public Map addRetry(@Nullable
                                                       RetryProps props)

Add retry configuration for this state.

This controls if and how the execution will be retried if a particular error occurs.

Parameters:

props -

addRetry

@Stability(value=Stable)
 @NotNull
public Map addRetry()

Add retry configuration for this state.

This controls if and how the execution will be retried if a particular error occurs.

iterator

@Stability(value=Stable)
 @NotNull
public Map iterator(@NotNull
                                                       IChainable iterator)

Define iterator state machine in Map.

Parameters:

iterator - This parameter is required.

next

@Stability(value=Stable)
 @NotNull
public Chain next(@NotNull
                                                     IChainable next)

Continue normal execution with the given state.

Specified by:

next in interface INextable

Parameters:

next - This parameter is required.

Returns:

The chain of states built up

toStateJson

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

Return the Amazon States Language object for this state.

Specified by:

toStateJson in class State

validateState

@Stability(value=Stable)
 @NotNull
protected List<String> validateState()

Validate this state.

Overrides:

validateState in class State

getEndStates

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

Continuable states of this Chainable.

Specified by:

getEndStates in interface IChainable

Specified by:

getEndStates in class State