配置解析器 (VTL)

登录到 Amazon Web Services Management Console，然后打开 AppSync 控制台。

1. 在 API 控制面板中，选择您的 GraphQL API。

2. 在侧边栏中，选择架构。

在页面右侧，具有一个名为解析器的窗口。该框包含页面左侧的架构窗口中定义的类型和字段列表。您可以将解析器附加到字段。例如，在 Query 类型下面，选择 getTodos 字段旁边的附加。

在创建解析器页面上，选择您在附加数据源指南中创建的数据源。在配置映射模板窗口中，您可以使用右侧的下拉列表选择通用请求和响应映射模板，也可以编写自己的映射模板。

对于常见使用案例，Amazon AppSync 控制台具有内置的模板，可用于从数据源获取项目（例如，所有项目查询、单独查找等）。例如，对于设计您的架构中的简单架构版本（getTodos 没有分页），用于列出项目的请求映射模板如下所示：

{
    "version" : "2017-02-28",
    "operation" : "Scan"
}

您始终需要为请求提供响应映射模板。控制台为列表提供的默认模板具有以下传递值：

$util.toJson($ctx.result.items)

此示例中，项目列表的 context 对象（别名为 $ctx）的格式为 $context.result.items。如果您的 GraphQL 操作返回单个项目，则它为 $context.result。AmazonAppSync 为常见操作提供帮助程序函数（例如前面列出的 $util.toJson），以正确设置响应格式。有关完整的函数列表，请参阅解析器映射模板实用程序参考。

选择保存解析器。

调用 CreateResolver API 以创建一个解析器对象。

您可以调用 UpdateResolver API 以修改解析器的字段。

运行 create-resolver 命令以创建解析器。

您需要为该特定命令键入 6 个参数：

示例命令可能如下所示：

aws appsync create-resolver --api-id abcdefghijklmnopqrstuvwxyz --type-name Query --field-name getTodos --data-source-name TodoTable --request-mapping-template "{ "version" : "2017-02-28", "operation" : "Scan", }" --response-mapping-template ""$"util.toJson("$"ctx.result.items)"

将在 CLI 中返回输出。示例如下：

{
    "resolver": {
        "kind": "UNIT",
        "dataSourceName": "TodoTable",
        "requestMappingTemplate": "{ version : 2017-02-28, operation : Scan, }",
        "resolverArn": "arn:aws:appsync:us-west-2:107289374856:apis/abcdefghijklmnopqrstuvwxyz/types/Query/resolvers/getTodos",
        "typeName": "Query",
        "fieldName": "getTodos",
        "responseMappingTemplate": "$util.toJson($ctx.result.items)"
    }
}

要修改解析器的字段和/或映射模板，请运行 update-resolver 命令。

除了 api-id 参数以外，create-resolver 命令中使用的参数将由 update-resolver 命令中的新值覆盖。

登录到 Amazon Web Services Management Console，然后打开 AppSync 控制台。

1. 在 API 控制面板中，选择您的 GraphQL API。

2. 在侧边栏中，选择架构。

在 Mutation 类型下面，选择 addTodo 字段旁边的附加。

在创建解析器页面上，选择您在附加数据源指南中创建的数据源。

在配置映射模板窗口中，您需要修改请求模板，因为这是一个变更，该操作将新项目添加 DynamoDB 中。使用以下请求映射模板：

{
    "version" : "2017-02-28",
    "operation" : "PutItem",
    "key" : {
        "id" : $util.dynamodb.toDynamoDBJson($ctx.args.id)
    },
    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args)
}

Amazon AppSync 自动将 addTodo 字段中定义的参数从 GraphQL 架构转换为 DynamoDB 操作。上一示例使用 id 键将记录存储在 DynamoDB 中，该键是从变更参数中作为 $ctx.args.id 传递的。您传递的所有其他字段使用 $util.dynamodb.toMapValuesJson($ctx.args) 自动映射到 DynamoDB 属性。

对于此解析器，使用以下响应映射模板：

$util.toJson($ctx.result)

Amazon AppSync 还支持用于编辑解析器的测试和调试工作流程。您可在调用之前使用模拟 context 对象查看模板经过转换的值。还可在运行查询时选择以交互方式查看对数据源的完整请求执行过程。有关更多信息，请参阅测试和调试解析器和监控和日志记录。

选择保存解析器。

登录到 Amazon Web Services Management Console，然后打开 AppSync 控制台。

1. 在 API 控制面板中，选择您的 GraphQL API。

2. 在侧边栏中，选择架构。

在 Todo 类型下面，选择 comments 字段旁边的附加。

在创建解析器页面上，选择您的 Comments 表数据源。快速入门指南中的 Comments 表的默认名称是 AppSyncCommentTable，但它可能会根据您指定的名称而有所不同。

将以下代码片段添加到您的请求映射模板中：

{
    "version": "2017-02-28",
    "operation": "Query",
    "index": "todoid-index",
    "query": {
        "expression": "todoid = :todoid",
        "expressionValues": {
            ":todoid": {
                "S": $util.toJson($context.source.id)
            }
        }
    }
}

context.source 会引用当前被解析的字段的父对象。在本示例中，source.id 指单个 Todo 对象，之后它会被用于查询表达式。

您可以如下所示使用传递响应映射模板：

$util.toJson($ctx.result.items)

选择保存解析器。

最后，返回到控制台中的架构页面，将一个解析器附加到 addComment 字段，并指定 Comments 表的数据源。在此例中请求映射模板只是简单的 PutItem，它具有作为参数注释的特定 todoid，但您可以使用 $utils.autoId() 实用程序来为如下所示注释创建唯一的排序键：

{
    "version": "2017-02-28",
    "operation": "PutItem",
    "key": {
        "todoid": { "S": $util.toJson($context.arguments.todoid) },
        "commentid": { "S": "$util.autoId()" }
    },
    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args)
}

如下所示使用传递响应模板：

$util.toJson($ctx.result)