ItemsPath （地图）

使用该ItemsPath字段在提供给某一Map州的JSON输入中选择一个数组。Map 状态为数组中的每个项目重复一组步骤。默认情况下，Map 状态将 ItemsPath 设置为 $，这将选择整个输入。如果Map状态的输入是JSON数组，则它会对数组中的每个项目进行迭代，将该项目作为输入传递给迭代。

您可以使用该ItemsPath字段在输入中指定指向用于迭代的JSON数组的位置。的值ItemsPath必须是引用路径，并且该路径必须指向JSON数组。例如，考虑 Map 状态的输入，其中包含两个数组，如以下示例所示。

{
  "ThingsPiratesSay": [
    {
      "say": "Avast!"
    },
    {
      "say": "Yar!"
    },
    {
      "say": "Walk the Plank!"
    }
  ],
  "ThingsGiantsSay": [
    {
      "say": "Fee!"
    },
    {
      "say": "Fi!"
    },
    {
      "say": "Fo!"
    },
    {
      "say": "Fum!"
    }
  ]
}

在这种情况下，您可以通过 ItemsPath 选择一个数组来指定用于 Map 状态迭代的数组。以下状态机定义使用 ItemsPath 来指定输入中的 ThingsPiratesSay 数组，然后对 ThingsPiratesSay 数组中的每个项目运行 SayWord 传递状态的迭代。

{
  "StartAt": "PiratesSay",
  "States": {
    "PiratesSay": {
      "Type": "Map",
      "ItemsPath": "$.ThingsPiratesSay",
      "ItemProcessor": {
         "StartAt": "SayWord",
         "States": {
           "SayWord": {
             "Type": "Pass",
             "End": true
           }
         }
      },
      "End": true
    }
  }
} 

处理输入时，Map 状态在 InputPath 之后应用 ItemsPath。InputPath 筛选输出后，它将对状态的有效输入进行操作。

有关 Map 状态的更多信息，请参阅以下内容：